Saltar para o conteúdo
Gratuito e de código aberto

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$ reevesagents
O reevesagents 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

shell
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

shell
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open api

O 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

shell
reevesagents stop "feature x" --yes
O stop, 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 reevesagents sem argumentos para abrir a TUI. Ela embrulha-se numa sessão tmux chamada reeves, comportamento que REEVES_NO_TMUX_WRAPPER=1 desliga.
  • O reevesagents web inicia a Web UI em 127.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.

shell
reevesagents attach cc
reevesagents hosts
  • Seis CLIs podem alojá-lo: Claude Code, Codex, Kimi Code, Qwen Code, Hermes e OpenCode. O reevesagents attach sem nome associa-o a todas as que estiverem instaladas, e o reevesagents 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: --name, --cwd, --prompt, --skip, --run, --auth-mode, --effort, --extra-args, --json.

add [spec...]

Adiciona agentes à execução ativa mais recente. Flags: --run, --prompt, --skip, --auth-mode, --effort, --extra-args, --json. É necessária pelo menos uma especificação.

runs

Lista as execuções ativas. --json.

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. -n/--lines (20 por defeito), --json.

stop <run-id>requer --yes

Para uma execução e fecha a respetiva sessão tmux. -y/--yes.

kill <agent-id>requer --yes

Para um agente. A execução termina com o último agente ativo. -y/--yes.

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, ctrl-c.

interrupt <agent-id>

Envia ctrl-c.

Registos e histórico

agents [run-id]

Lista os agentes das execuções ativas ou de uma execução específica. --json.

providers

Lista os fornecedores com a respetiva disponibilidade e os modelos conhecidos. --models, --json.

tools

Lista as ferramentas do agente com o estado de instalação e de início de sessão. --json.

delete <agent-id>requer --yes

Elimina o registo de um agente terminado. -y/--yes.

delete-run <run-id>requer --yes

Elimina uma execução terminada. -y/--yes.

history

Lista o histórico de execuções arquivadas. --json.

delete-history <id>requer --yes

Elimina um registo do histórico. -y/--yes.

Aprovações

approvals

Lista as aprovações pendentes. --json.

approve <approval-id> [note]

Aprova um pedido pendente.

deny <approval-id> [note]

Recusa um pedido pendente.

Anfitriãs MCP

hosts

Lista as CLIs anfitriãs compatíveis com MCP e indica quais estão associadas. --json.

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. --force reescreve um registo existente.

detach <cli>

Desassocia o MCP de uma CLI anfitriã, através da própria CLI ou do respetivo ficheiro de configuração.

mcp

Inicia 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. --json.

presets

Lista os presets guardados. --json.

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. --name, --cwd.

delete-preset <name>requer --yes

Elimina um preset. -y/--yes.

Preparação e ferramentas

setup

Assistente de primeira utilização: verifica o tmux, o Node e as CLIs instaladas. --attach liga o MCP a todas as anfitriãs instaladas. --json indica o estado da configuração inicial.

doctor

Executa o diagnóstico do ambiente. Devolve um código de saída diferente de zero em caso de falha. --json.

skills [action]

Instala, remove ou verifica a skill do ReevesAgents nas CLIs compatíveis com skills (install, remove, status; status por defeito). --json.

reap

Termina os agentes cuja janela desapareceu ou que ultrapassaram max_lifetime_ms, e fecha as sessões tmux órfãs. --json.

web

Inicia em primeiro plano a Web UI, que só escuta no loopback. --port, --no-open.

Ferramentas MCP

As 31 ferramentas que uma CLI associada pode chamar, agrupadas por finalidade.

Criar e conduzir

spawnobrigatórioprovideropcionalrun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_args

Cria 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_id

Para um agente.

stopobrigatóriorun_id

Para uma execução inteira e fecha a respetiva sessão tmux.

send_textobrigatórioagent_idtext

Cola texto no prompt de um agente, sem o submeter.

send_keyobrigatórioagent_idkey

Envia uma tecla permitida, como enter, escape ou ctrl-c.

interruptobrigatórioagent_id

Envia ctrl-c a um agente.

readobrigatórioagent_idopcionallines

Lê a saída recente do painel, sem sequências ANSI e com os dados sensíveis ocultados. Por defeito: 20 linhas.

Inspecionar

list

Lista as execuções e os agentes.

list_providers

Catálogo de fornecedores e modelos desta máquina.

list_tools

Catá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_history

Execuções arquivadas.

list_presets

Presets guardados.

list_hosts

CLIs compatíveis com MCP e quais estão associadas.

get_config

Configuração global atual.

doctor

Diagnóstico do ambiente.

Aprovações

request_approvalobrigatórioagent_idactionsummaryopcionaldetailsrisk

Cria um pedido de aprovação.

resolve_approvalobrigatórioapproval_iddecisionopcionalnote

Aprova ou recusa um pedido pendente.

check_approvalobrigatórioapproval_id

Consulta um pedido de aprovação.

list_approvalsopcionalrun_idstatus

Lista as aprovações, com filtros opcionais.

