Documentation
Les assistants IA accomplissent des tâches de programmation. Ce guide présente les outils en ligne de commande (CLI), les menus de terminal (TUI), tmux qui maintient les tâches en cours, et une connexion standard entre outils IA (MCP).
Installation
Il vous faut macOS, Linux ou WSL, Node 22.12 ou plus récent, tmux 3.0 ou plus récent, et au moins une CLI de fournisseur installée et connectée.
$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagentsreevesagents doctor vérifie tout cela. reevesagents setup lance les mêmes vérifications sous forme d'assistant de premier démarrage, et avec --attach il connecte aussi le MCP à chaque hôte installé.Démarrage rapide
Lancez une équipe, suivez-la, intervenez, puis arrêtez-la.
Lancer une équipe
reevesagents spawn cc:lead codex:api kimi:docs \
--name "feature x" --prompt "Build feature X. The lead splits the work."Chaque assistant s'écrit provider[:nickname[:model]], et le premier mène l'équipe. reevesagents add ajoute des assistants au dernier run.
Observer et diriger
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open apisend colle le texte sans le soumettre : faites-le suivre de key <agent> enter. open vous amène à l'assistant dans tmux.
Arrêter
reevesagents stop "feature x" --yesstop, kill et les commandes delete attendent --yes (ou ALLOW_DESTRUCTIVE=1).Menu du terminal, navigateur et commandes
Le menu (TUI), l’interface du navigateur et l’outil en ligne de commande (CLI) partagent les tâches enregistrées sous ~/.reeves. L’outil de terminal tmux maintient les assistants en marche.
- Tapez
reevesagentssans argument pour ouvrir la TUI. Elle s'enveloppe dans une session tmux nomméereeves, ce queREEVES_NO_TMUX_WRAPPER=1désactive. reevesagents webdémarre la Web UI sur127.0.0.1, port 8080 ou le premier port libre suivant. Elle refuse les en-têtes Host hors loopback et les écritures cross-origin, et Ctrl+C l'arrête sans toucher à vos assistants.- Tout existe aussi en commande CLI. Les scripts doivent lire
--json, car la sortie texte peut changer d'une version à l'autre. - En dessous tourne tmux, avec une session par run et une fenêtre par assistant. D'où que vous soyez,
reevesagents open <id>vous amène à la bonne fenêtre.
Contrôle des agents (MCP)
Reliez un outil de programmation aux autres par un protocole standard (MCP). Cette connexion est facultative. Redémarrez l’outil après l’avoir établie.
reevesagents attach cc
reevesagents hosts- Six CLI peuvent l'héberger : Claude Code, Codex, Kimi Code, Qwen Code, Hermes et OpenCode.
reevesagents attachsans nom l'attache à toutes celles qui sont installées, etreevesagents detach <cli>le retire. - L'hôte reçoit des outils simples pour lancer des assistants, coller du texte, envoyer des touches, lire la sortie et traiter les approbations. Ce que fait l'équipe dépend de la personne qui donne les consignes à l'hôte.
- Les workers lancés reçoivent ces outils uniquement si vous attachez aussi leur CLI. Les lancements via MCP respectent
max_agents(100 par défaut) comme limite d'assistants par run.
Commandes
Toutes les sous-commandes de reevesagents. Sans argument, la commande ouvre la TUI.
Runs
spawn [spec...]Démarre un run. Chaque spec s'écrit provider[:nickname[:model]], et le premier agent mène l'équipe. Flags :
add [spec...]Ajoute des agents au run actif le plus récent. Flags :
runsListe les runs actifs.
open <id>Vous amène à la fenêtre d'un run ou d'un agent dans tmux. Accepte un id, un nom, un surnom ou un préfixe unique.
peek <agent-id>Affiche la sortie récente d'un agent.
stop <run-id>exige Arrête un run et ferme sa session tmux.
kill <agent-id>exige Arrête un agent. Le run se termine avec son dernier agent actif.
Piloter un assistant
send <agent-id> <text...>Colle du texte dans le prompt de l'agent, sans le soumettre.
key <agent-id> <key>Envoie une touche autorisée : enter, escape, backspace, tab, space, up, down, left, right,
interrupt <agent-id>Envoie
Enregistrements et historique
agents [run-id]Liste les agents des runs actifs ou d'un run donné.
providersListe les fournisseurs avec leur disponibilité et leurs modèles connus.
toolsListe les outils de l'agent avec leur état d'installation et de connexion.
delete <agent-id>exige Supprime l'enregistrement d'un agent terminé.
delete-run <run-id>exige Supprime un run terminé.
historyListe l'historique des runs archivés.
delete-history <id>exige Supprime un enregistrement de l'historique.
Approbations
approvalsListe les approbations en attente.
approve <approval-id> [note]Approuve une demande en attente.
deny <approval-id> [note]Refuse une demande en attente.
Hôtes MCP
hostsListe les CLI hôtes compatibles MCP et indique lesquelles sont attachées.
attach [cli]Attache le MCP à une CLI hôte, ou à tous les hôtes installés, via la CLI ou le fichier de config de chaque hôte.
detach <cli>Détache le MCP d'une CLI hôte, via sa CLI ou son fichier de config.
mcpDémarre le serveur MCP du Contrôle des agents sur stdio. C'est la CLI hôte qui lance cette commande.
Config et presets
config [key] [value]Affiche, lit ou définit un champ de config modifiable.
presetsListe les presets enregistrés.
save-preset <run-id> <name> [description...]Enregistre un run en cours dans un preset.
start-preset <name>Démarre un run à partir d'un preset.
delete-preset <name>exige Supprime un preset.
Installation et outils
setupVérification de premier démarrage pour tmux, Node et les CLI installées.
doctorEffectue le bilan de santé de l'environnement. Code de sortie non nul en cas d'échec.
skills [action]Installe, retire ou vérifie le skill ReevesAgents pour les CLI qui gèrent les skills (install, remove, status ; status par défaut).
reapMet fin aux agents dont la fenêtre a disparu ou qui ont dépassé max_lifetime_ms, et ferme les sessions tmux orphelines.
webDémarre au premier plan la Web UI, accessible en loopback uniquement.
Outils MCP
Les 31 outils qu'une CLI attachée peut appeler, regroupés par usage.
Lancer et piloter
spawnrequisprovideroptionnelrun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_argsLance un worker. Sans run_id, réutilise le run de cette session MCP, créé au premier lancement de la session ; avec run_id, cible un autre run.
killrequisagent_idArrête un agent.
stoprequisrun_idArrête tout un run et ferme sa session tmux.
send_textrequisagent_idtextColle du texte dans le prompt d'un agent, sans le soumettre.
send_keyrequisagent_idkeyEnvoie une touche autorisée (enter, escape,
interruptrequisagent_idEnvoie
readrequisagent_idoptionnellinesLit la sortie récente du panneau, sans séquences ANSI et avec les secrets masqués. Par défaut : 20 lignes.
Inspecter
listListe les runs et les agents.
list_providersCatalogue des fournisseurs et des modèles de cette machine.
list_toolsCatalogue d'outils de cette machine : CLI auxiliaires qu'un agent peut exécuter depuis son shell, avec leur état d'installation et de connexion.
list_historyRuns archivés.
list_presetsPresets enregistrés.
list_hostsCLI compatibles MCP, et lesquelles sont attachées.
get_configConfig globale actuelle.
doctorBilan de santé de l'environnement.
Approbations
request_approvalrequisagent_idactionsummaryoptionneldetailsriskCrée une demande d'approbation.
resolve_approvalrequisapproval_iddecisionoptionnelnoteApprouve ou refuse une demande en attente.
check_approvalrequisapproval_idLit une approbation.
list_approvalsoptionnelrun_idstatusListe les approbations, filtrables.
Cycle de vie
deleterequisagent_idSupprime l'enregistrement d'un agent terminé.
delete_runrequisrun_idSupprime un run terminé.
delete_historyrequisidSupprime un enregistrement de l'historique.
openrequisidBascule le client tmux attaché vers un run ou un agent.
reapNettoie immédiatement les agents dont la fenêtre a disparu ou la durée de vie est dépassée, ainsi que les sessions tmux orphelines.
Config et presets
set_configoptionnelpeek_interval_mspeek_linesmax_depthmax_agentsready_delay_msmax_lifetime_msdefault_permissionslanguageDéfinit un ou plusieurs champs de config modifiables.
save_presetrequisrun_idnameoptionneldescriptionEnregistre un run en cours comme preset.
start_presetrequisnameoptionnelrun_nameworking_dirDémarre un run à partir d'un preset.
delete_presetrequisnameSupprime un preset.
Hôtes et skills
attach_hostoptionnelkeyAttache le MCP à une CLI hôte, ou à toutes.
detach_hostrequiskeyDétache le MCP d'une CLI hôte.
install_skillsoptionnelstatusInstalle le skill ReevesAgents pour les CLI qui gèrent les skills, ou indique où il se trouve.
reevesagents://providers, reevesagents://guideConfiguration
Les réglages se trouvent dans ~/.reeves/config.json. Modifiez-en un avec reevesagents config <key> <value> ou depuis les écrans de réglages. reevesagents config language tr bascule l'interface dans l'une de ses dix langues.
Champs
peek_interval_ms5000
Réglage enregistré de l'intervalle d'interrogation. Les interfaces actuelles utilisent des intervalles d'actualisation fixes.
peek_lines10
Réglage enregistré du nombre de lignes de sortie. Les écrans actuels et les lectures CLI/MCP utilisent leurs propres nombres de lignes.
max_agents100
Limite d'agents actifs par run, appliquée par les lancements via MCP. Les autres surfaces de lancement ne l'appliquent pas.
max_depth5
Réglage enregistré de la profondeur de récursion. Le moteur de run actuel ne l'applique pas.
ready_delay_ms5000
Délai laissé à une CLI fraîchement lancée pour se stabiliser avant de coller un prompt.
max_lifetime_ms0
Met fin aux agents plus anciens que cette valeur. 0 désactive la limite.
default_permissionsask
Mode de permission par défaut pour les nouveaux agents : ask ou skip.
languageen
Langue de l'interface : l'un des dix codes de langue.
peek_interval_ms | 5000 | Réglage enregistré de l'intervalle d'interrogation. Les interfaces actuelles utilisent des intervalles d'actualisation fixes. |
peek_lines | 10 | Réglage enregistré du nombre de lignes de sortie. Les écrans actuels et les lectures CLI/MCP utilisent leurs propres nombres de lignes. |
max_agents | 100 | Limite d'agents actifs par run, appliquée par les lancements via MCP. Les autres surfaces de lancement ne l'appliquent pas. |
max_depth | 5 | Réglage enregistré de la profondeur de récursion. Le moteur de run actuel ne l'applique pas. |
ready_delay_ms | 5000 | Délai laissé à une CLI fraîchement lancée pour se stabiliser avant de coller un prompt. |
max_lifetime_ms | 0 | Met fin aux agents plus anciens que cette valeur. 0 désactive la limite. |
default_permissions | ask | Mode de permission par défaut pour les nouveaux agents : ask ou skip. |
language | en | Langue de l'interface : l'un des dix codes de langue. |
État sur le disque
~/.reeves/
config.json
presets/<name>.json
runs/<run-id>/
run.json
agents/<agent-id>.json
approvals/<approval-id>.json
history/runs/<run-id>.jsonSurcharges par variables d'environnement
REEVES_REGISTRYSurcharge le répertoire racine de l'état (
REEVES_CONFIGSurcharge le chemin du fichier de config.
REEVES_NO_TMUX_WRAPPER=1Avec la valeur 1, désactive l'enveloppement automatique de la TUI dans une session tmux.
REEVES_NO_COLOR=1Avec la valeur 1, désactive les couleurs de la TUI.
ALLOW_DESTRUCTIVE=1Avec la valeur 1, autorise les commandes destructives sans
REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1Avec la valeur 1, doctor saute la vérification de compatibilité des fournisseurs.
Fournisseurs
25 CLI, chacune avec un id court à utiliser dans une spec de spawn. Les listes de modèles sont des suggestions : tout id de modèle que vous passez est transmis tel quel au fournisseur.
Claude CodeHôte MCP
Agent de programmation d’Anthropic pour le terminal
id
ccbinaireclaudemodèles suggérés fable, opus, sonnet, haiku
Codex CLIHôte MCP
Agent de programmation en CLI d’OpenAI
id
codexbinairecodexmodèles suggérés gpt-5.6-sol, gpt-5.5, gpt-5.4-mini
OpenCode CLIHôte MCP
Agent de programmation open source pour le terminal
id
opencodebinaireopencodemodèles suggérés 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
HermesHôte MCP
Agent en CLI de Nous Research
id
hermesbinairehermesmodèles suggérés anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini
Kimi CodeHôte MCP
CLI de programmation de Moonshot AI
id
kimibinairekimimodèles suggérés kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed
DeepSeek CLI
CLI de programmation de DeepSeek
id
deepseekbinairedeepseekmodèles suggérés deepseek-v4-pro, deepseek-v4-flash
Pi
Harnais de programmation minimal pour le terminal
id
pibinairepimodèles suggérés sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o
Qwen CodeHôte MCP
Agent de programmation en CLI d’Alibaba
id
qwenbinaireqwenmodèles suggérés qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next
Aider
Programmation en binôme avec l’IA dans le terminal
id
aiderbinaireaidermodèles suggérés sonnet, opus, haiku, deepseek/deepseek-chat
Gemini CLI
Agent de terminal open source de Google
id
geminibinairegeminimodèles suggérés gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite
Cline CLI
Agent de programmation autonome en CLI
id
clinebinaireclinemodèles suggérés anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro
Crush
Agent de programmation de Charm pour le terminal
id
crushbinairecrushmodèles suggérés se choisit dans la CLI
Goose
Agent IA généraliste open source
id
goosebinairegoosemodèles suggérés claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro
Kilo Code
Agent de programmation open source avec CLI
id
kilobinairekilomodèles suggérés kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest
Letta Code
Agent de programmation doté d’une mémoire à long terme
id
lettabinairelettamodèles suggérés zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct
Mistral Vibe
Agent de programmation en CLI de Mistral
id
vibebinairevibemodèles suggérés se choisit dans la CLI
Grok Build
Agent de programmation en CLI de xAI
id
grokbinairegrokmodèles suggérés grok-4.6, grok-4.5, grok-4.7
Kiro CLI
CLI de programmation agentique d’AWS
id
kirobinairekiro-climodèles suggérés claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6
Factory Droid
Agent de programmation en CLI de Factory
id
droidbinairedroidmodèles suggérés se choisit dans la CLI
Qoder CLI
CLI de programmation agentique de Qoder
id
qoderbinaireqoderclimodèles suggérés auto, performance, lite
Warp
Agent de Warp dans le terminal
id
warpbinairewarpmodèles suggérés se choisit dans la CLI
Junie CLI
Agent de programmation en CLI de JetBrains
id
juniebinairejuniemodèles suggérés sonnet, opus, gpt-sol
GitHub Copilot CLI
Agent de programmation en CLI de GitHub
id
copilotbinairecopilotmodèles suggérés auto, gpt-5.4, claude-opus-4.8
Cursor CLI
Agent de programmation en CLI de Cursor
id
cursorbinairecursor-agentmodèles suggérés gpt-5, sonnet-4-thinking, claude-opus-4-8
Rovo Dev CLI
Agent de programmation en CLI d’Atlassian
id
rovobinaireaclimodèles suggérés se choisit dans la CLI
| Fournisseur | id | binaire | modèles suggérés | Hôte MCP |
|---|---|---|---|---|
| Claude CodeAgent de programmation d’Anthropic pour le terminal | cc | claude | fable, opus, sonnet, haiku | ✔ |
| Codex CLIAgent de programmation en CLI d’OpenAI | codex | codex | gpt-5.6-sol, gpt-5.5, gpt-5.4-mini | ✔ |
| OpenCode CLIAgent de programmation open source pour le 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 | ✔ |
| HermesAgent en CLI de 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 programmation de Moonshot AI | kimi | kimi | kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed | ✔ |
| DeepSeek CLICLI de programmation de DeepSeek | deepseek | deepseek | deepseek-v4-pro, deepseek-v4-flash | |
| PiHarnais de programmation minimal pour le terminal | pi | pi | sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o | |
| Qwen CodeAgent de programmation en CLI d’Alibaba | qwen | qwen | qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next | ✔ |
| AiderProgrammation en binôme avec l’IA dans le terminal | aider | aider | sonnet, opus, haiku, deepseek/deepseek-chat | |
| Gemini CLIAgent de terminal open source de Google | gemini | gemini | gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite | |
| Cline CLIAgent de programmation autonome en CLI | cline | cline | anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro | |
| CrushAgent de programmation de Charm pour le terminal | crush | crush | se choisit dans la CLI | |
| GooseAgent IA généraliste open source | goose | goose | claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro | |
| Kilo CodeAgent de programmation open source avec CLI | kilo | kilo | kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest | |
| Letta CodeAgent de programmation doté d’une mémoire à long terme | letta | letta | zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct | |
| Mistral VibeAgent de programmation en CLI de Mistral | vibe | vibe | se choisit dans la CLI | |
| Grok BuildAgent de programmation en CLI de xAI | grok | grok | grok-4.6, grok-4.5, grok-4.7 | |
| Kiro CLICLI de programmation agentique d’AWS | kiro | kiro-cli | claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6 | |
| Factory DroidAgent de programmation en CLI de Factory | droid | droid | se choisit dans la CLI | |
| Qoder CLICLI de programmation agentique de Qoder | qoder | qodercli | auto, performance, lite | |
| WarpAgent de Warp dans le terminal | warp | warp | se choisit dans la CLI | |
| Junie CLIAgent de programmation en CLI de JetBrains | junie | junie | sonnet, opus, gpt-sol | |
| GitHub Copilot CLIAgent de programmation en CLI de GitHub | copilot | copilot | auto, gpt-5.4, claude-opus-4.8 | |
| Cursor CLIAgent de programmation en CLI de Cursor | cursor | cursor-agent | gpt-5, sonnet-4-thinking, claude-opus-4-8 | |
| Rovo Dev CLIAgent de programmation en CLI d’Atlassian | rovo | acli | se choisit dans la CLI |
--effortrègle l'effort de raisonnement pour Claude Code et Codex.--auth-mode api-keys'applique à Claude Code.- Passez tout autre flag de lancement avec
--extra-args, par exemple le--remote-controlde Claude Code. - Gardez les demandes d’autorisation activées.
--skiples désactive dans les outils de programmation.
Outils pour agents
Quatre CLI d’appoint qu’un agent peut lancer depuis son propre shell. Elles n’acceptent pas de tâche de chat et ne peuvent donc pas être lancées comme fournisseurs. reevesagents tools les liste avec leur état d’installation et de connexion.
Perplexity CLI
pplxRecherche web et extraits de pages avec Perplexity, au format JSON.
Google Colab CLI
colabEnvironnements CPU, GPU et TPU sur Google Colab : exécuter des scripts et des notebooks à distance.
Télécharger et publier des modèles et des jeux de données, lancer des jobs sur le Hub Hugging Face.
Ollama
ollamaExécuter des modèles locaux ou des modèles cloud Ollama depuis le terminal.
Dépannage
Commencez par reevesagents doctor. En général, il nomme le problème.
tmux est absent
Installez-le avec brew install tmux ou sudo apt install tmux, puis relancez doctor.
Un fournisseur n'apparaît pas
Le plus souvent, la CLI n'est pas installée ou pas connectée. Corrigez cela, puis vérifiez avec reevesagents providers.
La Web UI signale des paquets manquants
Le terminal en direct a besoin des modules optionnels ws et @lydell/node-pty. Réinstallez en global avec npm ou pnpm pour les récupérer.
Le port 8080 est déjà pris
La Web UI passe au port libre suivant et affiche l'URL. Pour en choisir un vous-même : reevesagents web --port 8090.
Windows natif
Lancez le produit complet dans WSL. Pour le seul Contrôle des agents, reevesagents-win tourne nativement comme serveur MCP.
Des chiffres vérifiables
Période : du 2025-04-14 au 2026-10-14. Chiffres GitHub et npm vérifiés le 2026-10-15. Les téléchargements comptent des récupérations de paquets.
Dernière mise à jour: