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
cd your-project
npm install rstack-agents
npx rstack-agents init --profile business-flex # auto-detects pi | claude-code | operator | custom
init sets up .rstack/, writes the active business profile and budget policy,
registers the project with the Business Hub, 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:
npx rstack-agents init --profile business-flex
npx rstack-agents init --profile lean-mvp
npx rstack-agents init --profile enterprise-webapp
.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.
# Install from npm
pi install npm:rstack-agents
# Install from local checkout
pi install /path/to/SDLC-rstack
# One-off run without installing
pi -e /path/to/SDLC-rstack/extensions/rstack-sdlc.ts
Claude Code — Asset adapter
export RSTACK_HOME=/path/to/SDLC-rstack
mkdir -p .claude/agents/rstack .claude/commands/rstack .rstack/vendor/rstack
cp -R "$RSTACK_HOME/agents" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/skills" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/plugins" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/prompts" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/agents"/* .claude/agents/rstack/
cp "$RSTACK_HOME/prompts"/*.md .claude/commands/rstack/ 2>/dev/null || true
CLAUDE.md:
# RStack SDLC
Use RStack SDLC from `.rstack/vendor/rstack`.
Start with `.rstack/vendor/rstack/agents/core/orchestrator.md`.
Use `.rstack/vendor/rstack/agents/core/builder.md` for implementation.
Use `.rstack/vendor/rstack/agents/core/validator.md` for verification.
Write all run state under `.rstack/runs/<run_id>/`.
Require specs, approvals, traceability, `builder.json`, and `validation.json`.
Never claim DONE without evidence.
Codex CLI — AGENTS.md adapter
export RSTACK_HOME=/path/to/SDLC-rstack
mkdir -p .rstack/vendor/rstack
cp -R "$RSTACK_HOME/agents" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/skills" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/plugins" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/prompts" .rstack/vendor/rstack/
cat > AGENTS.md <<'EOF'
# RStack SDLC
Use RStack SDLC from `.rstack/vendor/rstack`.
Read `.rstack/vendor/rstack/agents/core/orchestrator.md` first.
For implementation, follow `.rstack/vendor/rstack/agents/core/builder.md`.
For verification, follow `.rstack/vendor/rstack/agents/core/validator.md`.
Use SDLC pipeline agents from `.rstack/vendor/rstack/agents/sdlc/`.
Write run state under `.rstack/runs/<run_id>/`.
Require specs, approval gates, traceability, builder contracts, and validation contracts.
EOF
Gemini CLI — GEMINI.md adapter
export RSTACK_HOME=/path/to/SDLC-rstack
mkdir -p .rstack/vendor/rstack
cp -R "$RSTACK_HOME/agents" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/skills" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/plugins" .rstack/vendor/rstack/
cp -R "$RSTACK_HOME/prompts" .rstack/vendor/rstack/
cat > GEMINI.md <<'EOF'
# RStack SDLC
Use RStack SDLC from `.rstack/vendor/rstack`.
Start with `.rstack/vendor/rstack/agents/core/orchestrator.md`.
Use the SDLC pipeline in `.rstack/vendor/rstack/agents/sdlc/`.
Maintain `.rstack/runs/<run_id>/` with specs, approvals, traceability, tasks, builder.json, and validation.json.
Do not perform destructive actions without explicit human approval.
Do not claim DONE without command evidence.
EOF
Universal — Asset-only mode
Use this when your framework can read files but has no native RStack adapter.
git clone https://github.com/richard-devbot/SDLC-rstack.git ~/rstack-agents
export RSTACK_HOME=~/rstack-agents
Use RStack SDLC from $RSTACK_HOME.
Read agents/core/orchestrator.md first.
Use agents/core/builder.md for implementation tasks.
Use agents/core/validator.md for read-only verification.
Use agents/sdlc/ for lifecycle routing.
Use skills/ and plugins/ only when relevant.
Write run state under .rstack/runs/<run_id>/.
Require specs, approvals, traceability, builder.json, validation.json, and command evidence.
Never claim DONE without evidence.
Verify your installation
# Check CLI is working
rstack-agents list agents
rstack-agents list skills
rstack-agents list plugins
rstack-agents validate
$ rstack-agents validate
[rstack] All 196 agents passed validation.