Ciclo de vida

deleteobrigatórioagent_id

Elimina o registo de um agente terminado.

delete_runobrigatóriorun_id

Elimina uma execução terminada.

delete_historyobrigatórioid

Elimina um registo do histórico.

openobrigatórioid

Muda o cliente tmux ligado para uma execução ou um agente.

reap

Limpa 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_permissionslanguage

Altera um ou mais campos de configuração editáveis.

save_presetobrigatóriorun_idnameopcionaldescription

Guarda uma execução a correr como preset.

start_presetobrigatórionameopcionalrun_nameworking_dir

Inicia uma execução a partir de um preset.

delete_presetobrigatórioname

Elimina um preset.

Anfitriãs e skills

attach_hostopcionalkey

Associa o MCP a uma CLI anfitriã, ou a todas.

detach_hostobrigatóriokey

Desassocia o MCP de uma CLI anfitriã.

install_skillsopcionalstatus

Instala a skill do ReevesAgents nas CLIs compatíveis com skills ou indica onde se encontra.

Dois recursos disponibilizam o catálogo de fornecedores e um guia de utilização: reevesagents://providers, reevesagents://guide

Configuraçã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.

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>.json

Variáveis de ambiente que se sobrepõem

REEVES_REGISTRY

Substitui o diretório raiz do estado (por defeito, ~/.reeves).

REEVES_CONFIG

Substitui o caminho do ficheiro de configuração.

REEVES_NO_TMUX_WRAPPER=1

Com o valor 1, a TUI não se embrulha automaticamente numa sessão tmux.

REEVES_NO_COLOR=1

Com o valor 1, desativa as cores da TUI.

ALLOW_DESTRUCTIVE=1

Com o valor 1, permite comandos destrutivos sem --yes.

REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1

Com 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ário claude

    modelos sugeridos fable, opus, sonnet, haiku

  • Codex CLIAnfitriã MCP

    CLI do agente de programação da OpenAI

    id codexbinário codex

    modelos 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ário opencode

    modelos 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ário hermes

    modelos 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ário kimi

    modelos 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ário deepseek

    modelos sugeridos deepseek-v4-pro, deepseek-v4-flash

  • Pi

    Estrutura mínima de programação para o terminal

    id pibinário pi

    modelos sugeridos sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o

  • Qwen CodeAnfitriã MCP

    CLI do agente de programação da Alibaba

    id qwenbinário qwen

    modelos sugeridos qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next

  • Aider

    Programação em par com IA no terminal

    id aiderbinário aider

    modelos sugeridos sonnet, opus, haiku, deepseek/deepseek-chat

  • Gemini CLI

    Agente de terminal de código aberto da Google

    id geminibinário gemini

    modelos 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ário cline

    modelos 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ário crush

    modelos sugeridos escolhido na própria CLI

  • Goose

    Agente de IA de uso geral e código aberto

    id goosebinário goose

    modelos 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ário kilo

    modelos 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ário letta

    modelos 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ário vibe

    modelos sugeridos escolhido na própria CLI

  • Grok Build

    CLI do agente de programação da xAI

    id grokbinário grok

    modelos sugeridos grok-4.6, grok-4.5, grok-4.7

  • Kiro CLI

    CLI de programação agêntica da AWS

    id kirobinário kiro-cli

    modelos 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ário droid

    modelos sugeridos escolhido na própria CLI

  • Qoder CLI

    CLI de programação agêntica da Qoder

    id qoderbinário qodercli

    modelos sugeridos auto, performance, lite

  • Warp

    Agente da Warp no terminal

    id warpbinário warp

    modelos sugeridos escolhido na própria CLI

  • Junie CLI

    CLI do agente de programação da JetBrains

    id juniebinário junie

    modelos sugeridos sonnet, opus, gpt-sol

  • GitHub Copilot CLI

    CLI do agente de programação do GitHub

    id copilotbinário copilot

    modelos sugeridos auto, gpt-5.4, claude-opus-4.8

  • Cursor CLI

    CLI do agente de programação do Cursor

    id cursorbinário cursor-agent

    modelos sugeridos gpt-5, sonnet-4-thinking, claude-opus-4-8

  • Rovo Dev CLI

    CLI do agente de programação da Atlassian

    id rovobinário acli

    modelos sugeridos escolhido na própria CLI

  • O --effort define o esforço de raciocínio no Claude Code e no Codex. O --auth-mode api-key aplica-se ao Claude Code.
  • Qualquer outra flag de arranque passa por --extra-args, por exemplo o --remote-control do Claude Code.
  • Mantenha os pedidos de autorização ativos. --skip desativa-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 CLIpplx

    Pesquisa na web e excertos de páginas do Perplexity, em JSON.

  • Google Colab CLIcolab

    Ambientes de execução com CPU, GPU e TPU no Google Colab: execute scripts e notebooks remotamente.

  • Hugging Face CLIhf

    Transfira e envie modelos e conjuntos de dados, e execute tarefas no Hub da Hugging Face.

  • Ollamaollama

    Execute 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: