Subcomando jarvis acp

O jarvis acp executa o Jarvis Code CLI como servidor ACP (Agent Client Protocol). Ele se comunica com um cliente ACP, como uma IDE, por JSON-RPC sobre stdin/stdout, permitindo que o cliente conduza sessões, prompts e chamadas de ferramenta do CLI.

jarvis acp

O comando aguarda um cliente ACP enviar initialize no stdin. Ele escreve logs no stderr e no log de diagnóstico em ~/.jarvis-code/logs/, mantendo o stdout livre para o canal ACP.

TIP

Normalmente você não executa jarvis acp diretamente: uma IDE o inicia como subprocesso. Para a configuração do lado da IDE, veja Usando em IDEs.

Use jarvis acp --login para executar o fluxo de login por device code e sair. Com --login, --region <region> aceita mainland-cn (kimi.com) ou global (kimi.ai).

Matriz de capacidades

O CLI retorna estas capacidades na resposta ACP de initialize. A implementação ativa é o servidor ACP do engine padrão agent-core-v2.

Capacidade	Valor	Descrição
promptCapabilities.image	true	Aceita blocos de conteúdo image do ACP.
promptCapabilities.audio	false	Não aceita blocos de prompt de áudio.
promptCapabilities.embeddedContext	true	Aceita blocos resource e resource_link de texto; recursos blob são descartados com um aviso.
mcpCapabilities.http	true	Aceita servidores MCP HTTP fornecidos pelo cliente ACP.
mcpCapabilities.sse	true	Aceita servidores MCP SSE fornecidos pelo cliente ACP.
loadSession	true	Suporta carregar uma sessão existente.
sessionCapabilities	list, resume, close, delete, fork, additionalDirectories	Anuncia as operações de sessão suportadas.
auth.logout	{}	Suporta logout via ACP.

Cobertura de métodos

O servidor trata autenticação, criação, carregamento, retomada, listagem, fechamento e exclusão de sessões, além de prompts. Ele também trata session/set_mode e session/set_config_option para configurações de sessão. O session/cancel interrompe o turno atual. O endpoint instável session/fork está implementado, assim como o endpoint de compatibilidade session/set_model.

Para RPC reversa, o CLI transmite atualizações de sessão e solicita permissão através do cliente ACP. Quando o cliente anuncia capacidades de sistema de arquivos, leituras e escritas de arquivo podem ser roteadas para ele; quando anuncia suporte a terminal, execuções de Bash podem usar o terminal do cliente.

Métodos fora dessa superfície retornam methodNotFound.

Encaminhamento de MCP

Servidores MCP fornecidos em session/new, session/load ou session/resume valem apenas para aquela sessão e não são persistidos no config.toml.

• http é encaminhado como servidor MCP HTTP.
• stdio (o padrão do ACP quando nenhum tipo de transporte é informado) é encaminhado como servidor MCP stdio.
• sse é encaminhado como servidor MCP SSE.
• acp não é suportado e é descartado com um aviso.

Próximos passos

• Usando em IDEs — passos de configuração da IDE e solução de problemas.
• Comando jarvis — lista completa de subcomandos.