Usando o Jarvis Code CLI em IDEs

O Jarvis Code CLI suporta integração com IDEs pelo Agent Client Protocol (ACP), permitindo usar programação assistida por IA direto no seu editor.

Pré-requisitos

Antes de configurar sua IDE, garanta que o Jarvis Code CLI está instalado e que você concluiu a autenticação.

O adaptador ACP é exposto pelo subcomando jarvis acp. A IDE o inicia como processo filho e se comunica por stdin/stdout usando JSON-RPC. Cada vez que a IDE cria uma sessão, o CLI reaproveita o estado de autenticação existente — não é preciso autenticar de novo.

Nota sobre caminho

Processos filhos iniciados a partir da GUI de uma IDE no macOS normalmente não herdam o PATH do shell do terminal. Se jarvis não estiver em um diretório de sistema como /usr/local/bin, use o caminho absoluto na configuração da IDE. Execute which jarvis em um terminal para descobrir o caminho ativo.

Usar o Jarvis Code CLI no Zed

O Zed é um editor moderno com suporte nativo a ACP.

Adicione o seguinte ao arquivo de configuração do Zed em ~/.config/zed/settings.json:

{
  "agent_servers": {
    "Jarvis Code CLI": {
      "type": "custom",
      "command": "jarvis",
      "args": ["acp"],
      "env": {}
    }
  }
}

Campos de configuração:

• type: valor fixo "custom"
• command: caminho do executável do Jarvis Code CLI. Se jarvis não estiver no PATH, use o caminho completo (por exemplo /Users/voce/.local/bin/jarvis).
• args: argumentos de inicialização. O subcomando acp coloca o CLI em modo ACP.
• env: variáveis de ambiente adicionais; normalmente deixe vazio. O Zed injeta um ambiente padrão automaticamente.

Depois de salvar, abra uma nova conversa no painel Agent do Zed e ele iniciará um subprocesso ACP Jarvis Code CLI com a configuração acima. Servidores MCP declarados na seção agent_servers do Zed também são encaminhados ao Jarvis Code pelo protocolo ACP.

Usar o Jarvis Code CLI em IDEs JetBrains

IDEs JetBrains (IntelliJ IDEA, PyCharm, WebStorm etc.) suportam ACP pelo plugin de AI chat.

Se você não tem assinatura JetBrains AI, pode habilitar llm.enable.mock.response no Registry para acessar o painel de AI chat em cenários exclusivamente ACP. Pressione Shift duas vezes e busque por "Registry" para abri-lo.

No menu do painel de AI chat, clique em Configure ACP agents e adicione a configuração a seguir:

{
  "agent_servers": {
    "Jarvis Code CLI": {
      "command": "~/.local/bin/jarvis",
      "args": ["acp"],
      "env": {}
    }
  }
}

O JetBrains é rigoroso com o campo command — sempre use um caminho absoluto, que você obtém executando which jarvis em um terminal. Depois de salvar, Jarvis Code CLI aparece no seletor de agentes do AI chat.

Usar o Jarvis Code CLI no Paseo

O Paseo é um orquestrador auto-hospedado que executa e supervisiona CLIs de agente a partir do desktop, da web e do celular. Ele se conecta ao Jarvis Code CLI por ACP, do mesmo jeito que uma IDE.

Escolha Jarvis Code CLI no catálogo embutido de provedores ACP do Paseo, ou adicione um provedor personalizado em ~/.paseo/config.json:

{
  "agents": {
    "providers": {
      "jarvis": {
        "extends": "acp",
        "label": "Jarvis Code CLI",
        "command": ["jarvis", "acp"]
      }
    }
  }
}

O adaptador ACP genérico do Paseo não conduz o fluxo de login, então conclua primeiro a autenticação pelo terminal (veja Pré-requisitos) — caso contrário a criação de sessão falha com Authentication required.

Solução de problemas

• A sessão desconecta na hora / a IDE mostra "agent exited": normalmente um caminho errado em command ou falta de login. Execute jarvis acp em um terminal primeiro para verificar — se ele ficar bloqueado esperando stdin, o CLI está bem e o problema está na configuração da IDE; se sair imediatamente com erro, siga a mensagem (o caso mais comum é precisar rodar /login).
• A IDE mostra "auth required": o CLI não tem um token de autenticação utilizável. Feche a IDE, execute jarvis em um terminal para concluir o login e reinicie a IDE.
• Ferramentas MCP não aparecem: consulte a tabela de capacidades da referência do jarvis acp para confirmar que o tipo de transporte MCP configurado na sua IDE é suportado. O adaptador ACP do Jarvis Code CLI suporta os transportes http, stdio e sse; servidores MCP com transporte acp são descartados e um aviso é escrito no log.

Próximos passos

• Referência do jarvis acp — matriz de capacidades ACP e detalhes de cobertura de métodos
• Comando jarvis — lista completa de subcomandos