Primeiros passos

O que é o Jarvis Code CLI

O Jarvis Code CLI é um agente de IA que roda no terminal e ajuda você a executar tarefas de desenvolvimento de software e operações do dia a dia no terminal — ler e modificar código, executar comandos de shell, buscar arquivos, acessar páginas web e planejar e ajustar os próprios passos de forma autônoma conforme recebe feedback durante o trabalho.

Ele se encaixa em cenários como:

• Escrever e modificar código: implementar novas funcionalidades, corrigir bugs, concluir refatorações
• Entender um projeto: explorar uma base de código desconhecida e responder perguntas sobre arquitetura e implementação
• Automatizar tarefas: processar arquivos em lote, executar builds e testes, encadear vários scripts

O CLI é distribuído como um ZIP de release nativo para Linux x64 (glibc) e Windows x64. macOS, Linux ARM e distribuições Linux baseadas em musl não são suportados pelos instaladores de release.

Instalação

Instale com o instalador de release; não é necessário ter Node.js instalado. Os releases são publicados em releases-jarviscode.rollin-apps.store.

Antes de instalar

O Jarvis Code CLI é uma aplicação TUI totalmente interativa. Para a melhor experiência visual, execute-o em um terminal com suporte a true color e ligaduras, como Kitty ou Ghostty.

Script de instalação (recomendado)

Linux x64

curl -fsSL https://releases-jarviscode.rollin-apps.store/install.sh | bash

Windows x64 (PowerShell)

irm https://releases-jarviscode.rollin-apps.store/install.ps1 | iex

O instalador baixa o arquivo versionado jarvis-code-<version>-linux-x64.zip ou jarvis-code-<version>-win32-x64.zip, verifica-o contra o arquivo .sha256 correspondente e coloca jarvis no seu PATH. Para instalar um release específico, defina JARVIS_VERSION com uma tag de produção no formato jarvis-v<semver>, por exemplo jarvis-v0.38.1.

Os builds para Windows não são assinados. O Microsoft Defender SmartScreen pode exibir um aviso; confirme que o download veio do GitHub Release deste repositório e que o checksum .sha256 confere antes de usar a opção Mais informações → Executar assim mesmo do Windows.

Primeira execução

Entre no diretório do seu projeto e execute jarvis para abrir a interface interativa:

cd seu-projeto
jarvis

Para executar uma única instrução sem entrar na interface interativa, use -p:

jarvis -p "Dê uma olhada na estrutura de diretórios deste projeto"

Para retomar a sessão anterior, adicione -c:

jarvis -c

Na primeira execução você precisa configurar uma fonte de API. Na interface interativa, digite /login para iniciar o fluxo de autenticação:

/login

O /login abre um seletor de plataforma:

• Jarvis Code (OAuth) — escolha kimi.com/code ou kimi.ai/code e conclua o fluxo de device code no navegador.
• Kimi Open Platform (chave de API) — informe uma chave de API emitida em platform.kimi.com ou platform.kimi.ai; essa é uma plataforma separada, cobrada por token, e não um login do Jarvis Code.

Para sair da conta, digite /logout e as credenciais atuais são apagadas.

Usando outros provedores de IA

Se quiser conectar Anthropic, OpenAI, Google ou outros provedores, edite ~/.jarvis-code/config.toml diretamente para configurar a chave de API. Veja Provedores e modelos para os detalhes. Para a referência completa de todas as opções de configuração, veja Arquivos de configuração, Variáveis de ambiente e Sobrescritas de configuração.

Sua primeira conversa

Depois de autenticado, descreva uma tarefa em linguagem natural. Um bom ponto de partida é deixar o Jarvis Code CLI se familiarizar com o projeto:

Dê uma olhada na estrutura de diretórios deste projeto e descreva brevemente para que serve cada diretório.

O Jarvis Code CLI chama automaticamente ferramentas de leitura de arquivos, busca e outras para percorrer o conteúdo relevante antes de responder. Operações somente de leitura são executadas automaticamente por padrão, sem pedir confirmação. Para operações que modificam arquivos ou executam comandos de shell, ele pede sua confirmação antes de prosseguir.

Você também pode descrever uma tarefa mais concreta diretamente:

Adicione em src/utils uma função que converte qualquer string para kebab-case e crie um teste unitário para ela.

O Jarvis Code CLI planeja os passos, modifica o código, executa os testes e conta o que fez em cada etapa.

Não sabe o que fazer? Digite /help

Digite /help a qualquer momento para abrir o painel embutido de comandos e atalhos de teclado. Use ↑/↓ para navegar e Esc para fechar. Para sair, digite /exit, pressione Ctrl-C duas vezes ou pressione Ctrl-D com a caixa de entrada vazia.

Comandos e atalhos mais comuns

Para quem está começando, o que está abaixo já é suficiente:

Comandos de sessão

Comando	Descrição
/new	Inicia uma nova sessão, limpando o contexto atual
/sessions	Percorre o histórico de sessões e escolhe uma para retomar
/model	Troca o modelo atual
/compact	Compacta manualmente o contexto para liberar tokens
/fork	Bifurca a sessão atual em uma cópia independente com todo o histórico (você permanece na sessão atual)
/logout	Sai de um provedor configurado (alias: /disconnect)

Atalhos de teclado mais usados

Atalho	Descrição
Esc	Interrompe a saída em streaming / fecha um popup
Ctrl-C	Interrompe a saída; pressione duas vezes em repouso para sair
Shift-Tab	Alterna o Plan mode (modo de planejamento)
Ctrl-S	Injeta uma mensagem no meio do streaming sem esperar a resposta atual terminar
Ctrl-O	Recolhe / expande a saída de ferramentas e os resumos de compactação

Para a lista completa, digite /help ou consulte Comandos de barra e Atalhos de teclado.

Onde os dados ficam guardados

Por padrão, o Jarvis Code CLI guarda seus dados locais em ~/.jarvis-code/ — arquivos de configuração, registros de sessão, logs e o cache de atualização. Para mover tudo para outro lugar, aponte um novo caminho pela variável de ambiente JARVIS_CODE_HOME. Para o layout completo de diretórios, veja Locais de dados e Variáveis de ambiente.

Atualização e desinstalação

Depois de instalar, verifique se o executável está pronto:

jarvis --version

Atualizar: execute o instalador novamente. Ele baixa o release de produção mais recente e substitui o binário jarvis instalado.

Desinstalar: apague ~/.jarvis-code/bin/jarvis no Linux ou %USERPROFILE%\.jarvis-code\bin\jarvis.exe no Windows e remova ~/.jarvis-code/bin ou %USERPROFILE%\.jarvis-code\bin do seu PATH. Se você definiu JARVIS_INSTALL_DIR, use o diretório bin dele. Isso preserva sua configuração e os dados de sessão.

Próximos passos

• Interação e entrada — operações da caixa de entrada, fluxo de aprovação, Plan mode e YOLO mode explicados
• Sessões e contexto — retomar sessões, compactar contexto, exportar sessões
• Casos de uso comuns — exemplos de prompt para tarefas típicas