Ridgeline

0.8.2 verified Sat Apr 25 auth: no javascript

Ridgeline is a command-line build harness for decomposing large software ideas into phased builds executed by AI agents. Current version 0.8.2, updated frequently. It orchestrates a multi-agent pipeline (shaper, designer, specifier, researcher, refiner, planner, builder, reviewer) driven by the Claude CLI. Key differentiators: ensemble-based spec/plan generation with multiple specialist agents, built-in sandboxing via Greywall or bubblewrap, resumable execution with git checkpoints and phase-level retry. Requires Node >=20, Playwright >=1.57, and the Claude CLI. macOS and Linux only; no Windows support.

Common errors

error Error: Playwright is not installed. Please install Playwright >=1.57.0. ↓

cause Missing peer dependency playwright.

fix

npm install -g playwright

error Error: Node.js version must be >=20.0.0. Current version: v18.x.x ↓

cause Node.js version below 20.

fix

Upgrade Node.js to 20 or higher using nvm or your package manager.

error ridgeline: command not found ↓

cause Ridgeline not installed globally.

fix

npm install -g ridgeline

Warnings

breaking Node.js version must be >=20.0.0 ↓

fix Install Node.js 20 or later via nvm or your package manager.

breaking Playwright peer dependency: >=1.57.0 <2.0.0 ↓

fix Run 'npm install -g playwright' to install the correct version.

breaking Windows is not supported ↓

fix Use macOS or Linux. Consider WSL2 on Windows as a possible workaround.

deprecated Research step: --quick single-agent mode replaces older multi-agent default ↓

fix Use 'ridgeline research --quick' instead of the default ensemble mode for faster single-agent research.

gotcha Sandboxing is on by default and will fail if Greywall or bubblewrap is not installed ↓

fix Install Greywall (macOS/Linux) or bubblewrap (Linux) or set RIDGELINE_SANDBOX=0 to disable.

Install

npm install ridgeline

yarn add ridgeline

pnpm add ridgeline

Imports

ridgeline (CLI)
wrong
```
npx ridgeline
```
correct
```
npm install -g ridgeline && ridgeline <command>
```
Ridgeline is a CLI tool not a library; install globally. npx may work but global install is recommended for consistent sandboxing setup.

Quickstart

Auto-advances through the full pipeline (shape, spec, plan, build) for a feature named 'my-feature'.

ridgeline my-feature "Build a REST API for task management"