[codex] Document runtime invocation surfaces

[richard-devbot]

Closes #111

Summary

• Document Pi vs Claude Code vs CLI runtime differences.
• Document exact agent invocation model and enforcement boundaries.
• Add missing Pi decision/readiness tool references.
• Align public and Mintlify integration docs.

Validation

• node --test tests/validate-references.test.js
• node bin/rstack-agents.js validate

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
evoke-f0bfabff	🟢 Ready	View Preview	Jun 20, 2026, 2:42 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: af91be3b-ac22-4fd3-8d7d-7a4671594540

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/ble-0-runtime-docs-111

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}