ridgeline

library0.8.2jsnpmunverified

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.

llm-agents devops workflow

npm install ridgeline

package ↗homepage ↗

INSTALL

IMPORT

SIG · RIDGELINE

ridgeline

llm-agentsjavascriptv0.8.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ridgeline (CLI)

✓ npm install -g ridgeline && ridgeline <command>

✗ npx ridgeline

Ridgeline is a CLI tool not a library; install globally. npx may work but global install is recommended for consistent sandboxing setup.

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"

ridgeline --version

Debug

Known issues

breakingNode.js version must be >=20.0.0

fix

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

affects: >=0.0.0

breakingPlaywright peer dependency: >=1.57.0 <2.0.0

fix

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

affects: >=0.0.0

breakingWindows is not supported

fix

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

affects: >=0.0.0

deprecatedResearch 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.

affects: >=0.8.0

gotchaSandboxing 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.

affects: >=0.8.0

Errors

Common errors & fixes

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

Missing peer dependency playwright.

fix

npm install -g playwright

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

Node.js version below 20.

fix

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

ridgeline: command not found

Ridgeline not installed globally.

fix

npm install -g ridgeline

Upgrade

Version history

0.8.2latest on npm

Audit

Dependencies

playwrightrequiredPeer dependency for browser automation during agent execution

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/ridgeline ↗

homepagehttps://ridgeline.dev ↗