Ralph Loop

Ralph Loop — это автономный агентный движок, который берёт описание задачи на обычном языке — PRD, отчёт о баге, запрос на функцию — и выполняет её от начала до конца без вашего надзора.

На практике это выглядит так: вы пишете «создай REST API endpoint для аутентификации с JWT и добавь тесты» в файл, кладёте в папку Ralph и уходите. Ralph читает PRD, разбивает на шаги, открывает tmux-сессию, пишет код, запускает тесты, отслеживает расходы и отправляет сообщение в Telegram, когда готово — или когда застрял.

Ralph Loop отслеживает стоимость за запуск, автоматически останавливается при превышении бюджета и ведёт постоянный JSON-файл состояния, чтобы прерванные задачи можно было продолжить точно с того места. Встроенный circuit breaker предотвращает бесконечные циклы.

Навык создан из реального разочарования: AI-агенты, которые отлично работают на демо, но теряют нить через 10 минут. Ralph Loop решает это явным отслеживанием состояния, постоянством tmux-сессий и структурированным протоколом передачи между подзадачами.

Ralph Loop is an autonomous agent engine that takes a plain-language task description — a PRD, a bug report, a feature request — and executes it end-to-end without you watching over it.

Here's what that means in practice: you write "build a REST API endpoint for user authentication with JWT and add tests" in a file, drop it in the Ralph inbox, and walk away. Ralph reads the PRD, breaks it into steps, opens a tmux session, writes the code, runs the tests, tracks costs, and sends you a Telegram message when it's done (or when it gets stuck and needs a decision).

Ralph Loop tracks cost per run, stops automatically if a budget cap is hit, and keeps a persistent JSON state file so you can resume interrupted tasks exactly where they left off. A built-in circuit breaker prevents runaway loops — if Ralph detects it's going in circles, it stops and asks for guidance.

The skill was built out of real frustration: AI agents that work great on demos but lose track of what they're doing after 10 minutes. Ralph Loop solves that with explicit state tracking, tmux session persistence, and a structured handoff protocol between subtasks. Over 2,655 lines of battle-tested TypeScript, refined across 17 files and dozens of real production tasks.

If you use Claude Code or OpenClaw heavily and find yourself babysitting long-running tasks, Ralph Loop gives you your time back.