Quickstart

RStack plugs into the AI coding framework you already use. The fastest path is the same for everyone. No framework installed yet? The repo’s RStack in 5 Minutes walks the same journey from a bare terminal via the bridge.

Install RStack in your project

cd your-project
npm install rstack-agents

Set it up for your framework and business profile

npx rstack-agents init --profile business-flex

init auto-detects your framework (Pi, Claude Code, Operator, or custom), creates the .rstack/ state directory, writes .rstack/rstack.config.json and .rstack/budget.json, registers the project with the Business Hub, writes framework-specific glue, and prints your next steps. Running it twice is safe — it never overwrites your files.Force a specific framework or profile:

npx rstack-agents init --framework pi --profile business-flex
npx rstack-agents init --profile lean-mvp
npx rstack-agents init --profile enterprise-webapp

Start a governed run from your agent session

sdlc_start(goal="Build a checkout flow with Stripe, tests, and release readiness")
sdlc_clarify()
sdlc_plan()

Approve the gates, then build

sdlc_approve(artifact="plan.md", status="APPROVED")
sdlc_approve(artifact="requirements.json", status="APPROVED")
sdlc_approve(artifact="architecture.md", status="APPROVED")
sdlc_build_next()
sdlc_validate()

Watch it live in the Business Hub

The dashboard opens automatically when your session starts. Bring it up any time from any framework:

npx rstack-agents hub

Open http://localhost:3008 — runs, the Studio live agent view, approvals, and traceability.

New to your AI framework too? Start with Install your framework — it covers installing Pi, Claude Code, Codex CLI, Gemini CLI, and Operator first, then adding RStack.

What `init` created

your-project/
├── .rstack/
│   ├── runs/                 # every governed run lands here
│   ├── rstack.config.json     # active profile, enabled domains/plugins, pages
│   ├── budget.json            # run budget, thresholds, stage budget envelopes
│   ├── registry/              # agent / skill / plugin catalog
│   └── policy.json            # (optional) approval policy you control
└── .claude/rstack-sdlc.md    # (claude-code only) usage guide + session hook

Every run is inspectable, resumable, and auditable. See Your first run for the full walkthrough.

Pick your path

Install your framework

Pi, Claude Code, Codex, Gemini CLI, Operator — step by step.

Your first run

Clarify → plan → approve → build → validate, explained.

The Business Hub

The live dashboard, Studio 3D, Business Flex, and team views.

Business Flex profiles

Select only the teams, plugins, budget guardrails, and dashboard pages a request needs.

Builder & validator sandbox

Scoped builder packets, read-only validator packets, and Contract v2 telemetry.

Notifications

Slack, Teams, Discord, Telegram, WhatsApp.

Overview

Getting Started

Core Concepts

The Pipeline

Business Hub

Adapters

Security & Compliance

Roadmap & Research

What `init` created

Pick your path

Install your framework

Your first run

The Business Hub

Business Flex profiles

Builder & validator sandbox

Notifications

​What init created

​Pick your path

Install your framework

Your first run

The Business Hub

Business Flex profiles

Builder & validator sandbox

Notifications

What `init` created

Pick your path