Aller au contenu
Libre et open source

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

shell
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

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

send colle le texte sans le soumettre : faites-le suivre de key <agent> enter. open vous amène à l'assistant dans tmux.

Arrêter

shell
reevesagents stop "feature x" --yes
stop, 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 reevesagents sans argument pour ouvrir la TUI. Elle s'enveloppe dans une session tmux nommée reeves, ce que REEVES_NO_TMUX_WRAPPER=1 désactive.
  • reevesagents web démarre la Web UI sur 127.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.

shell
reevesagents attach cc
reevesagents hosts
  • Six CLI peuvent l'héberger : Claude Code, Codex, Kimi Code, Qwen Code, Hermes et OpenCode. reevesagents attach sans nom l'attache à toutes celles qui sont installées, et reevesagents 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 : --name, --cwd, --prompt, --skip, --run, --auth-mode, --effort, --extra-args, --json.

add [spec...]

Ajoute des agents au run actif le plus récent. Flags : --run, --prompt, --skip, --auth-mode, --effort, --extra-args, --json. Au moins une spec est requise.

runs

Liste les runs actifs. --json.

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. -n/--lines (20 par défaut), --json.

stop <run-id>exige --yes

Arrête un run et ferme sa session tmux. -y/--yes.

kill <agent-id>exige --yes

Arrête un agent. Le run se termine avec son dernier agent actif. -y/--yes.

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

interrupt <agent-id>

Envoie ctrl-c.

Enregistrements et historique

agents [run-id]

Liste les agents des runs actifs ou d'un run donné. --json.

providers

Liste les fournisseurs avec leur disponibilité et leurs modèles connus. --models, --json.

tools

Liste les outils de l'agent avec leur état d'installation et de connexion. --json.

delete <agent-id>exige --yes

Supprime l'enregistrement d'un agent terminé. -y/--yes.

delete-run <run-id>exige --yes

Supprime un run terminé. -y/--yes.

history

Liste l'historique des runs archivés. --json.

delete-history <id>exige --yes

Supprime un enregistrement de l'historique. -y/--yes.

Approbations

approvals

Liste les approbations en attente. --json.

approve <approval-id> [note]

Approuve une demande en attente.

deny <approval-id> [note]

Refuse une demande en attente.

Hôtes MCP

hosts

Liste les CLI hôtes compatibles MCP et indique lesquelles sont attachées. --json.

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. --force réécrit un enregistrement existant.

detach <cli>

Détache le MCP d'une CLI hôte, via sa CLI ou son fichier de config.

mcp

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

presets

Liste les presets enregistrés. --json.

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

delete-preset <name>exige --yes

Supprime un preset. -y/--yes.

Installation et outils

setup

Vérification de premier démarrage pour tmux, Node et les CLI installées. --attach connecte chaque hôte installé. --json renvoie l'état de la mise en route.

doctor

Effectue le bilan de santé de l'environnement. Code de sortie non nul en cas d'échec. --json.

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

reap

Met fin aux agents dont la fenêtre a disparu ou qui ont dépassé max_lifetime_ms, et ferme les sessions tmux orphelines. --json.

web

Démarre au premier plan la Web UI, accessible en loopback uniquement. --port, --no-open.

Outils MCP

Les 31 outils qu'une CLI attachée peut appeler, regroupés par usage.

Lancer et piloter

spawnrequisprovideroptionnelrun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_args

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

Arrête un agent.

stoprequisrun_id

Arrête tout un run et ferme sa session tmux.

send_textrequisagent_idtext

Colle du texte dans le prompt d'un agent, sans le soumettre.

send_keyrequisagent_idkey

Envoie une touche autorisée (enter, escape, ctrl-c, …).

interruptrequisagent_id

Envoie ctrl-c à un agent.

readrequisagent_idoptionnellines

Lit la sortie récente du panneau, sans séquences ANSI et avec les secrets masqués. Par défaut : 20 lignes.

Inspecter

list

Liste les runs et les agents.

list_providers

Catalogue des fournisseurs et des modèles de cette machine.

list_tools

Catalogue 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_history

Runs archivés.

list_presets

Presets enregistrés.

list_hosts

CLI compatibles MCP, et lesquelles sont attachées.

get_config

Config globale actuelle.

doctor

Bilan de santé de l'environnement.

Approbations

request_approvalrequisagent_idactionsummaryoptionneldetailsrisk

Crée une demande d'approbation.

resolve_approvalrequisapproval_iddecisionoptionnelnote

Approuve ou refuse une demande en attente.

check_approvalrequisapproval_id

Lit une approbation.

list_approvalsoptionnelrun_idstatus

Liste les approbations, filtrables.

Cycle de vie

deleterequisagent_id

Supprime l'enregistrement d'un agent terminé.

delete_runrequisrun_id

Supprime un run terminé.

