Santander ralph CLI
Скрипт ralph на Bash и PowerShell гоняет кодирующий CLI в цикле, запуская новый сеанс с тем же промптом на каждой итерации.
- 99 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Агент работает в цикле без вашего подтверждения и меняет файлы проекта.
- Долгие прогоны расходуют много токенов.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/SantanderAI/ralph/main/install.sh | shУстановщик копирует `ralph-loop.sh` в `~/.local/bin` и ставит скиллы; флаг `--no-skills` пропускает скиллы.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент работает в цикле без вашего подтверждения и меняет файлы проекта.
- Долгие прогоны расходуют много токенов.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ralph — тонкая обертка на Bash без зависимостей вокруг CLI, которые уже стоят на машине: Codex, Claude Code, Gemini CLI и Devin CLI. Скрипт `ralph-loop.sh` на каждой итерации запускает новый сеанс агента с одним и тем же промптом, и работа накапливается в репозитории. Это техника Ральфа Виггама для долгих автономных прогонов. На каждом шаге скрипт ищет сигнальный файл `stop.md` и выходит, если он есть, перезагружает конфигурацию, запускает выбранный CLI и пишет журнал с отметкой времени в `.ralph/logs/` с ротацией. Вызов выглядит так: `ralph-loop.sh 25 prompt.md`, где первый аргумент задает число итераций. Установщик ставит скрипт в `~/.local/bin` и входящие в набор скиллы.
Для кого. Разработчикам, которые отдают агенту большую задачу на ночь и хотят автоматический перезапуск с чистым контекстом.
Подходит, если
- Большая задача разбита на шаги, и агент должен идти по ним без вашего участия.
- Контекст агента раздувается, и каждую итерацию нужно начинать заново.
- Нужно остановить цикл безопасно, положив в каталог файл `stop.md`.
- Один и тот же промпт надо запускать на Codex, Claude Code или Gemini CLI.
Не подходит, если
- Нет плана или заметок в репозитории: между итерациями память теряется.
- Работа требует вашего участия на каждом шаге.
- Агенту нельзя автономно менять файлы.
Пример запроса к агенту
Запусти ralph-loop.sh на 25 итераций с файлом prompt.md и остановись, если появится stop.md.Ограничения
Нужны Bash и хотя бы один CLI из `codex`, `claude`, `gemini`, `devin` в PATH. Каждая итерация идет как новый сеанс, поэтому вся непрерывность хранится в файлах рабочей папки: промпт должен велеть агенту читать план и двигаться по шагам. Автономные прогоны тратят токены и меняют файлы без вашего подтверждения, поэтому запускайте их на отдельной ветке и ставьте предел числа итераций. Последний коммит в репозитории сделан в октябре 2026 года.
Как отключить. Удалите `ralph-loop.sh` из `~/.local/bin`, скиллы из каталога скиллов агента и каталог `.ralph/` в проекте.
Частые вопросы
Как поставить?
Командой `curl -fsSL https://raw.githubusercontent.com/SantanderAI/ralph/main/install.sh | sh` или скопировав `ralph-loop.sh` в PATH. Для Windows есть установщик PowerShell.
Как остановить цикл?
Создайте в рабочей папке файл `stop.md`: скрипт проверяет его перед каждой итерацией и завершается чисто.
Какие CLI поддерживаются?
Codex, Claude Code, Gemini CLI и Devin CLI. Выбор задается переменной `RALPH_TOOL`.
Где журналы?
В каталоге `.ralph/logs/` с отметками времени и ротацией старых файлов.
Как запустить?
Командой `ralph-loop.sh MAX_ITERATIONS PROMPT_FILE`, например `ralph-loop.sh 25 prompt.md`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыBash-цикл, который заново запускает Claude Code или Amp с чистым контекстом, пока все истории из PRD не пройдут проверки, и два скилла для PRD
Терминальная панель на Go: гоняет Claude Code по списку задач из prd.md с чистым контекстом и коммитом на каждую
Плагин для Claude Code и Codex: превращает запрос на фичу в спецификацию и выполняет ее по задачам с чистым контекстом
Скилл учит Claude Code и Codex работать в общем терминале con: видеть панели, запускать команды на виду, вести воркеров
CLI на Rust с терминальным переключателем между кодинг-агентами: список, проверка готовности, выбор активного, предпросмотр команд
Набор slash-команд, скиллов и субагентов для Claude Code: ревью, тесты, безопасность, релизы, документация и синхронизация GitHub с Linear
Коротко о README
В описании объяснены цикл работы скрипта, требования и способы установки. Настройки перезагружаются на лету, а прогон оставляет журнал. Проект выпущен Santander AI Lab с открытым исходным кодом.