Documentación
Los asistentes de IA realizan tareas de programación. Esta guía explica las herramientas de línea de comandos (CLI), los menús del terminal (TUI), tmux para mantener las tareas en marcha y una conexión estándar entre herramientas de IA (MCP).
Instalación
Necesitas macOS, Linux o WSL, Node 22.12 o posterior, tmux 3.0 o posterior y al menos una CLI de proveedor instalada y con la sesión iniciada.
$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagentsreevesagents doctor comprueba todo eso. reevesagents setup ejecuta las mismas comprobaciones como asistente de primer arranque, y con --attach además conecta el MCP a todos los anfitriones instalados.Inicio rápido
Inicia un equipo, mira cómo va, intervén y detenlo.
Inicia un equipo
reevesagents spawn cc:lead codex:api kimi:docs \
--name "feature x" --prompt "Build feature X. The lead splits the work."Cada asistente se escribe como provider[:nickname[:model]], y el primero hace de líder. Con reevesagents add añades asistentes al run más reciente.
Observa y dirige
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open apisend pega el texto sin enviarlo, así que después usa key <agent> enter. open te lleva al asistente en tmux.
Detener
reevesagents stop "feature x" --yesstop, kill y los comandos delete esperan --yes (o ALLOW_DESTRUCTIVE=1).Menú del terminal, navegador y comandos
El menú (TUI), la interfaz del navegador y la herramienta de línea de comandos (CLI) comparten los registros de tareas en ~/.reeves. La herramienta de terminal tmux mantiene los asistentes en marcha.
- Escribe
reevesagentssin argumentos para abrir la TUI. Se envuelve a sí misma en una sesión de tmux llamadareeves;REEVES_NO_TMUX_WRAPPER=1desactiva ese comportamiento. reevesagents webinicia la Web UI en127.0.0.1, en el puerto 8080 o el siguiente libre. Rechaza encabezados Host que no sean loopback y escrituras desde otro origen, y Ctrl+C la detiene sin tocar a tus asistentes.- Todo existe también como comando de la CLI. Los scripts deberían leer
--json, porque la salida en texto plano puede cambiar entre versiones. - Por debajo está tmux, con una sesión por run y una ventana por asistente.
reevesagents open <id>salta a la ventana correcta estés donde estés.
Control de agentes (MCP)
Conecta una herramienta de programación con las demás mediante un protocolo estándar (MCP). Es opcional. Reinicia la herramienta después de conectarla.
reevesagents attach cc
reevesagents hosts- Seis CLIs pueden alojarlo: Claude Code, Codex, Kimi Code, Qwen Code, Hermes y OpenCode.
reevesagents attachsin nombre lo conecta a todas las instaladas, yreevesagents detach <cli>lo vuelve a quitar. - El anfitrión recibe herramientas sencillas para generar asistentes, pegar texto, pulsar teclas, leer la salida y gestionar aprobaciones. Lo que hace el equipo lo decide quien le da instrucciones al anfitrión.
- Los trabajadores generados solo reciben las herramientas si conectas también su CLI. Los lanzamientos por MCP respetan
max_agents(100 por defecto) como límite de asistentes por run.
Comandos
Todos los subcomandos de reevesagents. Sin argumentos, abre la TUI.
Runs
spawn [spec...]Inicia un run. Cada especificación se escribe como provider[:nickname[:model]] y el primer agente hace de líder. Flags:
add [spec...]Añade agentes al run activo más reciente. Flags:
runsLista los runs activos.
open <id>Salta en tmux a la ventana de un run o de un agente. Acepta un id, un nombre, un apodo o un prefijo único.
peek <agent-id>Imprime la salida reciente de un agente.
stop <run-id>requiere Detiene un run y cierra su sesión de tmux.
kill <agent-id>requiere Detiene un agente. El run termina con su último agente activo.
Dirigir un asistente
send <agent-id> <text...>Pega texto en el prompt del agente sin enviarlo.
key <agent-id> <key>Envía una tecla permitida: enter, escape, backspace, tab, space, up, down, left, right,
interrupt <agent-id>Envía
Registros e historial
agents [run-id]Lista los agentes de los runs activos o de un run concreto.
providersLista los proveedores con su disponibilidad y sus modelos conocidos.
toolsLista las herramientas del agente con su estado de instalación y de inicio de sesión.
delete <agent-id>requiere Elimina el registro de un agente terminado.
delete-run <run-id>requiere Elimina un run terminado.
historyLista el historial de runs archivados.
delete-history <id>requiere Elimina un registro del historial.
Aprobaciones
approvalsLista las aprobaciones pendientes.
approve <approval-id> [note]Aprueba una petición pendiente.
deny <approval-id> [note]Deniega una petición pendiente.
Anfitriones MCP
hostsLista las CLIs anfitrionas compatibles con MCP y cuáles están conectadas.
attach [cli]Conecta el MCP a una CLI anfitriona, o a todos los anfitriones instalados, mediante su propia CLI o su archivo de configuración.
detach <cli>Desconecta el MCP de una CLI anfitriona mediante su propia CLI o su archivo de configuración.
mcpInicia el servidor MCP de Control de agentes por stdio. La CLI anfitriona lo ejecuta por ti.
Config y presets
config [key] [value]Muestra, consulta o fija un campo de configuración editable.
presetsLista los presets guardados.
save-preset <run-id> <name> [description...]Guarda un run activo como preset.
start-preset <name>Inicia un run a partir de un preset.
delete-preset <name>requiere Elimina un preset.
Puesta en marcha y herramientas
setupComprueba tmux, Node y las CLIs instaladas en el primer arranque.
doctorEjecuta las comprobaciones de salud del entorno. Sale con un código distinto de cero si hay fallos.
skills [action]Instala, quita o comprueba la skill de ReevesAgents para las CLIs compatibles con skills (install, remove, status; status por defecto).
reapTermina los agentes cuya ventana ha desaparecido o que han superado max_lifetime_ms, y cierra las sesiones de tmux huérfanas.
webInicia en primer plano la Web UI, que solo escucha en loopback.
Herramientas MCP
Las 31 herramientas que puede llamar una CLI conectada, agrupadas por función.
Generar y dirigir
spawnobligatorioprovideropcionalrun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_argsGenera un trabajador. Sin run_id, reutiliza el run de esta sesión MCP, creado con el primer lanzamiento de la sesión. Con run_id, apunta a otro run.
killobligatorioagent_idDetiene un agente.
stopobligatoriorun_idDetiene un run completo y cierra su sesión de tmux.
send_textobligatorioagent_idtextPega texto en el prompt de un agente sin enviarlo.
send_keyobligatorioagent_idkeyEnvía una tecla permitida (enter, escape,
interruptobligatorioagent_idEnvía
readobligatorioagent_idopcionallinesLee la salida reciente del panel, sin secuencias ANSI y con los datos sensibles ocultos. Por defecto: 20 líneas.
Inspeccionar
listLista los runs y los agentes.
list_providersCatálogo de proveedores y modelos de esta máquina.
list_toolsCatálogo de herramientas de esta máquina: CLI auxiliares que un agente puede ejecutar desde su shell, con su estado de instalación y de inicio de sesión.
list_historyRuns archivados.
list_presetsPresets guardados.
list_hostsCLIs compatibles con MCP y cuáles están conectadas.
get_configConfiguración global actual.
doctorComprobaciones de salud del entorno.
Aprobaciones
request_approvalobligatorioagent_idactionsummaryopcionaldetailsriskCrea una petición de aprobación.
resolve_approvalobligatorioapproval_iddecisionopcionalnoteAprueba o deniega una petición pendiente.
check_approvalobligatorioapproval_idLee una aprobación.
list_approvalsopcionalrun_idstatusLista las aprobaciones, con filtros opcionales.
Ciclo de vida
deleteobligatorioagent_idElimina el registro de un agente terminado.
delete_runobligatoriorun_idElimina un run terminado.
delete_historyobligatorioidElimina un registro del historial.
openobligatorioidEn el cliente de tmux conectado, cambia a un run o a un agente.
reapLimpia ahora los agentes sin ventana o que han superado su tiempo de vida, y las sesiones de tmux huérfanas.
Config y presets
set_configopcionalpeek_interval_mspeek_linesmax_depthmax_agentsready_delay_msmax_lifetime_msdefault_permissionslanguageFija uno o varios campos de configuración editables.
save_presetobligatoriorun_idnameopcionaldescriptionGuarda un run activo como preset.
start_presetobligatorionameopcionalrun_nameworking_dirInicia un run a partir de un preset.
delete_presetobligatorionameElimina un preset.
Anfitriones y skills
attach_hostopcionalkeyConecta el MCP a una CLI anfitriona o a todas.
detach_hostobligatoriokeyDesconecta el MCP de una CLI anfitriona.
install_skillsopcionalstatusInstala la skill de ReevesAgents para las CLIs compatibles con skills, o indica dónde está.
reevesagents://providers, reevesagents://guideConfiguración
Los ajustes viven en ~/.reeves/config.json. Cambia uno con reevesagents config <key> <value> o desde las pantallas de ajustes. reevesagents config language tr cambia la interfaz a cualquiera de sus diez idiomas.
Campos
peek_interval_ms5000
Ajuste guardado del intervalo de sondeo. Las UIs actuales usan intervalos de actualización fijos.
peek_lines10
Ajuste guardado del número de líneas de salida. Las pantallas actuales y las lecturas por CLI/MCP usan su propio número de líneas.
max_agents100
Límite de agentes activos por run, que respetan los lanzamientos por MCP. Las demás superficies de lanzamiento no lo respetan.
max_depth5
Ajuste guardado de profundidad de recursión. El motor de runs actual no lo respeta.
ready_delay_ms5000
Tiempo de espera para que una CLI recién iniciada se estabilice antes de pegar un prompt.
max_lifetime_ms0
Termina los agentes cuya antigüedad supere este valor. 0 lo desactiva.
default_permissionsask
Modo de permisos por defecto para los agentes nuevos: ask o skip.
languageen
Idioma de la UI, uno de los diez códigos de idioma.
peek_interval_ms | 5000 | Ajuste guardado del intervalo de sondeo. Las UIs actuales usan intervalos de actualización fijos. |
peek_lines | 10 | Ajuste guardado del número de líneas de salida. Las pantallas actuales y las lecturas por CLI/MCP usan su propio número de líneas. |
max_agents | 100 | Límite de agentes activos por run, que respetan los lanzamientos por MCP. Las demás superficies de lanzamiento no lo respetan. |
max_depth | 5 | Ajuste guardado de profundidad de recursión. El motor de runs actual no lo respeta. |
ready_delay_ms | 5000 | Tiempo de espera para que una CLI recién iniciada se estabilice antes de pegar un prompt. |
max_lifetime_ms | 0 | Termina los agentes cuya antigüedad supere este valor. 0 lo desactiva. |
default_permissions | ask | Modo de permisos por defecto para los agentes nuevos: ask o skip. |
language | en | Idioma de la UI, uno de los diez códigos de idioma. |
Estado en disco
~/.reeves/
config.json
presets/<name>.json
runs/<run-id>/
run.json
agents/<agent-id>.json
approvals/<approval-id>.json
history/runs/<run-id>.jsonVariables de entorno que los anulan
REEVES_REGISTRYAnula el directorio raíz del estado (por defecto
REEVES_CONFIGAnula la ruta del archivo de configuración.
REEVES_NO_TMUX_WRAPPER=1Con el valor 1, evita que la TUI se envuelva automáticamente en una sesión de tmux.
REEVES_NO_COLOR=1Con el valor 1, desactiva los colores de la TUI.
ALLOW_DESTRUCTIVE=1Con el valor 1, permite los comandos destructivos sin
REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1Con el valor 1, doctor omite la comprobación de compatibilidad de proveedores.
Proveedores
25 CLIs, cada una con un id corto que usas en la especificación de spawn. Las listas de modelos son sugerencias, y cualquier id de modelo que pases llega tal cual al proveedor.
Claude CodeAnfitrión MCP
Agente de programación de Anthropic para el terminal
id
ccbinarioclaudemodelos sugeridos fable, opus, sonnet, haiku
Codex CLIAnfitrión MCP
CLI del agente de programación de OpenAI
id
codexbinariocodexmodelos sugeridos gpt-5.6-sol, gpt-5.5, gpt-5.4-mini
OpenCode CLIAnfitrión MCP
Agente de programación de código abierto para el terminal
id
opencodebinarioopencodemodelos 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ón MCP
CLI del agente de Nous Research
id
hermesbinariohermesmodelos sugeridos anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini
Kimi CodeAnfitrión MCP
CLI de programación de Moonshot AI
id
kimibinariokimimodelos sugeridos kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed
DeepSeek CLI
CLI de programación de DeepSeek
id
deepseekbinariodeepseekmodelos sugeridos deepseek-v4-pro, deepseek-v4-flash
Pi
Arnés de programación mínimo para el terminal
id
pibinariopimodelos sugeridos sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o
Qwen CodeAnfitrión MCP
CLI del agente de programación de Alibaba
id
qwenbinarioqwenmodelos sugeridos qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next
Aider
Programación en pareja con IA en el terminal
id
aiderbinarioaidermodelos sugeridos sonnet, opus, haiku, deepseek/deepseek-chat
Gemini CLI
Agente de terminal de código abierto de Google
id
geminibinariogeminimodelos sugeridos gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite
Cline CLI
CLI de agente de programación autónomo
id
clinebinarioclinemodelos sugeridos anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro
Crush
Agente de programación de Charm para el terminal
id
crushbinariocrushmodelos sugeridos se elige en la propia CLI
Goose
Agente de IA de propósito general y código abierto
id
goosebinariogoosemodelos sugeridos claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro
Kilo Code
Agente de programación de código abierto con CLI
id
kilobinariokilomodelos 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 programación con memoria a largo plazo
id
lettabinariolettamodelos sugeridos zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct
Mistral Vibe
CLI del agente de programación de Mistral
id
vibebinariovibemodelos sugeridos se elige en la propia CLI
Grok Build
CLI del agente de programación de xAI
id
grokbinariogrokmodelos sugeridos grok-4.6, grok-4.5, grok-4.7
Kiro CLI
CLI de programación agéntica de AWS
id
kirobinariokiro-climodelos sugeridos claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6
Factory Droid
CLI del agente de programación de Factory
id
droidbinariodroidmodelos sugeridos se elige en la propia CLI
Qoder CLI
CLI de programación agéntica de Qoder
id
qoderbinarioqoderclimodelos sugeridos auto, performance, lite
Warp
Agente de Warp en el terminal
id
warpbinariowarpmodelos sugeridos se elige en la propia CLI
Junie CLI
CLI del agente de programación de JetBrains
id
juniebinariojuniemodelos sugeridos sonnet, opus, gpt-sol
GitHub Copilot CLI
CLI del agente de programación de GitHub
id
copilotbinariocopilotmodelos sugeridos auto, gpt-5.4, claude-opus-4.8
Cursor CLI
CLI del agente de programación de Cursor
id
cursorbinariocursor-agentmodelos sugeridos gpt-5, sonnet-4-thinking, claude-opus-4-8
Rovo Dev CLI
CLI del agente de programación de Atlassian
id
rovobinarioaclimodelos sugeridos se elige en la propia CLI
| Proveedor | id | binario | modelos sugeridos | Anfitrión MCP |
|---|---|---|---|---|
| Claude CodeAgente de programación de Anthropic para el terminal | cc | claude | fable, opus, sonnet, haiku | ✔ |
| Codex CLICLI del agente de programación de OpenAI | codex | codex | gpt-5.6-sol, gpt-5.5, gpt-5.4-mini | ✔ |
| OpenCode CLIAgente de programación de código abierto para el 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 | ✔ |
| HermesCLI del agente 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 programación de Moonshot AI | kimi | kimi | kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed | ✔ |
| DeepSeek CLICLI de programación de DeepSeek | deepseek | deepseek | deepseek-v4-pro, deepseek-v4-flash | |
| PiArnés de programación mínimo para el terminal | pi | pi | sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o | |
| Qwen CodeCLI del agente de programación de Alibaba | qwen | qwen | qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next | ✔ |
| AiderProgramación en pareja con IA en el terminal | aider | aider | sonnet, opus, haiku, deepseek/deepseek-chat | |
| Gemini CLIAgente de terminal de código abierto de Google | gemini | gemini | gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite | |
| Cline CLICLI de agente de programación autónomo | cline | cline | anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro | |
| CrushAgente de programación de Charm para el terminal | crush | crush | se elige en la propia CLI | |
| GooseAgente de IA de propósito general y código abierto | goose | goose | claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro | |
| Kilo CodeAgente de programación de código abierto 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 de programación con memoria a largo plazo | letta | letta | zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct | |
| Mistral VibeCLI del agente de programación de Mistral | vibe | vibe | se elige en la propia CLI | |
| Grok BuildCLI del agente de programación de xAI | grok | grok | grok-4.6, grok-4.5, grok-4.7 | |
| Kiro CLICLI de programación agéntica de AWS | kiro | kiro-cli | claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6 | |
| Factory DroidCLI del agente de programación de Factory | droid | droid | se elige en la propia CLI | |
| Qoder CLICLI de programación agéntica de Qoder | qoder | qodercli | auto, performance, lite | |
| WarpAgente de Warp en el terminal | warp | warp | se elige en la propia CLI | |
| Junie CLICLI del agente de programación de JetBrains | junie | junie | sonnet, opus, gpt-sol | |
| GitHub Copilot CLICLI del agente de programación de GitHub | copilot | copilot | auto, gpt-5.4, claude-opus-4.8 | |
| Cursor CLICLI del agente de programación de Cursor | cursor | cursor-agent | gpt-5, sonnet-4-thinking, claude-opus-4-8 | |
| Rovo Dev CLICLI del agente de programación de Atlassian | rovo | acli | se elige en la propia CLI |
--effortfija el esfuerzo de razonamiento en Claude Code y Codex.--auth-mode api-keyse aplica a Claude Code.- Cualquier otro flag de arranque se pasa con
--extra-args, por ejemplo el--remote-controlde Claude Code. - Mantén activadas las solicitudes de permiso.
--skiplas desactiva en las herramientas de programación.
Herramientas para agentes
Cuatro CLIs auxiliares que un agente puede ejecutar desde su propio shell. No aceptan tareas de chat, así que no son proveedores que se puedan lanzar. reevesagents tools las enumera con su estado de instalación y de sesión.
Perplexity CLI
pplxBúsqueda web y fragmentos de páginas de Perplexity, en JSON.
Google Colab CLI
colabEntornos de ejecución con CPU, GPU y TPU en Google Colab: ejecuta scripts y notebooks en remoto.
Descarga y sube modelos y conjuntos de datos, y ejecuta trabajos en el Hub de Hugging Face.
Ollama
ollamaEjecuta modelos locales o de Ollama en la nube desde el terminal.
Resolución de problemas
Empieza por reevesagents doctor. Normalmente te dice cuál es el problema.
Falta tmux
Instálalo con brew install tmux o sudo apt install tmux y vuelve a ejecutar doctor.
Un proveedor no aparece
Casi siempre la CLI no está instalada o no tiene la sesión iniciada. Arregla eso y compruébalo con reevesagents providers.
La Web UI dice que faltan paquetes
La terminal en vivo necesita los módulos opcionales ws y @lydell/node-pty. Reinstala en global con npm o pnpm para recuperarlos.
El puerto 8080 está ocupado
La Web UI pasa al siguiente puerto libre e imprime la URL. Si prefieres elegirlo tú, usa reevesagents web --port 8090.
Windows nativo
Ejecuta el producto completo en WSL. Si solo necesitas el Control de agentes, reevesagents-win corre de forma nativa como servidor MCP.
Datos que puedes comprobar
Periodo: del 2025-04-14 al 2026-10-14. Cifras de GitHub y npm verificadas el 2026-10-15. Las descargas cuentan peticiones de paquetes.
Última actualización: