Перейти к содержимому
Бесплатно и с открытым исходным кодом

Документация

ИИ-помощники выполняют задачи программирования. Руководство описывает командную строку (CLI), меню терминала (TUI), инструмент tmux для непрерывной работы задач и стандартную связь между ИИ-инструментами (MCP).

Установка

Нужны macOS, Linux или WSL, Node 22.12 или новее, tmux 3.0 или новее и хотя бы один CLI провайдера, который установлен и в котором выполнен вход.

$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagents
reevesagents doctor проверяет всё это. reevesagents setup выполняет те же проверки в виде мастера первого запуска, а с --attach ещё и подключает MCP ко всем установленным хостам.

Быстрый старт

Запустите команду помощников, проверьте, как идут дела, вмешайтесь и остановите её.

Запустите команду

shell
reevesagents spawn cc:lead codex:api kimi:docs \
  --name "feature x" --prompt "Build feature X. The lead splits the work."

Каждый помощник записывается как provider[:nickname[:model]], и первый в списке становится ведущим. Чтобы добавить помощников в последний run, используйте reevesagents add.

Наблюдайте и направляйте

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

send вставляет текст без отправки, поэтому следом выполните key <agent> enter. open переносит вас к помощнику в tmux.

Остановка

shell
reevesagents stop "feature x" --yes
stop, kill и команды delete ждут --yes (или ALLOW_DESTRUCTIVE=1).

Меню терминала, браузер и команды

Меню (TUI), интерфейс браузера и командная строка (CLI) используют записи задач в ~/.reeves. Инструмент терминала tmux сохраняет помощников работающими.

  • Наберите reevesagents без аргументов, чтобы открыть TUI. Он сам заворачивается в tmux-сессию с именем reeves, а REEVES_NO_TMUX_WRAPPER=1 это отключает.
  • reevesagents web запускает Web UI на 127.0.0.1, на порту 8080 или следующем свободном. Запросы с заголовком Host вне loopback и запись с чужого origin он отклоняет, а Ctrl+C останавливает его, не затрагивая помощников.
  • Каждое действие доступно и как команда CLI. Скриптам лучше читать --json, потому что обычный текстовый вывод может меняться от версии к версии.
  • В основе лежит tmux: одна сессия на run и одно окно на помощника. reevesagents open <id> переносит в нужное окно, где бы вы ни находились.

Управление агентами (MCP)

Свяжите один инструмент программирования с другими через стандартный протокол (MCP). Это необязательно. После подключения перезапустите инструмент.

shell
reevesagents attach cc
reevesagents hosts
  • Хостом могут быть шесть CLI: Claude Code, Codex, Kimi Code, Qwen Code, Hermes и OpenCode. reevesagents attach без имени подключает все установленные, а reevesagents detach <cli> снова отключает.
  • Хост получает простые инструменты: запускать помощников, вставлять текст, нажимать клавиши, читать вывод и разбирать подтверждения. Что делает команда, решает тот, кто пишет промпты хосту.
  • Запущенные воркеры получают эти инструменты, только если вы подключите и их CLI. При запуске через MCP действует лимит max_agents (по умолчанию 100) на число помощников в одном run’е.

Команды

Все подкоманды reevesagents. Без аргументов открывается TUI.

Run’ы

spawn [spec...]

Запускает run. Каждая спецификация имеет вид provider[:nickname[:model]], и первый агент становится ведущим. Флаги: --name, --cwd, --prompt, --skip, --run, --auth-mode, --effort, --extra-args, --json.

add [spec...]

Добавляет агентов в последний активный run. Флаги: --run, --prompt, --skip, --auth-mode, --effort, --extra-args, --json. Нужна хотя бы одна спецификация.

runs

Выводит список активных run’ов. --json.

open <id>

Переносит к окну run’а или агента в tmux. Принимает id, имя, псевдоним или однозначный префикс.

peek <agent-id>

Показывает последние строки вывода одного агента. -n/--lines (по умолчанию 20), --json.

stop <run-id>нужен --yes

Останавливает run и закрывает его сессию tmux. -y/--yes.

kill <agent-id>нужен --yes

Останавливает одного агента. Run завершается вместе с последним активным агентом. -y/--yes.

Управление помощником

send <agent-id> <text...>

Вставляет текст в поле ввода агента без отправки.

key <agent-id> <key>

Отправляет одну разрешённую клавишу: enter, escape, backspace, tab, space, up, down, left, right, ctrl-c.

interrupt <agent-id>

Отправляет ctrl-c.

Записи и история

agents [run-id]

Выводит список агентов во всех активных run’ах или в одном указанном run’е. --json.

providers

Выводит список провайдеров с их доступностью и известными моделями. --models, --json.

tools

Выводит список инструментов агента со статусом установки и входа. --json.

delete <agent-id>нужен --yes

Удаляет запись о завершённом агенте. -y/--yes.

delete-run <run-id>нужен --yes

Удаляет завершённый run. -y/--yes.

history

Выводит архивную историю run’ов. --json.

delete-history <id>нужен --yes

Удаляет одну запись из истории. -y/--yes.

Подтверждения

approvals

Выводит список ожидающих запросов на подтверждение. --json.

approve <approval-id> [note]

Одобряет запрос на подтверждение.

deny <approval-id> [note]

Отклоняет запрос на подтверждение.

Хосты MCP

hosts

Выводит список хост-CLI с поддержкой MCP и состояние их подключения. --json.

attach [cli]

Подключает MCP к одному хост-CLI или ко всем установленным хостам через собственные команды хоста или его файл конфигурации. --force перезаписывает существующую регистрацию.

detach <cli>

Отключает MCP от одного хост-CLI через собственные команды хоста или его файл конфигурации.

mcp

Запускает MCP-сервер управления агентами через stdio. Эту команду выполняет сам хост-CLI.

Конфигурация и пресеты

config [key] [value]

Показывает, читает или задаёт редактируемое поле конфигурации. --json.

presets

Выводит список сохранённых пресетов. --json.

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

Сохраняет активный run как пресет.

start-preset <name>

Запускает run из пресета. --name, --cwd.

delete-preset <name>нужен --yes

Удаляет пресет. -y/--yes.

Настройка и инструменты

setup

Проверяет tmux, Node и установленные CLI при первом запуске. --attach подключает все установленные хосты. --json выводит состояние первоначальной настройки.

doctor

Проверяет окружение. При ошибке завершается с ненулевым кодом выхода. --json.

skills [action]

Устанавливает, удаляет или проверяет скилл ReevesAgents для CLI с поддержкой скиллов (install, remove, status; по умолчанию status). --json.

reap

Завершает агентов, у которых пропало окно или превышен max_lifetime_ms, и закрывает осиротевшие сессии tmux. --json.

web

Запускает на переднем плане Web UI, который слушает только loopback. --port, --no-open.

Инструменты MCP

Подключённый CLI может вызывать 31 инструмент. Здесь они сгруппированы по назначению.

Запуск и управление

spawnобязательныйproviderопциональныйrun_idmodeltasknicknamenameworking_dirpermissionsauth_modeeffortextra_args

Запускает воркера. Без run_id используется run этой MCP-сессии, созданный при её первом вызове spawn. С run_id можно указать другой run.

killобязательныйagent_id

Останавливает одного агента.

stopобязательныйrun_id

Останавливает весь run и закрывает его сессию tmux.

send_textобязательныйagent_idtext

Вставляет текст в поле ввода агента без отправки.

send_keyобязательныйagent_idkey

Отправляет одну разрешённую клавишу (enter, escape, ctrl-c, …).

interruptобязательныйagent_id

Отправляет агенту ctrl-c.

readобязательныйagent_idопциональныйlines

Читает последние строки вывода панели без ANSI-последовательностей и с затёртыми секретами. По умолчанию 20 строк.

Просмотр

list

Выводит список run’ов и агентов.

list_providers

Каталог провайдеров и моделей на этой машине.

list_tools

Каталог инструментов этой машины: вспомогательные CLI, которые агент может запускать из своей оболочки, со статусом установки и входа.

list_history

Архивные run’ы.

list_presets

Сохранённые пресеты.

list_hosts

CLI с поддержкой MCP и состояние их подключения.

get_config

Текущая глобальная конфигурация.

doctor

Проверка окружения.

Подтверждения

request_approvalобязательныйagent_idactionsummaryопциональныйdetailsrisk

Создаёт запрос на подтверждение.

resolve_approvalобязательныйapproval_iddecisionопциональныйnote

Одобряет или отклоняет ожидающий запрос.

check_approvalобязательныйapproval_id

Читает один запрос на подтверждение.

list_approvalsопциональныйrun_idstatus

Выводит список запросов на подтверждение с опциональными фильтрами.

Жизненный цикл

deleteобязательныйagent_id

Удаляет запись о завершённом агенте.

delete_runобязательныйrun_id

Удаляет завершённый run.

delete_historyобязательныйid

Удаляет одну запись из истории.

openобязательныйid

Переключает подключённый клиент tmux на run или агента.