delete_historyrequisid

Supprime un enregistrement de l'historique.

openrequisid

Bascule le client tmux attaché vers un run ou un agent.

reap

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

Définit un ou plusieurs champs de config modifiables.

save_presetrequisrun_idnameoptionneldescription

Enregistre un run en cours comme preset.

start_presetrequisnameoptionnelrun_nameworking_dir

Démarre un run à partir d'un preset.

delete_presetrequisname

Supprime un preset.

Hôtes et skills

attach_hostoptionnelkey

Attache le MCP à une CLI hôte, ou à toutes.

detach_hostrequiskey

Détache le MCP d'une CLI hôte.

install_skillsoptionnelstatus

Installe le skill ReevesAgents pour les CLI qui gèrent les skills, ou indique où il se trouve.

Deux ressources exposent le catalogue des fournisseurs et un guide d'utilisation : reevesagents://providers, reevesagents://guide

Configuration

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.

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

Surcharges par variables d'environnement

REEVES_REGISTRY

Surcharge le répertoire racine de l'état (~/.reeves par défaut).

REEVES_CONFIG

Surcharge le chemin du fichier de config.

REEVES_NO_TMUX_WRAPPER=1

Avec la valeur 1, désactive l'enveloppement automatique de la TUI dans une session tmux.

REEVES_NO_COLOR=1

Avec la valeur 1, désactive les couleurs de la TUI.

ALLOW_DESTRUCTIVE=1

Avec la valeur 1, autorise les commandes destructives sans --yes.

REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1

Avec 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 ccbinaire claude

    modèles suggérés fable, opus, sonnet, haiku

  • Codex CLIHôte MCP

    Agent de programmation en CLI d’OpenAI

    id codexbinaire codex

    modè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 opencodebinaire opencode

    modè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 hermesbinaire hermes

    modè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 kimibinaire kimi

    modè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 deepseekbinaire deepseek

    modèles suggérés deepseek-v4-pro, deepseek-v4-flash

  • Pi

    Harnais de programmation minimal pour le terminal

    id pibinaire pi

    modèles suggérés sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o

  • Qwen CodeHôte MCP

    Agent de programmation en CLI d’Alibaba

    id qwenbinaire qwen

    modè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 aiderbinaire aider

    modèles suggérés sonnet, opus, haiku, deepseek/deepseek-chat

  • Gemini CLI

    Agent de terminal open source de Google

    id geminibinaire gemini

    modè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 clinebinaire cline

    modè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 crushbinaire crush

    modèles suggérés se choisit dans la CLI

  • Goose

    Agent IA généraliste open source

    id goosebinaire goose

    modè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 kilobinaire kilo

    modè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 lettabinaire letta

    modè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 vibebinaire vibe

    modèles suggérés se choisit dans la CLI

  • Grok Build

    Agent de programmation en CLI de xAI

    id grokbinaire grok

    modèles suggérés grok-4.6, grok-4.5, grok-4.7

  • Kiro CLI

    CLI de programmation agentique d’AWS

    id kirobinaire kiro-cli

    modè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 droidbinaire droid

    modèles suggérés se choisit dans la CLI

  • Qoder CLI

    CLI de programmation agentique de Qoder

    id qoderbinaire qodercli

    modèles suggérés auto, performance, lite

  • Warp

    Agent de Warp dans le terminal

    id warpbinaire warp

    modèles suggérés se choisit dans la CLI

  • Junie CLI

    Agent de programmation en CLI de JetBrains

    id juniebinaire junie

    modèles suggérés sonnet, opus, gpt-sol

  • GitHub Copilot CLI

    Agent de programmation en CLI de GitHub

    id copilotbinaire copilot

    modèles suggérés auto, gpt-5.4, claude-opus-4.8

  • Cursor CLI

    Agent de programmation en CLI de Cursor

    id cursorbinaire cursor-agent

    modèles suggérés gpt-5, sonnet-4-thinking, claude-opus-4-8

  • Rovo Dev CLI

    Agent de programmation en CLI d’Atlassian

    id rovobinaire acli

    modèles suggérés se choisit dans la CLI

  • --effort règle l'effort de raisonnement pour Claude Code et Codex. --auth-mode api-key s'applique à Claude Code.
  • Passez tout autre flag de lancement avec --extra-args, par exemple le --remote-control de Claude Code.
  • Gardez les demandes d’autorisation activées. --skip les 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 CLIpplx

    Recherche web et extraits de pages avec Perplexity, au format JSON.

  • Google Colab CLIcolab

    Environnements CPU, GPU et TPU sur Google Colab : exécuter des scripts et des notebooks à distance.

  • Hugging Face CLIhf

    Télécharger et publier des modèles et des jeux de données, lancer des jobs sur le Hub Hugging Face.

  • Ollamaollama

    Exé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: