Документация
ИИ-помощники выполняют задачи программирования. Руководство описывает командную строку (CLI), меню терминала (TUI), инструмент tmux для непрерывной работы задач и стандартную связь между ИИ-инструментами (MCP).
Установка
Нужны macOS, Linux или WSL, Node 22.12 или новее, tmux 3.0 или новее и хотя бы один CLI провайдера, который установлен и в котором выполнен вход.
$ pnpm add -g reevesagents$ reevesagents doctor$ reevesagentsreevesagents doctor проверяет всё это. reevesagents setup выполняет те же проверки в виде мастера первого запуска, а с --attach ещё и подключает MCP ко всем установленным хостам.Быстрый старт
Запустите команду помощников, проверьте, как идут дела, вмешайтесь и остановите её.
Запустите команду
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.
Наблюдайте и направляйте
reevesagents runs
reevesagents peek api -n 40
reevesagents send api "run the tests"
reevesagents key api enter
reevesagents open apisend вставляет текст без отправки, поэтому следом выполните key <agent> enter. open переносит вас к помощнику в tmux.
Остановка
reevesagents stop "feature x" --yesstop, 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). Это необязательно. После подключения перезапустите инструмент.
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]], и первый агент становится ведущим. Флаги:
add [spec...]Добавляет агентов в последний активный run. Флаги:
runsВыводит список активных run’ов.
open <id>Переносит к окну run’а или агента в tmux. Принимает id, имя, псевдоним или однозначный префикс.
peek <agent-id>Показывает последние строки вывода одного агента.
stop <run-id>нужен Останавливает run и закрывает его сессию tmux.
kill <agent-id>нужен Останавливает одного агента. Run завершается вместе с последним активным агентом.
Управление помощником
send <agent-id> <text...>Вставляет текст в поле ввода агента без отправки.
key <agent-id> <key>Отправляет одну разрешённую клавишу: enter, escape, backspace, tab, space, up, down, left, right,
interrupt <agent-id>Отправляет
Записи и история
agents [run-id]Выводит список агентов во всех активных run’ах или в одном указанном run’е.
providersВыводит список провайдеров с их доступностью и известными моделями.
toolsВыводит список инструментов агента со статусом установки и входа.
delete <agent-id>нужен Удаляет запись о завершённом агенте.
delete-run <run-id>нужен Удаляет завершённый run.
historyВыводит архивную историю run’ов.
delete-history <id>нужен Удаляет одну запись из истории.
Подтверждения
approvalsВыводит список ожидающих запросов на подтверждение.
approve <approval-id> [note]Одобряет запрос на подтверждение.
deny <approval-id> [note]Отклоняет запрос на подтверждение.
Хосты MCP
hostsВыводит список хост-CLI с поддержкой MCP и состояние их подключения.
attach [cli]Подключает MCP к одному хост-CLI или ко всем установленным хостам через собственные команды хоста или его файл конфигурации.
detach <cli>Отключает MCP от одного хост-CLI через собственные команды хоста или его файл конфигурации.
mcpЗапускает MCP-сервер управления агентами через stdio. Эту команду выполняет сам хост-CLI.
Конфигурация и пресеты
config [key] [value]Показывает, читает или задаёт редактируемое поле конфигурации.
presetsВыводит список сохранённых пресетов.
save-preset <run-id> <name> [description...]Сохраняет активный run как пресет.
start-preset <name>Запускает run из пресета.
delete-preset <name>нужен Удаляет пресет.
Настройка и инструменты
setupПроверяет tmux, Node и установленные CLI при первом запуске.
doctorПроверяет окружение. При ошибке завершается с ненулевым кодом выхода.
skills [action]Устанавливает, удаляет или проверяет скилл ReevesAgents для CLI с поддержкой скиллов (install, remove, status; по умолчанию status).
reapЗавершает агентов, у которых пропало окно или превышен max_lifetime_ms, и закрывает осиротевшие сессии tmux.
webЗапускает на переднем плане Web UI, который слушает только loopback.
Инструменты 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,
interruptобязательныйagent_idОтправляет агенту
readобязательныйagent_idопциональныйlinesЧитает последние строки вывода панели без ANSI-последовательностей и с затёртыми секретами. По умолчанию 20 строк.
Просмотр
listВыводит список run’ов и агентов.
list_providersКаталог провайдеров и моделей на этой машине.
list_toolsКаталог инструментов этой машины: вспомогательные CLI, которые агент может запускать из своей оболочки, со статусом установки и входа.
list_historyАрхивные run’ы.
list_presetsСохранённые пресеты.
list_hostsCLI с поддержкой 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
Язык интерфейса, один из десяти кодов локали.
peek_interval_ms | 5000 | Сохранённая настройка интервала опроса. Текущие интерфейсы используют фиксированные интервалы обновления. |
peek_lines | 10 | Сохранённая настройка числа строк вывода. Текущие экраны и чтение через CLI/MCP используют своё число строк. |
max_agents | 100 | Лимит активных агентов на run при запуске через MCP spawn. Другие способы запуска его не проверяют. |
max_depth | 5 | Сохранённая настройка глубины рекурсии. Текущий движок run’ов её не применяет. |
ready_delay_ms | 5000 | Ожидание готовности нового CLI перед вставкой промпта. |
max_lifetime_ms | 0 | Завершает агентов, работающих дольше этого времени. 0 это отключает. |
default_permissions | ask | Режим разрешений по умолчанию для новых агентов: ask или skip. |
language | en | Язык интерфейса, один из десяти кодов локали. |
Состояние на диске
~/.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_CONFIGПереопределяет путь к файлу конфигурации.
REEVES_NO_TMUX_WRAPPER=1При значении 1 отключает автоматическое заворачивание TUI в сессию tmux.
REEVES_NO_COLOR=1При значении 1 отключает цвета TUI.
ALLOW_DESTRUCTIVE=1При значении 1 разрешает деструктивные команды без
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
| Провайдер | id | бинарник | рекомендуемые модели | Хост MCP |
|---|---|---|---|---|
| Claude CodeАгент для программирования от Anthropic в терминале | cc | claude | fable, opus, sonnet, haiku | ✔ |
| Codex CLICLI-агент для программирования от OpenAI | codex | codex | gpt-5.6-sol, gpt-5.5, gpt-5.4-mini | ✔ |
| OpenCode CLIОткрытый агент для программирования в терминале | 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-агент от 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 для программирования от Moonshot AI | kimi | kimi | kimi-code/k3, kimi-code/kimi-for-coding, kimi-code/kimi-for-coding-highspeed | ✔ |
| DeepSeek CLICLI для программирования от DeepSeek | deepseek | deepseek | deepseek-v4-pro, deepseek-v4-flash | |
| PiМинималистичная среда для программирования в терминале | pi | pi | sonnet, opus, deepseek/deepseek-chat, openai/gpt-4o | |
| Qwen CodeCLI-агент для программирования от Alibaba | qwen | qwen | qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next | ✔ |
| AiderПарное программирование с ИИ в терминале | aider | aider | sonnet, opus, haiku, deepseek/deepseek-chat | |
| Gemini CLIОткрытый терминальный агент от Google | gemini | gemini | gemini-3.1-pro-preview, gemini-3.5-flash, gemini-3.1-flash-lite | |
| Cline CLIАвтономный CLI-агент для программирования | cline | cline | anthropic/claude-sonnet-4-6, anthropic/claude-opus-4-8, google/gemini-3.1-pro | |
| CrushТерминальный агент для программирования от Charm | crush | crush | выбирается в самом CLI | |
| GooseОткрытый универсальный ИИ-агент | goose | goose | claude-sonnet-4-6, claude-opus-4-8, deepseek-v4-pro | |
| Kilo CodeОткрытый агент для программирования с CLI | kilo | kilo | kilo/~anthropic/claude-sonnet-latest, kilo/~anthropic/claude-opus-latest, kilo/~google/gemini-pro-latest, kilo/~openai/gpt-sol-latest | |
| Letta CodeАгент для программирования с долговременной памятью | letta | letta | zai-org/GLM-5.3-max, moonshotai/Kimi-K2-Instruct, Qwen/Qwen3-Coder-480B-A35B-Instruct | |
| Mistral VibeCLI-агент для программирования от Mistral | vibe | vibe | выбирается в самом CLI | |
| Grok BuildCLI-агент для программирования от xAI | grok | grok | grok-4.6, grok-4.5, grok-4.7 | |
| Kiro CLIАгентный CLI для программирования от AWS | kiro | kiro-cli | claude-sonnet-4.6, claude-opus-4.7, claude-opus-4.6 | |
| Factory DroidCLI-агент для программирования от Factory | droid | droid | выбирается в самом CLI | |
| Qoder CLIАгентный CLI для программирования от Qoder | qoder | qodercli | auto, performance, lite | |
| WarpАгент Warp в терминале | warp | warp | выбирается в самом CLI | |
| Junie CLICLI-агент для программирования от JetBrains | junie | junie | sonnet, opus, gpt-sol | |
| GitHub Copilot CLICLI-агент для программирования от GitHub | copilot | copilot | auto, gpt-5.4, claude-opus-4.8 | |
| Cursor CLICLI-агент для программирования от Cursor | cursor | cursor-agent | gpt-5, sonnet-4-thinking, claude-opus-4-8 | |
| Rovo Dev CLICLI-агент для программирования от Atlassian | rovo | acli | выбирается в самом CLI |
--effortзадаёт уровень рассуждений для Claude Code и Codex.--auth-mode api-keyдействует для Claude Code.- Любой другой флаг запуска передаётся через
--extra-args, например--remote-controlдля Claude Code. - Оставляйте запросы разрешений включёнными.
--skipотключает их в инструментах программирования.
Инструменты для агентов
Четыре вспомогательных CLI, которые агент может запускать из своей оболочки. Они не принимают задачи из чата, поэтому не относятся к запускаемым провайдерам. reevesagents tools показывает их вместе со статусом установки и входа.
Perplexity CLI
pplxВеб-поиск и фрагменты страниц от Perplexity в формате JSON.
Google Colab CLI
colabСреды выполнения с CPU, GPU и TPU в Google Colab: удалённый запуск скриптов и ноутбуков.
Скачивание и загрузка моделей и датасетов, запуск задач на Hugging Face Hub.
Ollama
ollamaЗапуск локальных и облачных моделей 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. Загрузки отражают обращения к пакетам.
Обновлено: