Ralph

An autonomous coding agent loop. Ralph takes a feature description, breaks it into right-sized user stories, and implements them one by one — running quality checks and committing after each step — until the feature is done.

You work from your terminal. Ralph works in an isolated workspace.

This repository also contains AutoRalph — an autonomous daemon that watches Linear for assigned issues and drives them through a complete development lifecycle (refine, plan, build, open PR, address review feedback) using Ralph under the hood.

  • Getting Started — Prerequisites, installation, and a quick-start workflow
  • Workflow — The Ralph development loop: init, new, run, done
  • Commands — CLI command reference
  • Configuration — ralph.yaml reference and prompt customization
  • Setup — Setting up Ralph in an existing codebase
  • Architecture — Execution loop and workspace isolation

AutoRalph

  • Overview — What AutoRalph is and its capabilities
  • Lifecycle — Issue lifecycle and state transitions
  • Abilities — Refine, build, rebase, feedback, fix checks, complete
  • Configuration — Credentials, project configs, and options
  • Security — Trusted users, GitHub App auth, credential isolation
  • Dashboard — Web dashboard, REST API, and WebSocket protocol