{"id":18757,"library":"ridgeline","title":"Ridgeline","description":"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.","status":"active","version":"0.8.2","language":"javascript","source_language":"en","source_url":null,"tags":["javascript"],"install":[{"cmd":"npm install ridgeline","lang":"bash","label":"npm"},{"cmd":"yarn add ridgeline","lang":"bash","label":"yarn"},{"cmd":"pnpm add ridgeline","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency for browser automation during agent execution","package":"playwright","optional":false}],"imports":[{"note":"Ridgeline is a CLI tool not a library; install globally. npx may work but global install is recommended for consistent sandboxing setup.","wrong":"npx ridgeline","symbol":"ridgeline (CLI)","correct":"npm install -g ridgeline && ridgeline <command>"}],"quickstart":{"code":"ridgeline my-feature \"Build a REST API for task management\"","lang":"javascript","description":"Auto-advances through the full pipeline (shape, spec, plan, build) for a feature named 'my-feature'."},"warnings":[{"fix":"Install Node.js 20 or later via nvm or your package manager.","message":"Node.js version must be >=20.0.0","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Run 'npm install -g playwright' to install the correct version.","message":"Playwright peer dependency: >=1.57.0 <2.0.0","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Use macOS or Linux. Consider WSL2 on Windows as a possible workaround.","message":"Windows is not supported","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Use 'ridgeline research --quick' instead of the default ensemble mode for faster single-agent research.","message":"Research step: --quick single-agent mode replaces older multi-agent default","severity":"deprecated","affected_versions":">=0.8.0"},{"fix":"Install Greywall (macOS/Linux) or bubblewrap (Linux) or set RIDGELINE_SANDBOX=0 to disable.","message":"Sandboxing is on by default and will fail if Greywall or bubblewrap is not installed","severity":"gotcha","affected_versions":">=0.8.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"npm install -g playwright","cause":"Missing peer dependency playwright.","error":"Error: Playwright is not installed. Please install Playwright >=1.57.0."},{"fix":"Upgrade Node.js to 20 or higher using nvm or your package manager.","cause":"Node.js version below 20.","error":"Error: Node.js version must be >=20.0.0. Current version: v18.x.x"},{"fix":"npm install -g ridgeline","cause":"Ridgeline not installed globally.","error":"ridgeline: command not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}