Saltar al contenido
Libre y de código abierto

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

shell
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

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

send pega el texto sin enviarlo, así que después usa key <agent> enter. open te lleva al asistente en tmux.

Detener

shell
reevesagents stop "feature x" --yes
stop, 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 reevesagents sin argumentos para abrir la TUI. Se envuelve a sí misma en una sesión de tmux llamada reeves; REEVES_NO_TMUX_WRAPPER=1 desactiva ese comportamiento.
  • reevesagents web inicia la Web UI en 127.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.

shell
reevesagents attach cc
reevesagents hosts
  • Seis CLIs pueden alojarlo: Claude Code, Codex, Kimi Code, Qwen Code, Hermes y OpenCode. reevesagents attach sin nombre lo conecta a todas las instaladas, y reevesagents 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: --name, --cwd, --prompt, --skip, --run, --auth-mode, --effort, --extra-args, --json.

add [spec...]

Añade agentes al run activo más reciente. Flags: --run, --prompt, --skip, --auth-mode, --effort, --extra-args, --json. Necesita al menos una especificación.

runs

Lista los runs activos. --json.

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

stop <run-id>requiere --yes

Detiene un run y cierra su sesión de tmux. -y/--yes.

kill <agent-id>requiere --yes

Detiene un agente. El run termina con su último agente activo. -y/--yes.

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

interrupt <agent-id>

Envía ctrl-c.

Registros e historial

agents [run-id]

Lista los agentes de los runs activos o de un run concreto. --json.

providers

Lista los proveedores con su disponibilidad y sus modelos conocidos. --models, --json.

tools

Lista las herramientas del agente con su estado de instalación y de inicio de sesión. --json.

delete <agent-id>requiere --yes

Elimina el registro de un agente terminado. -y/--yes.

delete-run <run-id>requiere --yes

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

history

Lista el historial de runs archivados. --json.

delete-history <id>requiere --yes

Elimina un registro del historial. -y/--yes.

Aprobaciones

approvals

Lista las aprobaciones pendientes. --json.

approve <approval-id> [note]

Aprueba una petición pendiente.

deny <approval-id> [note]

Deniega una petición pendiente.

Anfitriones MCP

hosts

Lista las CLIs anfitrionas compatibles con MCP y cuáles están conectadas. --json.

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. --force reescribe un registro existente.

detach <cli>

Desconecta el MCP de una CLI anfitriona mediante su propia CLI o su archivo de configuración.

mcp

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

presets

Lista los presets guardados. --json.

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

Guarda un run activo como preset.

start-preset <name>

Inicia un run a partir de un preset. --name, --cwd.

delete-preset <name>requiere --yes

Elimina un preset. -y/--yes.

Puesta en marcha y herramientas

setup

Comprueba tmux, Node y las CLIs instaladas en el primer arranque. --attach conecta todos los anfitriones instalados. --json informa del estado de la puesta en marcha.

doctor

Ejecuta las comprobaciones de salud del entorno. Sale con un código distinto de cero si hay fallos. --json.

skills [action]

Instala, quita o comprueba la skill de ReevesAgents para las CLIs compatibles con skills (install, remove, status; status por defecto). --json.

reap

Termina los agentes cuya ventana ha desaparecido o que han superado max_lifetime_ms, y cierra las sesiones de tmux huérfanas. --json.

web

Inicia en primer plano la Web UI, que solo escucha en loopback. --port, --no-open.

Herramientas MCP

Las 31 herramientas que puede llamar una CLI conectada, agrupadas por función.

Generar y dirigir

spawnobligatorioprovideropcionalrun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_args

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

Detiene un agente.

stopobligatoriorun_id

Detiene un run completo y cierra su sesión de tmux.

send_textobligatorioagent_idtext

Pega texto en el prompt de un agente sin enviarlo.

send_keyobligatorioagent_idkey

Envía una tecla permitida (enter, escape, ctrl-c, …).

interruptobligatorioagent_id

Envía ctrl-c a un agente.

readobligatorioagent_idopcionallines

Lee la salida reciente del panel, sin secuencias ANSI y con los datos sensibles ocultos. Por defecto: 20 líneas.

Inspeccionar

list

Lista los runs y los agentes.

list_providers

Catálogo de proveedores y modelos de esta máquina.

list_tools

Catá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_history

Runs archivados.

list_presets

Presets guardados.

list_hosts

CLIs compatibles con MCP y cuáles están conectadas.

get_config

Configuración global actual.

doctor

Comprobaciones de salud del entorno.

Aprobaciones

request_approvalobligatorioagent_idactionsummaryopcionaldetailsrisk

Crea una petición de aprobación.

resolve_approvalobligatorioapproval_iddecisionopcionalnote

Aprueba o deniega una petición pendiente.

check_approvalobligatorioapproval_id

Lee una aprobación.

list_approvalsopcionalrun_idstatus

Lista las aprobaciones, con filtros opcionales.

Ciclo de vida

deleteobligatorioagent_id

Elimina el registro de un agente terminado.

delete_runobligatoriorun_id

Elimina un run terminado.

delete_historyobligatorioid

Elimina un registro del historial.

openobligatorioid

En el cliente de tmux conectado, cambia a un run o a un agente.

reap

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

Fija uno o varios campos de configuración editables.

save_presetobligatoriorun_idnameopcionaldescription

Guarda un run activo como preset.

start_presetobligatorionameopcionalrun_nameworking_dir

Inicia un run a partir de un preset.

delete_presetobligatorioname

Elimina un preset.

Anfitriones y skills

attach_hostopcionalkey

Conecta el MCP a una CLI anfitriona o a todas.

detach_hostobligatoriokey

Desconecta el MCP de una CLI anfitriona.

install_skillsopcionalstatus

Instala la skill de ReevesAgents para las CLIs compatibles con skills, o indica dónde está.

Dos recursos contienen el catálogo de proveedores y una guía de uso: reevesagents://providers, reevesagents://guide

Configuració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.

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

Variables de entorno que los anulan

REEVES_REGISTRY

Anula el directorio raíz del estado (por defecto ~/.reeves).

REEVES_CONFIG

Anula la ruta del archivo de configuración.

REEVES_NO_TMUX_WRAPPER=1

Con el valor 1, evita que la TUI se envuelva automáticamente en una sesión de tmux.

REEVES_NO_COLOR=1

Con el valor 1, desactiva los colores de la TUI.

ALLOW_DESTRUCTIVE=1

Con el valor 1, permite los comandos destructivos sin --yes.

REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1

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

    modelos sugeridos fable, opus, sonnet, haiku

  • Codex CLIAnfitrión MCP

    CLI del agente de programación de OpenAI

    id codexbinario codex

    modelos 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 opencodebinario opencode

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

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

    modelos sugeridos kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed

  • DeepSeek CLI

    CLI de programación de DeepSeek

    id deepseekbinario deepseek

    modelos sugeridos deepseek-v4-pro, deepseek-v4-flash

  • Pi

    Arnés de programación mínimo para el terminal

    id pibinario pi

    modelos sugeridos sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o

  • Qwen CodeAnfitrión MCP

    CLI del agente de programación de Alibaba

    id qwenbinario qwen

    modelos sugeridos qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next

  • Aider

    Programación en pareja con IA en el terminal

    id aiderbinario aider

    modelos sugeridos sonnet, opus, haiku, deepseek/deepseek-chat

  • Gemini CLI

    Agente de terminal de código abierto de Google

    id geminibinario gemini

    modelos 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 clinebinario cline

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

    modelos sugeridos se elige en la propia CLI

  • Goose

    Agente de IA de propósito general y código abierto

    id goosebinario goose

    modelos 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 kilobinario kilo

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

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

    modelos sugeridos se elige en la propia CLI

  • Grok Build

    CLI del agente de programación de xAI

    id grokbinario grok

    modelos sugeridos grok-4.6, grok-4.5, grok-4.7

  • Kiro CLI

    CLI de programación agéntica de AWS

    id kirobinario kiro-cli

    modelos sugeridos claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6

  • Factory Droid

    CLI del agente de programación de Factory

    id droidbinario droid

    modelos sugeridos se elige en la propia CLI

  • Qoder CLI

    CLI de programación agéntica de Qoder

    id qoderbinario qodercli

    modelos sugeridos auto, performance, lite

  • Warp

    Agente de Warp en el terminal

    id warpbinario warp

    modelos sugeridos se elige en la propia CLI

  • Junie CLI

    CLI del agente de programación de JetBrains

    id juniebinario junie

    modelos sugeridos sonnet, opus, gpt-sol

  • GitHub Copilot CLI

    CLI del agente de programación de GitHub

    id copilotbinario copilot

    modelos sugeridos auto, gpt-5.4, claude-opus-4.8

  • Cursor CLI

    CLI del agente de programación de Cursor

    id cursorbinario cursor-agent

    modelos sugeridos gpt-5, sonnet-4-thinking, claude-opus-4-8

  • Rovo Dev CLI

    CLI del agente de programación de Atlassian

    id rovobinario acli

    modelos sugeridos se elige en la propia CLI

  • --effort fija el esfuerzo de razonamiento en Claude Code y Codex. --auth-mode api-key se aplica a Claude Code.
  • Cualquier otro flag de arranque se pasa con --extra-args, por ejemplo el --remote-control de Claude Code.
  • Mantén activadas las solicitudes de permiso. --skip las 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 CLIpplx

    Búsqueda web y fragmentos de páginas de Perplexity, en JSON.

  • Google Colab CLIcolab

    Entornos de ejecución con CPU, GPU y TPU en Google Colab: ejecuta scripts y notebooks en remoto.

  • Hugging Face CLIhf

    Descarga y sube modelos y conjuntos de datos, y ejecuta trabajos en el Hub de Hugging Face.

  • Ollamaollama

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