Salta al contenuto
Gratuito e open source

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

shell
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

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

send incolla il testo senza inviarlo, quindi fallo seguire da key <agent> enter. open ti porta all'assistente in tmux.

Ferma

shell
reevesagents stop "feature x" --yes
stop, 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 reevesagents senza argomenti per aprire la TUI. Si avvolge da sola in una sessione tmux chiamata reeves, e REEVES_NO_TMUX_WRAPPER=1 disattiva questo comportamento.
  • reevesagents web avvia la Web UI su 127.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.

shell
reevesagents attach cc
reevesagents hosts
  • Sei CLI possono ospitarlo: Claude Code, Codex, Kimi Code, Qwen Code, Hermes e OpenCode. reevesagents attach senza nome lo collega a tutte quelle installate, e reevesagents 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: --name, --cwd, --prompt, --skip, --run, --auth-mode, --effort, --extra-args, --json.

add [spec...]

Aggiunge agenti al run attivo più recente. Flag: --run, --prompt, --skip, --auth-mode, --effort, --extra-args, --json. Serve almeno una spec.

runs

Elenca i run attivi. --json.

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

stop <run-id>richiede --yes

Ferma un run e chiude la sua sessione tmux. -y/--yes.

kill <agent-id>richiede --yes

Ferma un agente. Il run termina con il suo ultimo agente attivo. -y/--yes.

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

interrupt <agent-id>

Invia ctrl-c.

Record e cronologia

agents [run-id]

Elenca gli agenti dei run attivi o di un run specifico. --json.

providers

Elenca i provider con disponibilità e modelli noti. --models, --json.

tools

Elenca gli strumenti dell'agente con lo stato di installazione e di accesso. --json.

delete <agent-id>richiede --yes

Elimina il record di un agente terminato. -y/--yes.

delete-run <run-id>richiede --yes

Elimina un run terminato. -y/--yes.

history

Elenca la cronologia dei run archiviati. --json.

delete-history <id>richiede --yes

Elimina un record della cronologia. -y/--yes.

Approvazioni

approvals

Elenca le approvazioni in sospeso. --json.

approve <approval-id> [note]

Approva una richiesta in sospeso.

deny <approval-id> [note]

Rifiuta una richiesta in sospeso.

Host MCP

hosts

Elenca le CLI host compatibili con MCP e mostra quali sono collegate. --json.

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. --force sovrascrive una registrazione esistente.

detach <cli>

Scollega l'MCP da una CLI host tramite la sua CLI o il suo file di configurazione.

mcp

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

presets

Elenca i preset salvati. --json.

save-preset <run-id> <name> [description...]

Salva un run attivo come preset.

start-preset <name>

Avvia un run da un preset. --name, --cwd.

delete-preset <name>richiede --yes

Elimina un preset. -y/--yes.

Setup e strumenti

setup

Controllo di primo avvio per tmux, Node e le CLI installate. --attach collega l'MCP a ogni host installato. --json restituisce lo stato del setup.

doctor

Esegue i controlli di salute dell'ambiente. In caso di errore esce con un codice diverso da zero. --json.

skills [action]

Installa, rimuove o controlla la skill di ReevesAgents per le CLI che supportano le skill (install, remove, status; di default status). --json.

reap

Termina gli agenti la cui finestra è scomparsa o che hanno superato max_lifetime_ms, e chiude le sessioni tmux orfane. --json.

web

Avvia in primo piano la Web UI, in ascolto solo su loopback. --port, --no-open.

Strumenti MCP

I 31 strumenti che una CLI collegata può chiamare, raggruppati per scopo.

Avvio e guida

spawnobbligatorioprovideropzionalerun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_args

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

Ferma un agente.

stopobbligatoriorun_id

Ferma un intero run e chiude la sua sessione tmux.

send_textobbligatorioagent_idtext

Incolla il testo nel prompt di un agente senza inviarlo.

send_keyobbligatorioagent_idkey

Invia un tasto consentito (enter, escape, ctrl-c, …).

interruptobbligatorioagent_id

Invia ctrl-c a un agente.

readobbligatorioagent_idopzionalelines

Legge l'output recente del pannello, senza sequenze ANSI e con i segreti oscurati. Di default 20 righe.

Ispezione

list

Elenca i run e gli agenti.

list_providers

Catalogo dei provider e dei modelli di questa macchina.

list_tools

Catalogo degli strumenti di questa macchina: CLI ausiliarie che un agente può eseguire dalla sua shell, con stato di installazione e di accesso.

list_history

Run archiviati.

list_presets

Preset salvati.

list_hosts

CLI compatibili con MCP e quali sono collegate.

get_config

Configurazione globale attuale.

doctor

Controlli di salute dell'ambiente.

Approvazioni

request_approvalobbligatorioagent_idactionsummaryopzionaledetailsrisk

Crea una richiesta di approvazione.

resolve_approvalobbligatorioapproval_iddecisionopzionalenote

Approva o rifiuta una richiesta in sospeso.

check_approvalobbligatorioapproval_id

Legge un'approvazione.

list_approvalsopzionalerun_idstatus

Elenca le approvazioni, con filtri opzionali.

Ciclo di vita

deleteobbligatorioagent_id

Elimina il record di un agente terminato.

delete_runobbligatoriorun_id

Elimina un run terminato.

delete_historyobbligatorioid

Elimina un record della cronologia.

openobbligatorioid

Sposta il client tmux collegato su un run o su un agente.

reap

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

Imposta uno o più campi modificabili della configurazione.

save_presetobbligatoriorun_idnameopzionaledescription

Salva un run attivo come preset.

start_presetobbligatorionameopzionalerun_nameworking_dir

Avvia un run da un preset.

delete_presetobbligatorioname

Elimina un preset.

Host e skill

attach_hostopzionalekey

Collega l'MCP a una CLI host o a tutte.

detach_hostobbligatoriokey

Scollega l'MCP da una CLI host.

install_skillsopzionalestatus

Installa la skill di ReevesAgents per le CLI che supportano le skill, o indica dove si trova.

Due risorse contengono il catalogo dei provider e una guida all'uso: reevesagents://providers, reevesagents://guide

Configurazione

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.

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

Override da ambiente

REEVES_REGISTRY

Sostituisce la directory radice dello stato (di default ~/.reeves).

REEVES_CONFIG

Sostituisce il percorso del file di configurazione.

REEVES_NO_TMUX_WRAPPER=1

Con il valore 1 disattiva l'avvolgimento automatico della TUI in una sessione tmux.

REEVES_NO_COLOR=1

Con il valore 1 disattiva i colori della TUI.

ALLOW_DESTRUCTIVE=1

Con il valore 1 i comandi distruttivi partono anche senza --yes.

REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1

Con 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 ccbinario claude

    modelli suggeriti fable, opus, sonnet, haiku

  • Codex CLIHost MCP

    CLI dell’agente di programmazione di OpenAI

    id codexbinario codex

    modelli suggeriti gpt-5.6-sol, gpt-5.5, gpt-5.4-mini

  • OpenCode CLIHost MCP

    Agente di programmazione open source per il terminale

    id opencodebinario opencode

    modelli 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 hermesbinario hermes

    modelli 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 kimibinario kimi

    modelli suggeriti kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed

  • DeepSeek CLI

    CLI di programmazione di DeepSeek

    id deepseekbinario deepseek

    modelli suggeriti deepseek-v4-pro, deepseek-v4-flash

  • Pi

    Harness di programmazione minimale per il terminale

    id pibinario pi

    modelli suggeriti sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o

  • Qwen CodeHost MCP

    CLI dell’agente di programmazione di Alibaba

    id qwenbinario qwen

    modelli suggeriti qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next

  • Aider

    Programmazione in coppia con l’IA nel terminale

    id aiderbinario aider

    modelli suggeriti sonnet, opus, haiku, deepseek/deepseek-chat

  • Gemini CLI

    Agente da terminale open source di Google

    id geminibinario gemini

    modelli suggeriti gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite

  • Cline CLI

    CLI di agente di programmazione autonomo

    id clinebinario cline

    modelli 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 crushbinario crush

    modelli suggeriti si sceglie nella CLI

  • Goose

    Agente IA open source di uso generale

    id goosebinario goose

    modelli suggeriti claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro

  • Kilo Code

    Agente di programmazione open source con CLI

    id kilobinario kilo

    modelli 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 lettabinario letta

    modelli 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 vibebinario vibe

    modelli suggeriti si sceglie nella CLI

  • Grok Build

    CLI dell’agente di programmazione di xAI

    id grokbinario grok

    modelli suggeriti grok-4.6, grok-4.5, grok-4.7

  • Kiro CLI

    CLI di programmazione agentica di AWS

    id kirobinario kiro-cli

    modelli suggeriti claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6

  • Factory Droid

    CLI dell’agente di programmazione di Factory

    id droidbinario droid

    modelli suggeriti si sceglie nella CLI

  • Qoder CLI

    CLI di programmazione agentica di Qoder

    id qoderbinario qodercli

    modelli suggeriti auto, performance, lite

  • Warp

    Agente di Warp nel terminale

    id warpbinario warp

    modelli suggeriti si sceglie nella CLI

  • Junie CLI

    CLI dell’agente di programmazione di JetBrains

    id juniebinario junie

    modelli suggeriti sonnet, opus, gpt-sol

  • GitHub Copilot CLI

    CLI dell’agente di programmazione di GitHub

    id copilotbinario copilot

    modelli suggeriti auto, gpt-5.4, claude-opus-4.8

  • Cursor CLI

    CLI dell’agente di programmazione di Cursor

    id cursorbinario cursor-agent

    modelli suggeriti gpt-5, sonnet-4-thinking, claude-opus-4-8

  • Rovo Dev CLI

    CLI dell’agente di programmazione di Atlassian

    id rovobinario acli

    modelli suggeriti si sceglie nella CLI

  • --effort imposta lo sforzo di ragionamento per Claude Code e Codex. --auth-mode api-key vale per Claude Code.
  • Qualsiasi altro flag di avvio lo passi con --extra-args, per esempio il --remote-control di Claude Code.
  • Mantieni attive le richieste di autorizzazione. --skip le 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 CLIpplx

    Ricerca web ed estratti di pagine da Perplexity, in JSON.

  • Google Colab CLIcolab

    Runtime CPU, GPU e TPU su Google Colab: esegui script e notebook da remoto.

  • Hugging Face CLIhf

    Scarica e carica modelli e dataset, esegui job sull’Hub di Hugging Face.

  • Ollamaollama

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