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

# Codex CLI Adapter

> Asset adapter for Codex CLI via AGENTS.md.

## Recommended: npm init

```bash theme={null}
cd your-project
npm install rstack-agents
npx rstack-agents init --framework custom --profile business-flex
```

`init` creates `.rstack/` and scaffolds `AGENTS.md`, `SOUL.md`, and `HEARTBEAT.md` from the package templates. Existing files are never overwritten.

## Manual asset copy (optional)

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

## AGENTS.md configuration

Run `init`, or copy the canonical templates:

```bash theme={null}
cp node_modules/rstack-agents/templates/bootstrap/AGENTS.md ./AGENTS.md
cp node_modules/rstack-agents/templates/bootstrap/SOUL.md ./SOUL.md
cp node_modules/rstack-agents/templates/bootstrap/HEARTBEAT.md ./HEARTBEAT.md
```

| File           | Purpose                                                             |
| -------------- | ------------------------------------------------------------------- |
| `AGENTS.md`    | Codex/universal bootstrap — asset paths, Node bridge, skill routing |
| `SOUL.md`      | Governance identity — team roles, contracts, evidence               |
| `HEARTBEAT.md` | Optional standby checks — approvals, budget, stalled tasks          |

The template includes a `## Skill routing` section that maps `.rstack/rstack.config.json` enabled domains and plugins to skill selection.

Then run Codex CLI from that project directory.