ralph-starter CLI
CLI запускает автономные циклы кодинга: спецификация из GitHub, Linear или Notion, агент работает до результата.
- 107 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент в цикле автономно меняет код, делает коммиты и открывает «pull request», расходуя токены.
- Для Figma, Notion и Linear нужны токены доступа.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ralph-starterОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент в цикле автономно меняет код, делает коммиты и открывает «pull request», расходуя токены.
- Для Figma, Notion и Linear нужны токены доступа.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ralph-starter запускает кодинг-агента (Claude Code, Cursor, Copilot, Gemini CLI и другие) в цикле и скармливает ему ошибки, пока задача не выполнена. Спецификацию команда берет из задач GitHub, тикетов Linear, страниц Notion, дизайнов Figma, адресов URL или локальных файлов. Примеры: `ralph-starter run --from github --project myorg/myrepo --label "ready"` или `ralph-starter run "build a todo app with React" --commit`. Без аргументов запускается мастер, который выясняет идею и стек, а `ralph-starter ideas` помогает придумать проект. Есть 16 и больше пресетов режимов, среди них `feature`, `tdd`, `debug` и `review`. Предохранители включают размыкатель цепи, который останавливает застрявший цикл, ограничитель частоты и учет стоимости. После каждой итерации можно запускать тесты, линтер и сборку, а коммиты и «pull request» создаются автоматически.
Для кого. Разработчикам, которые отдают агенту задачи из трекера целиком и хотят цикл с остановкой, проверкой и учетом стоимости.
Подходит, если
- Из задач GitHub с меткой `ready` нужно собрать работающую функцию.
- Спецификация лежит в Notion или Figma, и ее берут оттуда напрямую.
- После каждой итерации агента нужно гонять тесты, линтер и сборку.
- Застрявший цикл должен остановиться по предохранителю, а расход токенов быть виден.
Не подходит, если
- Задача требует осторожных ручных правок: цикл меняет код автономно.
- Нельзя давать агенту право на коммиты и создание «pull request».
- Бюджет токенов жесткий, а цикл повторяет вызовы до результата.
Пример запроса к агенту
Возьми задачи из GitHub с меткой `ready`, запусти цикл в отдельной ветке с проверкой тестов и покажи итоговую стоимость.Ограничения
Цикл меняет код без вмешательства и может расходовать много токенов: следите за счетчиком стоимости, ставьте ограничения и работайте в ветке под контролем версий. Параметры `--commit` и `--pr` создают коммиты и «pull request» сами, для PR нужен `gh`. Для разных источников нужны токены: Figma требует `FIGMA_TOKEN`, Notion для закрытых страниц, GitHub и Linear работают через свои CLI или ключи API. Нужны Node.js 18 и новее, Git и хотя бы один установленный кодинг-агент. Качество результата определяется агентом и спецификацией, а цикл не гарантирует, что задача выполнена верно.
Как отключить. Удалите CLI командой `npm uninstall -g ralph-starter`, а плагин Claude Code отключите через `/plugin`. Токены Figma и Notion отзовите в их настройках.
Частые вопросы
Как установить ralph-starter?
Выполните `npm install -g ralph-starter`. Нужны Node.js 18 и новее, Git и хотя бы один кодинг-агент вроде Claude Code или Cursor.
Какие источники спецификаций поддерживаются?
GitHub (через `gh` или токен), Linear, Notion, Figma, любые URL с Markdown или HTML и локальные файлы Markdown и PDF.
Как проверить подключение к источнику?
Командами `ralph-starter integrations list`, `ralph-starter integrations test github` и `ralph-starter integrations fetch github owner/repo`.
Как остановить застрявший цикл?
Его останавливает размыкатель цепи после повторных неудач. Расход контролируют ограничитель частоты и учет стоимости, а проверки после итераций включает `--validate`.
Что такое техника Ральфа?
Это паттерн автономного кодинга: агент работает в цикле, получает обратно ошибки и повторяет попытки, пока задача не выполнена. Ее описал Джеффри Хантли.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI, который прогоняет Claude Code, Codex, OpenCode и другие агенты циклом по списку задач или PRD, пока все не будет сделано
CLI, который берет тикеты из GitHub, Linear или Jira, пишет код через Claude Code и открывает запрос на слияние для вашего ревью
Оркестратор для Claude Code, Codex и Gemini CLI: сценарии на YAML повторяются, пока проходят ваши проверки
Раннер @itsaplan/runner берет задачи у трекера It's a Plan и отдает их Claude Code, Codex или opencode на вашей машине.
Фоновый агент для задач из Linear, GitHub, GitLab и Slack: скилл «/cyrus-setup» проведет установку от зависимостей до запуска.
Telegram-бот управляет Claude Code на вашем компьютере: пишете в чат, а агент правит проект и стримит ответ.
Коротко о README
ralph-starter оборачивает технику цикла агента в готовый CLI: источники спецификаций, пресеты режимов, предохранители, проверки и автоматизация git.