Documentazione
Gli assistenti IA svolgono attività di programmazione. Questa guida presenta strumenti da riga di comando (CLI), menu del terminale (TUI), tmux per mantenere le attività in esecuzione e un collegamento standard tra strumenti IA (MCP).
Installazione
Servono macOS, Linux o WSL, Node 22.12 o più recente, tmux 3.0 o più recente e almeno una CLI di provider installata e con il login fatto.
$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagentsreevesagents doctor verifica tutto questo. reevesagents setup esegue gli stessi controlli come procedura guidata del primo avvio, e con --attach collega anche l'MCP a ogni host installato.Avvio rapido
Avvia una squadra, controlla come va, intervieni e fermala.
Avvia una squadra
reevesagents spawn cc:lead codex:api kimi:docs \
--name "feature x" --prompt "Build feature X. The lead splits the work."Ogni assistente si scrive come provider[:nickname[:model]], e il primo fa da lead. Con reevesagents add aggiungi assistenti all'ultimo run.
Osserva e dirigi
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open apisend incolla il testo senza inviarlo, quindi fallo seguire da key <agent> enter. open ti porta all'assistente in tmux.
Ferma
reevesagents stop "feature x" --yesstop, kill e i comandi delete partono solo con --yes (o ALLOW_DESTRUCTIVE=1).Menu del terminale, browser e comandi
Il menu (TUI), l’interfaccia del browser e lo strumento da riga di comando (CLI) condividono i dati delle attività in ~/.reeves. Lo strumento di terminale tmux mantiene gli assistenti in esecuzione.
- Digita
reevesagentssenza argomenti per aprire la TUI. Si avvolge da sola in una sessione tmux chiamatareeves, eREEVES_NO_TMUX_WRAPPER=1disattiva questo comportamento. reevesagents webavvia la Web UI su127.0.0.1, sulla porta 8080 o sulla prima libera. Rifiuta gli header Host diversi da loopback e le scritture cross-origin, e Ctrl+C la ferma senza toccare i tuoi assistenti.- Ogni azione esiste anche come comando della CLI. Gli script dovrebbero leggere
--json, perché l'output testuale può cambiare da una versione all'altra. - Sotto c'è tmux, con una sessione per run e una finestra per assistente. Da dovunque tu sia,
reevesagents open <id>ti porta alla finestra giusta.
Controllo agenti (MCP)
Collega uno strumento di programmazione agli altri tramite un protocollo standard (MCP). È facoltativo. Riavvia lo strumento dopo averlo collegato.
reevesagents attach cc
reevesagents hosts- Sei CLI possono ospitarlo: Claude Code, Codex, Kimi Code, Qwen Code, Hermes e OpenCode.
reevesagents attachsenza nome lo collega a tutte quelle installate, ereevesagents detach <cli>lo rimuove. - L'host riceve strumenti semplici per avviare assistenti, incollare testo, premere tasti, leggere l'output e gestire le approvazioni. Cosa fa la squadra lo decide chi scrive i prompt all'host.
- I worker avviati ricevono gli strumenti solo se colleghi anche la loro CLI. Gli avvii tramite MCP rispettano
max_agents(100 di default) come limite di assistenti per run.
Comandi
Tutti i sottocomandi di reevesagents. Senza argomenti si apre la TUI.
Run
spawn [spec...]Avvia un run. Ogni spec si scrive come provider[:nickname[:model]], e il primo agente fa da lead. Flag:
add [spec...]Aggiunge agenti al run attivo più recente. Flag:
runsElenca i run attivi.
open <id>Passa alla finestra tmux di un run o di un agente. Accetta un id, un nome, un nickname o un prefisso univoco.
peek <agent-id>Stampa l'output recente di un agente.
stop <run-id>richiede Ferma un run e chiude la sua sessione tmux.
kill <agent-id>richiede Ferma un agente. Il run termina con il suo ultimo agente attivo.
Guidare un assistente
send <agent-id> <text...>Incolla il testo nel prompt dell'agente senza inviarlo.
key <agent-id> <key>Invia un tasto consentito: enter, escape, backspace, tab, space, up, down, left, right,
interrupt <agent-id>Invia
Record e cronologia
agents [run-id]Elenca gli agenti dei run attivi o di un run specifico.
providersElenca i provider con disponibilità e modelli noti.
toolsElenca gli strumenti dell'agente con lo stato di installazione e di accesso.
delete <agent-id>richiede Elimina il record di un agente terminato.
delete-run <run-id>richiede Elimina un run terminato.
historyElenca la cronologia dei run archiviati.
delete-history <id>richiede Elimina un record della cronologia.
Approvazioni
approvalsElenca le approvazioni in sospeso.
approve <approval-id> [note]Approva una richiesta in sospeso.
deny <approval-id> [note]Rifiuta una richiesta in sospeso.
Host MCP
hostsElenca le CLI host compatibili con MCP e mostra quali sono collegate.
attach [cli]Collega l'MCP a una CLI host, o a tutti gli host installati, tramite la sua CLI o il suo file di configurazione.
detach <cli>Scollega l'MCP da una CLI host tramite la sua CLI o il suo file di configurazione.
mcpAvvia su stdio il server MCP di Controllo agenti. È la CLI host a eseguirlo.
Configurazione e preset
config [key] [value]Mostra la configurazione oppure legge o imposta un campo modificabile.
presetsElenca i preset salvati.
save-preset <run-id> <name> [description...]Salva un run attivo come preset.
start-preset <name>Avvia un run da un preset.
delete-preset <name>richiede Elimina un preset.
Setup e strumenti
setupControllo di primo avvio per tmux, Node e le CLI installate.
doctorEsegue i controlli di salute dell'ambiente. In caso di errore esce con un codice diverso da zero.
skills [action]Installa, rimuove o controlla la skill di ReevesAgents per le CLI che supportano le skill (install, remove, status; di default status).
reapTermina gli agenti la cui finestra è scomparsa o che hanno superato max_lifetime_ms, e chiude le sessioni tmux orfane.
webAvvia in primo piano la Web UI, in ascolto solo su loopback.
Strumenti MCP
I 31 strumenti che una CLI collegata può chiamare, raggruppati per scopo.
Avvio e guida
spawnobbligatorioprovideropzionalerun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_argsAvvia un worker. Senza run_id riusa il run di questa sessione MCP, creato al primo spawn. Con run_id lo avvia in un altro run.
killobbligatorioagent_idFerma un agente.
stopobbligatoriorun_idFerma un intero run e chiude la sua sessione tmux.
send_textobbligatorioagent_idtextIncolla il testo nel prompt di un agente senza inviarlo.
send_keyobbligatorioagent_idkeyInvia un tasto consentito (enter, escape,
interruptobbligatorioagent_idInvia
readobbligatorioagent_idopzionalelinesLegge l'output recente del pannello, senza sequenze ANSI e con i segreti oscurati. Di default 20 righe.
Ispezione
listElenca i run e gli agenti.
list_providersCatalogo dei provider e dei modelli di questa macchina.
list_toolsCatalogo degli strumenti di questa macchina: CLI ausiliarie che un agente può eseguire dalla sua shell, con stato di installazione e di accesso.
list_historyRun archiviati.
list_presetsPreset salvati.
list_hostsCLI compatibili con MCP e quali sono collegate.
get_configConfigurazione globale attuale.
doctorControlli di salute dell'ambiente.
Approvazioni
request_approvalobbligatorioagent_idactionsummaryopzionaledetailsriskCrea una richiesta di approvazione.
resolve_approvalobbligatorioapproval_iddecisionopzionalenoteApprova o rifiuta una richiesta in sospeso.
check_approvalobbligatorioapproval_idLegge un'approvazione.
list_approvalsopzionalerun_idstatusElenca le approvazioni, con filtri opzionali.
Ciclo di vita
deleteobbligatorioagent_idElimina il record di un agente terminato.
delete_runobbligatoriorun_idElimina un run terminato.
delete_historyobbligatorioidElimina un record della cronologia.
openobbligatorioidSposta il client tmux collegato su un run o su un agente.
reapRipulisce subito gli agenti con la finestra scomparsa o oltre la durata massima, insieme alle sessioni tmux orfane.
Configurazione e preset
set_configopzionalepeek_interval_mspeek_linesmax_depthmax_agentsready_delay_msmax_lifetime_msdefault_permissionslanguageImposta uno o più campi modificabili della configurazione.
save_presetobbligatoriorun_idnameopzionaledescriptionSalva un run attivo come preset.
start_presetobbligatorionameopzionalerun_nameworking_dirAvvia un run da un preset.
delete_presetobbligatorionameElimina un preset.
Host e skill
attach_hostopzionalekeyCollega l'MCP a una CLI host o a tutte.
detach_hostobbligatoriokeyScollega l'MCP da una CLI host.
install_skillsopzionalestatusInstalla la skill di ReevesAgents per le CLI che supportano le skill, o indica dove si trova.
reevesagents://providers, reevesagents://guideConfigurazione
Le impostazioni stanno in ~/.reeves/config.json. Ne cambi una con reevesagents config <key> <value> o dalle schermate delle impostazioni. Con reevesagents config language tr l'interfaccia passa a una delle sue dieci lingue.
Campi
peek_interval_ms5000
Impostazione salvata per l'intervallo di polling. Le UI attuali usano intervalli di aggiornamento fissi.
peek_lines10
Impostazione salvata per il numero di righe di output. Le schermate attuali e le letture da CLI/MCP usano un proprio numero di righe.
max_agents100
Limite di agenti attivi per run, applicato dagli avvii tramite MCP. Le altre interfacce di avvio non lo applicano.
max_depth5
Impostazione salvata per la profondità di ricorsione. L'attuale motore dei run non la applica.
ready_delay_ms5000
Attesa perché una CLI appena avviata si stabilizzi prima di incollare un prompt.
max_lifetime_ms0
Termina gli agenti più vecchi di questo valore. 0 disattiva il limite.
default_permissionsask
Modalità dei permessi usata di default per i nuovi agenti: ask o skip.
languageen
Lingua dell'interfaccia, uno dei dieci codici di lingua.
peek_interval_ms | 5000 | Impostazione salvata per l'intervallo di polling. Le UI attuali usano intervalli di aggiornamento fissi. |
peek_lines | 10 | Impostazione salvata per il numero di righe di output. Le schermate attuali e le letture da CLI/MCP usano un proprio numero di righe. |
max_agents | 100 | Limite di agenti attivi per run, applicato dagli avvii tramite MCP. Le altre interfacce di avvio non lo applicano. |
max_depth | 5 | Impostazione salvata per la profondità di ricorsione. L'attuale motore dei run non la applica. |
ready_delay_ms | 5000 | Attesa perché una CLI appena avviata si stabilizzi prima di incollare un prompt. |
max_lifetime_ms | 0 | Termina gli agenti più vecchi di questo valore. 0 disattiva il limite. |
default_permissions | ask | Modalità dei permessi usata di default per i nuovi agenti: ask o skip. |
language | en | Lingua dell'interfaccia, uno dei dieci codici di lingua. |
Stato su disco
~/.reeves/
config.json
presets/<name>.json
runs/<run-id>/
run.json
agents/<agent-id>.json
approvals/<approval-id>.json
history/runs/<run-id>.jsonOverride da ambiente
REEVES_REGISTRYSostituisce la directory radice dello stato (di default
REEVES_CONFIGSostituisce il percorso del file di configurazione.
REEVES_NO_TMUX_WRAPPER=1Con il valore 1 disattiva l'avvolgimento automatico della TUI in una sessione tmux.
REEVES_NO_COLOR=1Con il valore 1 disattiva i colori della TUI.
ALLOW_DESTRUCTIVE=1Con il valore 1 i comandi distruttivi partono anche senza
REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1Con il valore 1 doctor salta il controllo di compatibilità dei provider.
Provider
25 CLI, ognuna con un id corto da usare in una spec di spawn. Le liste di modelli sono suggerimenti, e qualsiasi id di modello tu passi arriva dritto al provider.
Claude CodeHost MCP
Agente di programmazione di Anthropic per il terminale
id
ccbinarioclaudemodelli suggeriti fable, opus, sonnet, haiku
Codex CLIHost MCP
CLI dell’agente di programmazione di OpenAI
id
codexbinariocodexmodelli suggeriti gpt-5.6-sol, gpt-5.5, gpt-5.4-mini
OpenCode CLIHost MCP
Agente di programmazione open source per il terminale
id
opencodebinarioopencodemodelli suggeriti 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
HermesHost MCP
CLI dell’agente di Nous Research
id
hermesbinariohermesmodelli suggeriti anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini
Kimi CodeHost MCP
CLI di programmazione di Moonshot AI
id
kimibinariokimimodelli suggeriti kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed
DeepSeek CLI
CLI di programmazione di DeepSeek
id
deepseekbinariodeepseekmodelli suggeriti deepseek-v4-pro, deepseek-v4-flash
Pi
Harness di programmazione minimale per il terminale
id
pibinariopimodelli suggeriti sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o
Qwen CodeHost MCP
CLI dell’agente di programmazione di Alibaba
id
qwenbinarioqwenmodelli suggeriti qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next
Aider
Programmazione in coppia con l’IA nel terminale
id
aiderbinarioaidermodelli suggeriti sonnet, opus, haiku, deepseek/deepseek-chat
Gemini CLI
Agente da terminale open source di Google
id
geminibinariogeminimodelli suggeriti gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite
Cline CLI
CLI di agente di programmazione autonomo
id
clinebinarioclinemodelli suggeriti anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro
Crush
Agente di programmazione di Charm per il terminale
id
crushbinariocrushmodelli suggeriti si sceglie nella CLI
Goose
Agente IA open source di uso generale
id
goosebinariogoosemodelli suggeriti claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro
Kilo Code
Agente di programmazione open source con CLI
id
kilobinariokilomodelli suggeriti kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest
Letta Code
Agente di programmazione con memoria a lungo termine
id
lettabinariolettamodelli suggeriti zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct
Mistral Vibe
CLI dell’agente di programmazione di Mistral
id
vibebinariovibemodelli suggeriti si sceglie nella CLI
Grok Build
CLI dell’agente di programmazione di xAI
id
grokbinariogrokmodelli suggeriti grok-4.6, grok-4.5, grok-4.7
Kiro CLI
CLI di programmazione agentica di AWS
id
kirobinariokiro-climodelli suggeriti claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6
Factory Droid
CLI dell’agente di programmazione di Factory
id
droidbinariodroidmodelli suggeriti si sceglie nella CLI
Qoder CLI
CLI di programmazione agentica di Qoder
id
qoderbinarioqoderclimodelli suggeriti auto, performance, lite
Warp
Agente di Warp nel terminale
id
warpbinariowarpmodelli suggeriti si sceglie nella CLI
Junie CLI
CLI dell’agente di programmazione di JetBrains
id
juniebinariojuniemodelli suggeriti sonnet, opus, gpt-sol
GitHub Copilot CLI
CLI dell’agente di programmazione di GitHub
id
copilotbinariocopilotmodelli suggeriti auto, gpt-5.4, claude-opus-4.8
Cursor CLI
CLI dell’agente di programmazione di Cursor
id
cursorbinariocursor-agentmodelli suggeriti gpt-5, sonnet-4-thinking, claude-opus-4-8
Rovo Dev CLI
CLI dell’agente di programmazione di Atlassian
id
rovobinarioaclimodelli suggeriti si sceglie nella CLI
| Provider | id | binario | modelli suggeriti | Host MCP |
|---|---|---|---|---|
| Claude CodeAgente di programmazione di Anthropic per il terminale | cc | claude | fable, opus, sonnet, haiku | ✔ |
| Codex CLICLI dell’agente di programmazione di OpenAI | codex | codex | gpt-5.6-sol, gpt-5.5, gpt-5.4-mini | ✔ |
| OpenCode CLIAgente di programmazione open source per il terminale | 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 dell’agente di 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 di programmazione di Moonshot AI | kimi | kimi | kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed | ✔ |
| DeepSeek CLICLI di programmazione di DeepSeek | deepseek | deepseek | deepseek-v4-pro, deepseek-v4-flash | |
| PiHarness di programmazione minimale per il terminale | pi | pi | sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o | |
| Qwen CodeCLI dell’agente di programmazione di Alibaba | qwen | qwen | qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next | ✔ |
| AiderProgrammazione in coppia con l’IA nel terminale | aider | aider | sonnet, opus, haiku, deepseek/deepseek-chat | |
| Gemini CLIAgente da terminale open source di Google | gemini | gemini | gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite | |
| Cline CLICLI di agente di programmazione autonomo | cline | cline | anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro | |
| CrushAgente di programmazione di Charm per il terminale | crush | crush | si sceglie nella CLI | |
| GooseAgente IA open source di uso generale | goose | goose | claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro | |
| Kilo CodeAgente di programmazione open source con 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 di programmazione con memoria a lungo termine | letta | letta | zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct | |
| Mistral VibeCLI dell’agente di programmazione di Mistral | vibe | vibe | si sceglie nella CLI | |
| Grok BuildCLI dell’agente di programmazione di xAI | grok | grok | grok-4.6, grok-4.5, grok-4.7 | |
| Kiro CLICLI di programmazione agentica di AWS | kiro | kiro-cli | claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6 | |
| Factory DroidCLI dell’agente di programmazione di Factory | droid | droid | si sceglie nella CLI | |
| Qoder CLICLI di programmazione agentica di Qoder | qoder | qodercli | auto, performance, lite | |
| WarpAgente di Warp nel terminale | warp | warp | si sceglie nella CLI | |
| Junie CLICLI dell’agente di programmazione di JetBrains | junie | junie | sonnet, opus, gpt-sol | |
| GitHub Copilot CLICLI dell’agente di programmazione di GitHub | copilot | copilot | auto, gpt-5.4, claude-opus-4.8 | |
| Cursor CLICLI dell’agente di programmazione di Cursor | cursor | cursor-agent | gpt-5, sonnet-4-thinking, claude-opus-4-8 | |
| Rovo Dev CLICLI dell’agente di programmazione di Atlassian | rovo | acli | si sceglie nella CLI |
--effortimposta lo sforzo di ragionamento per Claude Code e Codex.--auth-mode api-keyvale per Claude Code.- Qualsiasi altro flag di avvio lo passi con
--extra-args, per esempio il--remote-controldi Claude Code. - Mantieni attive le richieste di autorizzazione.
--skiple disattiva negli strumenti di programmazione.
Strumenti per agenti
Quattro CLI ausiliarie che un agente può eseguire dalla propria shell. Non accettano attività di chat, quindi non sono provider avviabili. reevesagents tools le elenca con lo stato di installazione e di accesso.
Perplexity CLI
pplxRicerca web ed estratti di pagine da Perplexity, in JSON.
Google Colab CLI
colabRuntime CPU, GPU e TPU su Google Colab: esegui script e notebook da remoto.
Scarica e carica modelli e dataset, esegui job sull’Hub di Hugging Face.
Ollama
ollamaEsegui modelli locali o cloud di Ollama dal terminale.
Risoluzione dei problemi
Parti da reevesagents doctor. Di solito il problema te lo nomina lui.
Manca tmux
Installalo con brew install tmux o sudo apt install tmux, poi esegui di nuovo doctor.
Un provider non compare
Di solito la CLI manca o non ha il login. Sistema quello, poi controlla con reevesagents providers.
La Web UI segnala pacchetti mancanti
Il terminale live ha bisogno dei moduli opzionali ws e @lydell/node-pty. Per recuperarli, reinstalla globalmente con npm o pnpm.
La porta 8080 è occupata
La Web UI passa alla prima porta libera e stampa l'URL. Per sceglierne una tu, usa reevesagents web --port 8090.
Windows nativo
Il prodotto completo va eseguito in WSL. Per il solo Controllo agenti, reevesagents-win gira in modo nativo come server MCP.
Numeri verificabili
Periodo: dal 2025-04-14 al 2026-10-14. Dati GitHub e npm verificati il 2026-10-15. I download contano richieste di pacchetti.
Ultimo aggiornamento: