> ## Documentation Index
> Fetch the complete documentation index at: https://evoke-f0bfabff.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
rstack-agents notify                     # list configured channels
rstack-agents notify --test              # send a test message to every channel
```

See [Notifications & Webhooks](/reference/webhooks).

***

### `list`

List packaged assets by type.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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

```bash theme={null}
npm test          # run the test suite
npm run validate  # rstack-agents validate
npm run lint      # ESLint src/, bin/, tests/
```