Ralph TUI CLI
Терминальная панель, которая ведет Claude Code, Codex и еще пять агентов по списку задач циклом, пока список не закончится
- 2 461 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Запускает кодинг-агентов в автономном цикле: они правят файлы и выполняют команды в проекте без подтверждения каждой итерации
- Может коммитить сам, если включен автокоммит, и создает рабочие деревья и ветки сессии
- Расходует токены и деньги по тарифу подключенного агента, пока цикл идет
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ralph-tuiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Запускает кодинг-агентов в автономном цикле: они правят файлы и выполняют команды в проекте без подтверждения каждой итерации
- Может коммитить сам, если включен автокоммит, и создает рабочие деревья и ветки сессии
- Расходует токены и деньги по тарифу подключенного агента, пока цикл идет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ralph TUI запускает ИИ-агента в цикле по списку задач и показывает ход работы в терминальном интерфейсе. На каждой итерации он выбирает задачу с наивысшим приоритетом, собирает промпт, запускает агента, определяет завершение и переходит к следующей. Поддерживаются Claude Code, OpenCode, Factory Droid, Cursor CLI, Gemini CLI, Codex и Kiro CLI, задачи берутся из файла prd.json или из трекера Beads с зависимостями. Установка идет через Bun: `bun install -g ralph-tui`. Дальше `ralph-tui setup` настраивает проект, `ralph-tui create-prd --chat` помогает составить PRD вместе с агентом, а `ralph-tui run --prd ./prd.json` запускает цикл. Флаги задают агента и модель (`--agent claude --model sonnet`), число итераций, безголовый режим `--headless` и песочницу `--sandbox` на `bwrap` в Linux или `sandbox-exec` в macOS. Сессию можно поставить на паузу и продолжить, она переживает сбои, а `ralph-tui resume` возвращает прерванный запуск. Панель показывает вывод агента, дерево вложенных агентов, ветку git, режим автокоммита и состояние песочницы. Параллельный режим ведет несколько эпиков Beads в одной сессии с общей веткой, очередью слияния и рабочими деревьями на каждую задачу. Скиллы ralph-tui-prd, ralph-tui-create-json и ralph-tui-create-beads доступны и прямо в агенте, их ставит `ralph-tui skills install`.
Для кого. Разработчикам, которые отдают Claude Code или Codex целый список задач на ночь и хотят видеть ход работы, ставить на паузу и возвращаться к сессии.
Подходит, если
- PRD готов, а задач в нем десять: `ralph-tui run --prd ./prd.json` проходит их по приоритету, пока список не опустеет
- Два эпика Beads идут параллельно: `--parallel --epic ui-epic --epic backend-epic` держит одну сессию с рабочими деревьями на задачу
- Агент упал посреди прогона: сессия сохранена, и `ralph-tui resume` продолжает с места остановки
- За ходом работы надо следить глазами: панель показывает вывод агента, дерево вложенных агентов и состояние git
- Агентов несколько, на разных машинах: удаленные экземпляры собираются во вкладки одного терминала
Не подходит, если
- Нужна одна короткая правка: цикл с PRD и трекером избыточен для такой задачи
- Задачи не оформлены ни в prd.json, ни в Beads: Ralph идет по готовому списку и работу не придумывает
- На Linux не установлен `bwrap`: песочница `--sandbox` без него не запустится
- Агент нужен в живом диалоге: Ralph запускает его по одной задаче за итерацию
Пример запроса к агенту
Составь PRD для страницы настроек профиля, преврати его в prd.json и запусти `ralph-tui run --prd ./prd.json --iterations 5` с агентом claudeОграничения
- Ставится через Bun. Поддерживаются семь агентов из списка в README и два трекера: файл prd.json и Beads.
- Режим `--sandbox` требует установленного `bwrap` в Linux, в macOS работает встроенный `sandbox-exec`.
- Настройка автокоммита видна на панели: решите заранее, коммитить ли агенту самому.
- Параллельный режим ведет эпики одной сессии с одним планировщиком и блокировкой репозитория.
- Конфигурация лежит в `.ralph-tui/config.toml` проекта или в `~/.config/ralph-tui/config.toml`, а собственные PRD-скиллы подключают параметром `skills_dir`.
Как отключить. Удалите утилиту командой `bun remove -g ralph-tui`. Скиллы, поставленные `ralph-tui skills install`, лежат в каталоге навыков агента: удалите оттуда папки с префиксом `ralph-tui-`.
Частые вопросы
Как запустить Ralph TUI с Claude Code?
Поставьте утилиту `bun install -g ralph-tui`, выполните `ralph-tui setup` в проекте и запустите `ralph-tui run --prd ./prd.json --agent claude`. Файл prd.json получают из PRD командой `ralph-tui convert` или скиллом ralph-tui-create-json.
Чем Ralph TUI отличается от `ralph-orchestrator` и `ralphy`?
Ralph TUI строит вокруг цикла терминальную панель: вывод агента, пауза, возобновление сессии и вкладки удаленных машин. Задачи он берет из PRD или Beads по приоритету.
Какие трекеры задач поддерживаются?
Два: простой файл prd.json и Beads, трекер на основе git с зависимостями между задачами. Параллельный режим работает на иерархии эпиков Beads.
Безопасно ли запускать Ralph без присмотра?
Флаг `--sandbox` изолирует агента с помощью `bwrap` в Linux или `sandbox-exec` в macOS, а `--iterations` ограничивает число итераций. Без песочницы агент работает с правами вашего пользователя, как при обычном запуске.
Какие агенты поддерживает Ralph TUI?
Claude Code, OpenCode, Factory Droid, Cursor CLI, Gemini CLI, Codex и Kiro CLI. Агента и модель выбирают флагами `--agent` и `--model` или клавишей `a` в панели.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЦикл Ральфа для длинных задач: агент в песочнице Docker идет по списку задач из PRD, проверяет каждую тестами и коммитит, пока список не кончится
Команда ralph повторяет один промпт для Claude Code, Codex, Cursor Agent или OpenCode, пока в ответе не появится метка завершения
CLI-оркестратор, который прогоняет Claude Code, Codex, Gemini CLI и другие агенты по циклу до готовности задачи и блокирует неполную работу тестами и линтером
CLI ставит в проект планирование BMAD и цикл Ralph: сначала роли BMAD пишут PRD и истории, потом агент реализует их по тестам
Автономный цикл разработки по спецификациям: агент берет задачу, сверяет критерии приемки и коммитит, пока список не кончится.
Автономное выполнение плана по задачам: каждая задача в свежем сеансе Claude Code или Codex, затем многопроходное ревью. Написан на Go
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Ralph TUI (эта карточка) | нет | 2 461 | ||
| Ralph Orchestrator | нет | не нужна | 3 194 | оркестратор, который блокирует неполную работу тестами и линтером; Ralph TUI делает упор на панель управления и сессии |
| Ralphy | нет | 2 982 | прогоняет агентов по списку задач или PRD; Ralph TUI добавляет панель с паузой, возобновлением и вкладками удаленных машин | |
| Open Ralph Wiggum | нет | 1 908 | повторяет один промпт до метки завершения, а Ralph TUI берет задачи по очереди из PRD или Beads |
Коротко о README
README открывается быстрым стартом из четырех команд и ссылками на документацию на ralph-tui.com. Дальше идут схема цикла из пяти шагов, список возможностей, таблица команд, горячие клавиши панели, опции тем оформления и раздел об управлении удаленными экземплярами. Завершают страницу команды разработки на Bun и лицензия MIT.