RP1 is a CLI tool that integrates with AI coding assistants (Claude Code, OpenCode, Codex CLI) to enable single-pass task completion through constitutional prompts, codebase awareness, and structured workflows. It helps developers ship features, investigate bugs, review PRs, and onboard teammates with validated, context-aware AI assistance.
Ready Player One - stop prompting; start shipping
35Stars
7Forks
25Open issues
TypeScript Apache-2.0 v0.7.12 Updated 5 days ago
README
Why rp1?
Single-pass execution — Constitutional prompts encode expert patterns with built-in rules. No iteration loops, no "let me revise that" — tasks complete in one shot.
Codebase awareness — Run knowledge-build once. Your architecture becomes context for every command. No generic advice — everything respects your patterns.
Lean context architecture — Progressive disclosure and subagent delegation keep your main thread focused. Complex work happens in specialized agents, results flow back clean.
Validate before you build — Hypothesis testing catches bad assumptions early. Design decisions get validated against your codebase before implementation begins.
Start anywhere — Full blueprints with charters and PRDs, or jump straight in with a vague idea. Structured when you need it, flexible when you don't.
Quick Start
1. Install the CLI
# macOS / Linux (Homebrew)
brew install rp1-run/tap/rp1
rp1 install
# Windows (Scoop)
scoop bucket add rp1 https://github.com/rp1-run/scoop-bucket
scoop install rp1
rp1 install
# Or use the install script
curl -fsSL https://rp1.run/install.sh | sh
Homebrew and Scoop install the rp1 CLI binary. Run rp1 install next to install integrations into detected host tools, then run rp1 verify to confirm the installation. The standalone install script already attempts the rp1 install step automatically.
2. Initialize your project
cd your-project
rp1 init
This will set up rp1 and install plugins for your AI assistant (Claude Code, OpenCode, or Codex CLI).
3. Restart your AI tool and run
/knowledge-build # Generate your codebase knowledge base
Beta Releases
Want to try upcoming features before they're officially released?
Install Beta
brew install rp1-run/tap/rp1-beta
rp1 install
Note: You cannot have both stable and beta installed simultaneously. Installing one requires uninstalling the other first.
Verify
rp1 --version
# Should show a pre-release version like 0.7.0-beta.1
Rollback to Stable
brew uninstall rp1-beta && brew install rp1-run/tap/rp1
rp1 install
What Can You Do?
Ship a feature
/build user-auth
Review a PR
/pr-review "feature/auth"
Investigate a bug
/code-investigate "bug-123" "Login fails intermittently"
Quick code check
/code-check
Principles
| Batteries Included | Skills, subagents, and finely-tuned prompts ship out of the box. No assembly required. |
| Always Open Source | Fully pluggable into existing agentic tools. Your workflows, your control. |
| Visual-First | Heavily leans on visual language — diagrams, charts, and structured outputs for clarity. |
| Continuous Evolution | Keep improving and adapting as frontier models mature. Today's best, tomorrow's baseline. |
| Model/Tool Agnostic | No lock-in to any frontier lab or platform. Works with Claude Code, OpenCode, Codex CLI, and more coming. |
Platform Support
| Platform | Status |
|---|---|
| Claude Code | Available |
| OpenCode | Experimental |
| Codex CLI | Experimental |
| Cursor, Goose, Amp | Coming Soon |
Guides
- Feature Development — End-to-end workflow from requirements to verified implementation
- Bug Investigation — Systematic root cause analysis with evidence-based hypothesis testing
- PR Review — Thorough multi-pass analysis with visual diagrams
- Team Onboarding — Get new developers productive on your codebase fast
Contributing
See CONTRIBUTING.md for contributor setup, validation, and PR expectations. See the documentation for public guides and reference material.
License
Apache 2.0 — See LICENSE
Comments (0)
Sign in to join the discussion.
No comments yet
Be the first to share your take.