reap

Немедленно завершает агентов с пропавшим окном или истёкшим сроком жизни и закрывает осиротевшие сессии tmux.

Конфигурация и пресеты

set_configопциональныйpeek_interval_mspeek_linesmax_depthmax_agentsready_delay_msmax_lifetime_msdefault_permissionslanguage

Задаёт одно или несколько редактируемых полей конфигурации.

save_presetобязательныйrun_idnameопциональныйdescription

Сохраняет активный run как пресет.

start_presetобязательныйnameопциональныйrun_nameworking_dir

Запускает run из пресета.

delete_presetобязательныйname

Удаляет пресет.

Хосты и скиллы

attach_hostопциональныйkey

Подключает MCP к одному хост-CLI или ко всем.

detach_hostобязательныйkey

Отключает MCP от одного хост-CLI.

install_skillsопциональныйstatus

Устанавливает скилл ReevesAgents для CLI с поддержкой скиллов или сообщает, где он находится.

Два ресурса содержат каталог провайдеров и руководство по использованию: reevesagents://providers, reevesagents://guide

Конфигурация

Настройки хранятся в ~/.reeves/config.json. Меняйте их командой reevesagents config <key> <value> или на экранах настроек. reevesagents config language tr переключает интерфейс на один из десяти доступных языков.

Поля

peek_interval_ms5000

Сохранённая настройка интервала опроса. Текущие интерфейсы используют фиксированные интервалы обновления.

peek_lines10

Сохранённая настройка числа строк вывода. Текущие экраны и чтение через CLI/MCP используют своё число строк.

max_agents100

Лимит активных агентов на run при запуске через MCP spawn. Другие способы запуска его не проверяют.

max_depth5

Сохранённая настройка глубины рекурсии. Текущий движок run’ов её не применяет.

ready_delay_ms5000

Ожидание готовности нового CLI перед вставкой промпта.

max_lifetime_ms0

Завершает агентов, работающих дольше этого времени. 0 это отключает.

default_permissionsask

Режим разрешений по умолчанию для новых агентов: ask или skip.

languageen

Язык интерфейса, один из десяти кодов локали.

Состояние на диске

~/.reeves/
  config.json
  presets/<name>.json
  runs/<run-id>/
    run.json
    agents/<agent-id>.json
    approvals/<approval-id>.json
  history/runs/<run-id>.json

Переменные окружения

REEVES_REGISTRY

Переопределяет корневой каталог состояния (по умолчанию ~/.reeves).

REEVES_CONFIG

Переопределяет путь к файлу конфигурации.

REEVES_NO_TMUX_WRAPPER=1

При значении 1 отключает автоматическое заворачивание TUI в сессию tmux.

REEVES_NO_COLOR=1

При значении 1 отключает цвета TUI.

ALLOW_DESTRUCTIVE=1

При значении 1 разрешает деструктивные команды без --yes.

REEVES_DOCTOR_SKIP_PROVIDER_COMPAT=1

При значении 1 doctor пропускает проверку совместимости провайдеров.

Провайдеры

