CLI Reference

rstack-agents and the dashboard binaries — framework-neutral.

Overview

The rstack-agents CLI is framework-neutral and works in any environment. Use it to set up a project, launch the dashboard, test notifications, inspect assets, and validate the registry — without needing Pi or any other runtime.

npm install rstack-agents          # in your project
# or run any command via npx without installing:
npx rstack-agents <command>
# from a local checkout:
node bin/rstack-agents.js <command>

Commands

init

Set up RStack in the current project. Idempotent — never overwrites your files.

rstack-agents init                       # auto-detect the framework, default profile business-flex
rstack-agents init --framework pi        # pi | claude-code | operator | custom
rstack-agents init --profile lean-mvp    # business-flex | lean-mvp | enterprise-webapp
rstack-agents init --project ./apps/web  # target a different directory

Creates .rstack/, .rstack/rstack.config.json, .rstack/budget.json, registers the project with the Business Hub, writes framework-specific glue, and prints next steps.

---

hub

Ensure the Business Hub is running on :3008 and open it — the universal session-start entry point for any framework.

rstack-agents hub
rstack-agents hub --no-browser           # start/register without opening a tab
rstack-agents hub --project ./apps/web

---

notify

Inspect configured notification channels, or test them.

rstack-agents notify                     # list configured channels
rstack-agents notify --test              # send a test message to every channel

See Notifications & Webhooks.

---

list

List packaged assets by type.

rstack-agents list agents
rstack-agents list skills
rstack-agents list plugins

Example output:

$ rstack-agents list agents

196 agents found:

  core/
    orchestrator        → Team lead, routes lifecycle, manages approval gates
    builder             → Implementation agent with write permissions
    validator           → Read-only review agent

  sdlc/   (15 stages, 00–14)
    00-environment      → Detect tools, produce environment_report.json
    01-transcript       → Parse raw input into transcript.json
    02-requirements     → Extract requirements with acceptance criteria
    …
    14-cost-estimation  → Cloud cost forecast

---

add plugin

Copy a packaged domain plugin into your project.

rstack-agents add plugin backend-development
rstack-agents add plugin cloud-infrastructure

---

validate

Validate the packaged agent definitions — frontmatter, duplicate names, broken references, manifest integrity.

rstack-agents validate

Example output:

$ rstack-agents validate
[rstack] All 196 agents passed validation.

The catalog ships 196 agents, 156 skills, 72 plugins, 36 prompts.

The dashboard binaries

Binary	Purpose
rstack-business	Run the Business Hub server directly: rstack-business --port 3008 --project .
rstack-observer	Compatibility alias that opens the same Business Hub
rstack-operator-bridge	Node bridge the Operator (Python) adapter shells out to per tool call

npm scripts

npm test          # run the test suite
npm run validate  # rstack-agents validate
npm run lint      # ESLint src/, bin/, tests/