RStack can be installed in any AI coding environment.
Requirements
- Node.js >= 18.0.0
- npm >= 9.0.0
Recommended: one command for any framework
init sets up .rstack/, writes the active business profile and budget policy,
registers the project with the Business Hub, scaffolds bootstrap files
(SOUL.md, HEARTBEAT.md, and framework-specific CLAUDE.md or AGENTS.md),
writes the framework-specific glue,
and prints next steps — idempotent and non-destructive. New to your AI framework
itself? See
Install your framework for the
per-tool setup, then run the command above.
The sections below are the manual / asset-based paths. You only need them
for frameworks without a native adapter (Codex, Gemini, universal) or if you
prefer wiring assets yourself.
Business profiles
Choose the active project shape during init:
Profiles write .rstack/rstack.config.json and .rstack/budget.json. They guide enabled domains, plugin priority, dashboard pages, routing explanations, and budget envelopes. See Business Flex Profiles.
Pi — Native adapter (full-featured)
The native Pi adapter gives RStack lifecycle hooks, tool gating, session events, and the full governed harness.
Claude Code — Asset adapter
Recommended: npx rstack-agents init --framework claude-code scaffolds CLAUDE.md, SOUL.md, and HEARTBEAT.md automatically.
Manual asset copy (optional). Note: no rstack-agents command creates or
refreshes these copies — init does not write .claude/agents/rstack/ or
.claude/commands/rstack/. If you make them, they are unmanaged: re-copy
after upgrading the package. The supported Claude Code surface without them
is the bridge tools + the rstack-agents CLI + the settings hooks.
Or copy bootstrap templates from the package:
See the Claude Code adapter for full details.
Codex CLI — AGENTS.md adapter
Recommended: npx rstack-agents init --framework custom scaffolds AGENTS.md, SOUL.md, and HEARTBEAT.md.
Manual asset copy (optional):
See the Codex adapter for full details.
Gemini CLI — GEMINI.md adapter
Recommended: run init --framework custom, then copy GEMINI.md:
Manual asset copy (optional):
See the Gemini adapter for full details.
Universal — Asset-only mode
Use this when your framework can read files but has no native RStack adapter.
Bootstrap prompt for any agent:
Verify your installation
Expected output:
The catalog ships 196 agents, 68 skills, 72 plugins, 36 prompts. 