25 CLI, у каждого есть короткий id для спецификации spawn. Списки моделей даны как подсказки, и любой переданный id модели уходит провайдеру как есть.

  • Claude CodeХост MCP

    Агент для программирования от Anthropic в терминале

    id ccбинарник claude

    рекомендуемые модели fable, opus, sonnet, haiku

  • Codex CLIХост MCP

    CLI-агент для программирования от OpenAI

    id codexбинарник codex

    рекомендуемые модели gpt-5.6-sol, gpt-5.5, gpt-5.4-mini

  • OpenCode CLIХост MCP

    Открытый агент для программирования в терминале

    id 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

  • HermesХост MCP

    CLI-агент от Nous Research

    id hermesбинарник hermes

    рекомендуемые модели anthropic:claude-opus-4-8, anthropic:claude-fable-5, openai-codex:gpt-5.5, openai-codex:gpt-5.4-mini

  • Kimi CodeХост MCP

    CLI для программирования от Moonshot AI

    id kimiбинарник kimi

    рекомендуемые модели kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed

  • DeepSeek CLI

    CLI для программирования от DeepSeek

    id deepseekбинарник deepseek

    рекомендуемые модели deepseek-v4-pro, deepseek-v4-flash

  • Pi

    Минималистичная среда для программирования в терминале

    id piбинарник pi

    рекомендуемые модели sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o

  • Qwen CodeХост MCP

    CLI-агент для программирования от Alibaba

    id qwenбинарник qwen

    рекомендуемые модели qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next

  • Aider

    Парное программирование с ИИ в терминале

    id aiderбинарник aider

    рекомендуемые модели sonnet, opus, haiku, deepseek/deepseek-chat

  • Gemini CLI

    Открытый терминальный агент от Google

    id geminiбинарник gemini

    рекомендуемые модели gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite

  • Cline CLI

    Автономный CLI-агент для программирования

    id clineбинарник cline

    рекомендуемые модели anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro

  • Crush

    Терминальный агент для программирования от Charm

    id crushбинарник crush

    рекомендуемые модели выбирается в самом CLI

  • Goose

    Открытый универсальный ИИ-агент

    id gooseбинарник goose

    рекомендуемые модели claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro

  • Kilo Code

    Открытый агент для программирования с CLI

    id kiloбинарник kilo

    рекомендуемые модели kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest

  • Letta Code

    Агент для программирования с долговременной памятью

    id lettaбинарник letta

    рекомендуемые модели zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct

  • Mistral Vibe

    CLI-агент для программирования от Mistral

    id vibeбинарник vibe

    рекомендуемые модели выбирается в самом CLI

  • Grok Build

    CLI-агент для программирования от xAI

    id grokбинарник grok

    рекомендуемые модели grok-4.6, grok-4.5, grok-4.7

  • Kiro CLI

    Агентный CLI для программирования от AWS

    id kiroбинарник kiro-cli

    рекомендуемые модели claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6

  • Factory Droid

    CLI-агент для программирования от Factory

    id droidбинарник droid

    рекомендуемые модели выбирается в самом CLI

  • Qoder CLI

    Агентный CLI для программирования от Qoder

    id qoderбинарник qodercli

    рекомендуемые модели auto, performance, lite

  • Warp

    Агент Warp в терминале

    id warpбинарник warp

    рекомендуемые модели выбирается в самом CLI

  • Junie CLI

    CLI-агент для программирования от JetBrains

    id junieбинарник junie

    рекомендуемые модели sonnet, opus, gpt-sol

  • GitHub Copilot CLI

    CLI-агент для программирования от GitHub

    id copilotбинарник copilot

    рекомендуемые модели auto, gpt-5.4, claude-opus-4.8

  • Cursor CLI

    CLI-агент для программирования от Cursor

    id cursorбинарник cursor-agent

    рекомендуемые модели gpt-5, sonnet-4-thinking, claude-opus-4-8

  • Rovo Dev CLI

    CLI-агент для программирования от Atlassian

    id rovoбинарник acli

    рекомендуемые модели выбирается в самом CLI

  • --effort задаёт уровень рассуждений для Claude Code и Codex. --auth-mode api-key действует для Claude Code.
  • Любой другой флаг запуска передаётся через --extra-args, например --remote-control для Claude Code.
  • Оставляйте запросы разрешений включёнными. --skip отключает их в инструментах программирования.

Инструменты для агентов

Четыре вспомогательных CLI, которые агент может запускать из своей оболочки. Они не принимают задачи из чата, поэтому не относятся к запускаемым провайдерам. reevesagents tools показывает их вместе со статусом установки и входа.

  • Perplexity CLIpplx

    Веб-поиск и фрагменты страниц от Perplexity в формате JSON.

  • Google Colab CLIcolab

    Среды выполнения с CPU, GPU и TPU в Google Colab: удалённый запуск скриптов и ноутбуков.

  • Hugging Face CLIhf

    Скачивание и загрузка моделей и датасетов, запуск задач на Hugging Face Hub.

  • Ollamaollama

    Запуск локальных и облачных моделей Ollama из терминала.

Устранение неполадок

Начните с reevesagents doctor. Обычно он сам называет проблему.

Нет tmux

Установите его через brew install tmux или sudo apt install tmux и снова запустите doctor.

Провайдера нет в списке

Обычно CLI не установлен или в нём не выполнен вход. Исправьте это и проверьте через reevesagents providers.

Web UI пишет, что не хватает пакетов

Живому терминалу нужны опциональные модули ws и @lydell/node-pty. Переустановите пакет глобально через npm или pnpm, и они вернутся.

Порт 8080 занят

Web UI переходит на следующий свободный порт и печатает URL. Свой порт можно задать так: reevesagents web --port 8090.

Нативная Windows

Полный продукт запускайте в WSL. Если нужно только управление агентами, reevesagents-win работает нативно как MCP-сервер.

Проверяемые данные

Период: 2025-04-14 по 2026-10-14. Данные GitHub и npm проверены 2026-10-15. Загрузки отражают обращения к пакетам.

Обновлено: