Overview

AutoRalph is an autonomous agent that watches Linear for assigned issues and drives them through a complete development lifecycle — from refinement and planning to building, opening pull requests, fixing CI failures, and addressing review feedback — without human intervention.

AutoRalph wraps Ralph's execution loop in a long-running daemon. It polls Linear for new issues, uses AI to refine requirements, creates workspaces, invokes Ralph to build features, opens GitHub pull requests, automatically fixes failing CI checks, responds to code review feedback, and marks issues as done when PRs are merged.

How It Works

   Linear                     AutoRalph                         GitHub
   ------                     ---------                         ------
  Assign issue  ------>  Poll & ingest (QUEUED)
                         AI refinement (REFINING)
                         Post questions to Linear
  User approves ------>  Detect approval (APPROVED)
                         Create workspace + PRD (BUILDING)
                         Run Ralph loop (stories, QA)
                         Push branch                  ------>  Create PR
                         Monitor checks               <------  Check results
                         Fix failing checks (FIXING_CHECKS)
                         Push fixes                   ------>  Checks re-run
                         Wait for review              <------  Review comments
                         Address feedback (ADDRESSING_FEEDBACK)
                         Push fixes                   ------>  Updated PR
                         Detect merge                 <------  PR merged
                         Cleanup workspace (COMPLETED)
  Move to Done  <------  Update Linear state

AutoRalph bridges three systems — Linear (issue tracking), your local codebase (via Ralph), and GitHub (code review and merging) — into a continuous autonomous workflow.

Prerequisites

  • Go 1.25+ (build from source)
  • Claude Code (claude CLI) installed and authenticated
  • git (workspace operations use worktrees)
  • Node.js 18+ (building the web dashboard)
  • A Linear account with an API key
  • A GitHub account with a personal access token or a GitHub App

To build from source, use mise to install Go, Node, and just: run mise install in the repo root (see mise.toml).

Installation

One-liner

curl -fsSL https://raw.githubusercontent.com/uesteibar/ralph/main/install-autoralph.sh | sh

This detects your OS and architecture, downloads the latest release from GitHub, verifies the SHA256 checksum, and installs to /usr/local/bin/.

From source

git clone https://github.com/uesteibar/ralph.git
cd ralph
mise install       # Install Go, Node, just
just web-build     # Build the React dashboard
just autoralph     # Build the Go binary

Verify

autoralph --version

What's Next