Documentação
Os assistentes de IA realizam tarefas de programação. Este guia explica ferramentas de linha de comandos (CLI), menus do terminal (TUI), o tmux que mantém tarefas em execução e uma ligação padrão entre ferramentas de IA (MCP).
Instalação
Precisa de macOS, Linux ou WSL, Node 22.12 ou mais recente, tmux 3.0 ou mais recente e pelo menos uma CLI de fornecedor instalada e com sessão iniciada.
$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagentsreevesagents doctor verifica tudo isso. O reevesagents setup corre as mesmas verificações como assistente de primeira utilização e, com --attach, liga também o MCP a todas as anfitriãs instaladas.Início rápido
Inicie uma equipa, acompanhe-a, intervenha e pare-a.
Iniciar uma equipa
reevesagents spawn cc:lead codex:api kimi:docs \
--name "feature x" --prompt "Build feature X. The lead splits the work."Cada assistente escreve-se como provider[:nickname[:model]], e o primeiro é o principal. Use reevesagents add para acrescentar assistentes à execução mais recente.
Observar e orientar
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open apiO send cola texto sem o submeter, por isso faça-o seguir de key <agent> enter. O open leva-o até ao assistente no tmux.
Parar
reevesagents stop "feature x" --yesstop, o kill e os comandos delete esperam por --yes (ou ALLOW_DESTRUCTIVE=1).Menu do terminal, navegador e comandos
O menu (TUI), a interface do navegador e a ferramenta de linha de comandos (CLI) partilham os registos de tarefas em ~/.reeves. A ferramenta de terminal tmux mantém os assistentes em execução.
- Escreva
reevesagentssem argumentos para abrir a TUI. Ela embrulha-se numa sessão tmux chamadareeves, comportamento queREEVES_NO_TMUX_WRAPPER=1desliga. - O
reevesagents webinicia a Web UI em127.0.0.1, na porta 8080 ou na seguinte que estiver livre. Recusa cabeçalhos Host fora do loopback e escritas vindas de outra origem, e o Ctrl+C para-a sem mexer nos seus assistentes. - Tudo existe também como comando da CLI. Os scripts devem ler
--json, porque a saída em texto simples pode mudar entre versões. - Por baixo está o tmux, com uma sessão por execução e uma janela por assistente. O
reevesagents open <id>leva-o à janela certa a partir de onde estiver.
Controlo de Agentes (MCP)
Ligue uma ferramenta de programação às outras através de um protocolo padrão (MCP). É opcional. Reinicie a ferramenta depois de a ligar.
reevesagents attach cc
reevesagents hosts- Seis CLIs podem alojá-lo: Claude Code, Codex, Kimi Code, Qwen Code, Hermes e OpenCode. O
reevesagents attachsem nome associa-o a todas as que estiverem instaladas, e oreevesagents detach <cli>volta a removê-lo. - A anfitriã recebe ferramentas simples para criar assistentes, colar texto, carregar em teclas, ler a saída e tratar aprovações. O que a equipa faz é decidido por quem dá os prompts à anfitriã.
- Os trabalhadores criados só recebem as ferramentas se também associar a CLI deles. Os lançamentos via MCP respeitam
max_agents(100 por defeito) como limite de assistentes por execução.
Comandos
Todos os subcomandos de reevesagents. Sem argumentos, abre a TUI.
Execuções
spawn [spec...]Inicia uma execução. Cada especificação tem a forma provider[:nickname[:model]] e o primeiro agente é o principal. Flags:
add [spec...]Adiciona agentes à execução ativa mais recente. Flags:
runsLista as execuções ativas.
open <id>Salta para a janela de uma execução ou de um agente no tmux. Aceita um id, nome, alcunha ou prefixo único.
peek <agent-id>Imprime a saída recente de um agente.
stop <run-id>requer Para uma execução e fecha a respetiva sessão tmux.
kill <agent-id>requer Para um agente. A execução termina com o último agente ativo.
Conduzir um assistente
send <agent-id> <text...>Cola texto no prompt do agente, sem o submeter.
key <agent-id> <key>Envia uma tecla permitida: enter, escape, backspace, tab, space, up, down, left, right,
interrupt <agent-id>Envia
Registos e histórico
agents [run-id]Lista os agentes das execuções ativas ou de uma execução específica.
providersLista os fornecedores com a respetiva disponibilidade e os modelos conhecidos.
toolsLista as ferramentas do agente com o estado de instalação e de início de sessão.
delete <agent-id>requer Elimina o registo de um agente terminado.
delete-run <run-id>requer Elimina uma execução terminada.
historyLista o histórico de execuções arquivadas.
delete-history <id>requer Elimina um registo do histórico.
Aprovações
approvalsLista as aprovações pendentes.
approve <approval-id> [note]Aprova um pedido pendente.
deny <approval-id> [note]Recusa um pedido pendente.
Anfitriãs MCP
hostsLista as CLIs anfitriãs compatíveis com MCP e indica quais estão associadas.
attach [cli]Associa o MCP a uma CLI anfitriã, ou a todas as anfitriãs instaladas, através da própria CLI ou do respetivo ficheiro de configuração.
detach <cli>Desassocia o MCP de uma CLI anfitriã, através da própria CLI ou do respetivo ficheiro de configuração.
mcpInicia o servidor MCP do Controlo de Agentes via stdio. Quem executa este comando é a CLI anfitriã.
Configuração e presets
config [key] [value]Mostra, consulta ou altera um campo de configuração editável.
presetsLista os presets guardados.
save-preset <run-id> <name> [description...]Guarda uma execução a correr como preset.
start-preset <name>Inicia uma execução a partir de um preset.
delete-preset <name>requer Elimina um preset.
Preparação e ferramentas
setupAssistente de primeira utilização: verifica o tmux, o Node e as CLIs instaladas.
doctorExecuta o diagnóstico do ambiente. Devolve um código de saída diferente de zero em caso de falha.
skills [action]Instala, remove ou verifica a skill do ReevesAgents nas CLIs compatíveis com skills (install, remove, status; status por defeito).
reapTermina os agentes cuja janela desapareceu ou que ultrapassaram max_lifetime_ms, e fecha as sessões tmux órfãs.
webInicia em primeiro plano a Web UI, que só escuta no loopback.
Ferramentas MCP
As 31 ferramentas que uma CLI associada pode chamar, agrupadas por finalidade.
Criar e conduzir
spawnobrigatórioprovideropcionalrun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_argsCria um trabalhador. Sem run_id, reutiliza a execução desta sessão MCP, criada na primeira chamada ao spawn. Com run_id, cria-o noutra execução.
killobrigatórioagent_idPara um agente.
stopobrigatóriorun_idPara uma execução inteira e fecha a respetiva sessão tmux.
send_textobrigatórioagent_idtextCola texto no prompt de um agente, sem o submeter.
send_keyobrigatórioagent_idkeyEnvia uma tecla permitida, como enter, escape ou
interruptobrigatórioagent_idEnvia
readobrigatórioagent_idopcionallinesLê a saída recente do painel, sem sequências ANSI e com os dados sensíveis ocultados. Por defeito: 20 linhas.
Inspecionar
listLista as execuções e os agentes.
list_providersCatálogo de fornecedores e modelos desta máquina.
list_toolsCatálogo de ferramentas desta máquina: CLI auxiliares que um agente pode executar a partir da sua shell, com o estado de instalação e de início de sessão.
list_historyExecuções arquivadas.
list_presetsPresets guardados.
list_hostsCLIs compatíveis com MCP e quais estão associadas.
get_configConfiguração global atual.
doctorDiagnóstico do ambiente.
Aprovações
request_approvalobrigatórioagent_idactionsummaryopcionaldetailsriskCria um pedido de aprovação.
resolve_approvalobrigatórioapproval_iddecisionopcionalnoteAprova ou recusa um pedido pendente.
check_approvalobrigatórioapproval_idConsulta um pedido de aprovação.
list_approvalsopcionalrun_idstatusLista as aprovações, com filtros opcionais.
Ciclo de vida
deleteobrigatórioagent_idElimina o registo de um agente terminado.
delete_runobrigatóriorun_idElimina uma execução terminada.
delete_historyobrigatórioidElimina um registo do histórico.
openobrigatórioidMuda o cliente tmux ligado para uma execução ou um agente.
reapLimpa de imediato os agentes sem janela ou que ultrapassaram o tempo de vida máximo, bem como as sessões tmux órfãs.
Configuração e presets
set_configopcionalpeek_interval_mspeek_linesmax_depthmax_agentsready_delay_msmax_lifetime_msdefault_permissionslanguageAltera um ou mais campos de configuração editáveis.
save_presetobrigatóriorun_idnameopcionaldescriptionGuarda uma execução a correr como preset.
start_presetobrigatórionameopcionalrun_nameworking_dirInicia uma execução a partir de um preset.
delete_presetobrigatórionameElimina um preset.
Anfitriãs e skills
attach_hostopcionalkeyAssocia o MCP a uma CLI anfitriã, ou a todas.
detach_hostobrigatóriokeyDesassocia o MCP de uma CLI anfitriã.
install_skillsopcionalstatusInstala a skill do ReevesAgents nas CLIs compatíveis com skills ou indica onde se encontra.
reevesagents://providers, reevesagents://guideConfiguração
As definições ficam em ~/.reeves/config.json. Altere uma com reevesagents config <key> <value> ou nos ecrãs de definições. O reevesagents config language tr muda a interface para um dos seus dez idiomas.
Campos
peek_interval_ms5000
Definição guardada do intervalo de consulta. As interfaces atuais usam intervalos de atualização fixos.
peek_lines10
Definição guardada do número de linhas de saída. Os ecrãs atuais e as leituras via CLI/MCP usam números de linhas próprios.
max_agents100
Limite de agentes ativos por execução, aplicado nos lançamentos via MCP. As restantes formas de lançamento não o aplicam.
max_depth5
Definição guardada da profundidade de recursão. O motor de execução atual não a aplica.
ready_delay_ms5000
Espera que uma CLI acabada de arrancar estabilize antes de lhe colar um prompt.
max_lifetime_ms0
Termina os agentes com idade superior a este valor. 0 desativa o limite.
default_permissionsask
Modo de permissões por defeito para os novos agentes: ask ou skip.
languageen
Idioma da interface, um dos dez códigos disponíveis.
peek_interval_ms | 5000 | Definição guardada do intervalo de consulta. As interfaces atuais usam intervalos de atualização fixos. |
peek_lines | 10 | Definição guardada do número de linhas de saída. Os ecrãs atuais e as leituras via CLI/MCP usam números de linhas próprios. |
max_agents | 100 | Limite de agentes ativos por execução, aplicado nos lançamentos via MCP. As restantes formas de lançamento não o aplicam. |
max_depth | 5 | Definição guardada da profundidade de recursão. O motor de execução atual não a aplica. |
ready_delay_ms | 5000 | Espera que uma CLI acabada de arrancar estabilize antes de lhe colar um prompt. |
max_lifetime_ms | 0 | Termina os agentes com idade superior a este valor. 0 desativa o limite. |
default_permissions | ask | Modo de permissões por defeito para os novos agentes: ask ou skip. |
language | en | Idioma da interface, um dos dez códigos disponíveis. |
Estado em disco
~/.reeves/
config.json
presets/<name>.json
runs/<run-id>/
run.json
agents/<agent-id>.json
approvals/<approval-id>.json
history/runs/<run-id>.jsonVariáveis de ambiente que se sobrepõem
REEVES_REGISTRYSubstitui o diretório raiz do estado (por defeito,
REEVES_CONFIGSubstitui o caminho do ficheiro de configuração.
REEVES_NO_TMUX_WRAPPER=1Com o valor 1, a TUI não se embrulha automaticamente numa sessão tmux.
REEVES_NO_COLOR=1Com o valor 1, desativa as cores da TUI.
ALLOW_DESTRUCTIVE=1Com o valor 1, permite comandos destrutivos sem
REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1Com o valor 1, o doctor salta a verificação de compatibilidade dos fornecedores.
Fornecedores
25 CLIs, cada uma com um id curto que usa numa especificação de spawn. As listas de modelos são sugestões, e qualquer id de modelo que indique segue diretamente para o fornecedor.
Claude CodeAnfitriã MCP
Agente de programação da Anthropic para o terminal
id
ccbinárioclaudemodelos sugeridos fable, opus, sonnet, haiku
Codex CLIAnfitriã MCP
CLI do agente de programação da OpenAI
id
codexbináriocodexmodelos sugeridos gpt-5.6-sol, gpt-5.5, gpt-5.4-mini
OpenCode CLIAnfitriã MCP
Agente de programação de código aberto para o terminal
id
opencodebinárioopencodemodelos sugeridos opencode/claude-sonnet-4-6, opencode/claude-opus-4-8, opencode/gpt-5.2-codex, anthropic/claude-opus-4-8, anthropic/claude-haiku-4-5, openai/gpt-5.5
HermesAnfitriã MCP
CLI do agente da Nous Research
id
hermesbináriohermesmodelos sugeridos anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini
Kimi CodeAnfitriã MCP
CLI de programação da Moonshot AI
id
kimibináriokimimodelos sugeridos kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed
DeepSeek CLI
CLI de programação da DeepSeek
id
deepseekbináriodeepseekmodelos sugeridos deepseek-v4-pro, deepseek-v4-flash
Pi
Estrutura mínima de programação para o terminal
id
pibináriopimodelos sugeridos sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o
Qwen CodeAnfitriã MCP
CLI do agente de programação da Alibaba
id
qwenbinárioqwenmodelos sugeridos qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next
Aider
Programação em par com IA no terminal
id
aiderbinárioaidermodelos sugeridos sonnet, opus, haiku, deepseek/deepseek-chat
Gemini CLI
Agente de terminal de código aberto da Google
id
geminibináriogeminimodelos sugeridos gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite
Cline CLI
CLI de agente de programação autónomo
id
clinebinárioclinemodelos sugeridos anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro
Crush
Agente de programação da Charm para o terminal
id
crushbináriocrushmodelos sugeridos escolhido na própria CLI
Goose
Agente de IA de uso geral e código aberto
id
goosebináriogoosemodelos sugeridos claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro
Kilo Code
Agente de programação de código aberto com CLI
id
kilobináriokilomodelos sugeridos kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest
Letta Code
Agente de programação com memória de longo prazo
id
lettabináriolettamodelos sugeridos zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct
Mistral Vibe
CLI do agente de programação da Mistral
id
vibebináriovibemodelos sugeridos escolhido na própria CLI
Grok Build
CLI do agente de programação da xAI
id
grokbináriogrokmodelos sugeridos grok-4.6, grok-4.5, grok-4.7
Kiro CLI
CLI de programação agêntica da AWS
id
kirobináriokiro-climodelos sugeridos claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6
Factory Droid
CLI do agente de programação da Factory
id
droidbináriodroidmodelos sugeridos escolhido na própria CLI
Qoder CLI
CLI de programação agêntica da Qoder
id
qoderbinárioqoderclimodelos sugeridos auto, performance, lite
Warp
Agente da Warp no terminal
id
warpbináriowarpmodelos sugeridos escolhido na própria CLI
Junie CLI
CLI do agente de programação da JetBrains
id
juniebináriojuniemodelos sugeridos sonnet, opus, gpt-sol
GitHub Copilot CLI
CLI do agente de programação do GitHub
id
copilotbináriocopilotmodelos sugeridos auto, gpt-5.4, claude-opus-4.8
Cursor CLI
CLI do agente de programação do Cursor
id
cursorbináriocursor-agentmodelos sugeridos gpt-5, sonnet-4-thinking, claude-opus-4-8
Rovo Dev CLI
CLI do agente de programação da Atlassian
id
rovobinárioaclimodelos sugeridos escolhido na própria CLI
| Fornecedor | id | binário | modelos sugeridos | Anfitriã MCP |
|---|---|---|---|---|
| Claude CodeAgente de programação da Anthropic para o terminal | cc | claude | fable, opus, sonnet, haiku | ✔ |
| Codex CLICLI do agente de programação da OpenAI | codex | codex | gpt-5.6-sol, gpt-5.5, gpt-5.4-mini | ✔ |
| OpenCode CLIAgente de programação de código aberto para o terminal | opencode | opencode | opencode/claude-sonnet-4-6, opencode/claude-opus-4-8, opencode/gpt-5.2-codex, anthropic/claude-opus-4-8, anthropic/claude-haiku-4-5, openai/gpt-5.5 | ✔ |
| HermesCLI do agente da Nous Research | hermes | hermes | anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini | ✔ |
| Kimi CodeCLI de programação da Moonshot AI | kimi | kimi | kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed | ✔ |
| DeepSeek CLICLI de programação da DeepSeek | deepseek | deepseek | deepseek-v4-pro, deepseek-v4-flash | |
| PiEstrutura mínima de programação para o terminal | pi | pi | sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o | |
| Qwen CodeCLI do agente de programação da Alibaba | qwen | qwen | qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next | ✔ |
| AiderProgramação em par com IA no terminal | aider | aider | sonnet, opus, haiku, deepseek/deepseek-chat | |
| Gemini CLIAgente de terminal de código aberto da Google | gemini | gemini | gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite | |
| Cline CLICLI de agente de programação autónomo | cline | cline | anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro | |
| CrushAgente de programação da Charm para o terminal | crush | crush | escolhido na própria CLI | |
| GooseAgente de IA de uso geral e código aberto | goose | goose | claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro | |
| Kilo CodeAgente de programação de código aberto com CLI | kilo | kilo | kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest | |
| Letta CodeAgente de programação com memória de longo prazo | letta | letta | zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct | |
| Mistral VibeCLI do agente de programação da Mistral | vibe | vibe | escolhido na própria CLI | |
| Grok BuildCLI do agente de programação da xAI | grok | grok | grok-4.6, grok-4.5, grok-4.7 | |
| Kiro CLICLI de programação agêntica da AWS | kiro | kiro-cli | claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6 | |
| Factory DroidCLI do agente de programação da Factory | droid | droid | escolhido na própria CLI | |
| Qoder CLICLI de programação agêntica da Qoder | qoder | qodercli | auto, performance, lite | |
| WarpAgente da Warp no terminal | warp | warp | escolhido na própria CLI | |
| Junie CLICLI do agente de programação da JetBrains | junie | junie | sonnet, opus, gpt-sol | |
| GitHub Copilot CLICLI do agente de programação do GitHub | copilot | copilot | auto, gpt-5.4, claude-opus-4.8 | |
| Cursor CLICLI do agente de programação do Cursor | cursor | cursor-agent | gpt-5, sonnet-4-thinking, claude-opus-4-8 | |
| Rovo Dev CLICLI do agente de programação da Atlassian | rovo | acli | escolhido na própria CLI |
- O
--effortdefine o esforço de raciocínio no Claude Code e no Codex. O--auth-mode api-keyaplica-se ao Claude Code. - Qualquer outra flag de arranque passa por
--extra-args, por exemplo o--remote-controldo Claude Code. - Mantenha os pedidos de autorização ativos.
--skipdesativa-os nas ferramentas de programação.
Ferramentas para agentes
Quatro CLIs auxiliares que um agente pode executar a partir do seu próprio shell. Não aceitam tarefas de chat, por isso não são fornecedores que se possam iniciar. reevesagents tools lista-as com o estado de instalação e de sessão.
Perplexity CLI
pplxPesquisa na web e excertos de páginas do Perplexity, em JSON.
Google Colab CLI
colabAmbientes de execução com CPU, GPU e TPU no Google Colab: execute scripts e notebooks remotamente.
Transfira e envie modelos e conjuntos de dados, e execute tarefas no Hub da Hugging Face.
Ollama
ollamaExecute modelos locais ou na nuvem do Ollama a partir do terminal.
Resolução de problemas
Comece pelo reevesagents doctor. Normalmente é ele que identifica o problema.
Falta o tmux
Instale-o com brew install tmux ou sudo apt install tmux e volte a correr o doctor.
Um fornecedor não aparece
Normalmente a CLI não está instalada ou não tem sessão iniciada. Resolva isso e confirme com reevesagents providers.
A Web UI diz que faltam pacotes
O terminal ao vivo precisa dos módulos opcionais ws e @lydell/node-pty. Reinstale globalmente com npm ou pnpm para os recuperar.
A porta 8080 está ocupada
A Web UI passa para a porta livre seguinte e imprime o URL. Para escolher uma, use reevesagents web --port 8090.
Windows nativo
Corra o produto completo no WSL. Para usar apenas o Controlo de Agentes, o reevesagents-win corre nativamente como servidor MCP.
Números com fontes
Período: 2025-04-14 a 2026-10-14. Valores de GitHub e npm verificados em 2026-10-15. As transferências contam pedidos de pacotes.
Última atualização: