$git clone https://github.com/rp1-run/rp1---
| 1 | <p align="center"> |
| 2 | <picture> |
| 3 | <source media="(prefers-color-scheme: dark)" srcset="docs/assets/rp1-lockup-light.svg"> |
| 4 | <source media="(prefers-color-scheme: light)" srcset="docs/assets/rp1-lockup-dark.svg"> |
| 5 | <img src="docs/assets/rp1-lockup-dark.svg" alt="rp1" width="320"> |
| 6 | </picture> |
| 7 | </p> |
| 8 | |
| 9 | <h1 align="center">Ready Player One</h1> |
| 10 | |
| 11 | <p align="center"> |
| 12 | <strong>> stop prompting; start shipping</strong> |
| 13 | </p> |
| 14 | |
| 15 | <p align="center"> |
| 16 | <!-- x-release-please-start-version --> |
| 17 | <a href="https://github.com/rp1-run/rp1/releases"><img src="https://img.shields.io/static/v1?label=rp1-base&message=v0.7.12&color=blue" alt="rp1-base"></a> |
| 18 | <a href="https://github.com/rp1-run/rp1/releases"><img src="https://img.shields.io/static/v1?label=rp1-dev&message=v0.7.12&color=blue" alt="rp1-dev"></a> |
| 19 | <!-- x-release-please-end --> |
| 20 | <a href="https://rp1.run"><img src="https://img.shields.io/badge/docs-rp1.run-blue" alt="Docs"></a> |
| 21 | <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-green.svg" alt="License"></a> |
| 22 | </p> |
| 23 | |
| 24 | <p align="center"> |
| 25 | Professional development workflows for AI coding assistants.<br> |
| 26 | Structured commands. Specialized agents. Single-pass execution.<br> |
| 27 | Works today with <strong>Claude Code</strong>. Experimental support for <strong>OpenCode</strong> and <strong>Codex CLI</strong>. |
| 28 | </p> |
| 29 | |
| 30 | --- |
| 31 | |
| 32 | ## Why rp1? |
| 33 | |
| 34 | **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. |
| 35 | |
| 36 | **Codebase awareness** — Run `knowledge-build` once. Your architecture becomes context for every command. No generic advice — everything respects your patterns. |
| 37 | |
| 38 | **Lean context architecture** — Progressive disclosure and subagent delegation keep your main thread focused. Complex work happens in specialized agents, results flow back clean. |
| 39 | |
| 40 | **Validate before you build** — Hypothesis testing catches bad assumptions early. Design decisions get validated against your codebase before implementation begins. |
| 41 | |
| 42 | **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. |
| 43 | |
| 44 | --- |
| 45 | |
| 46 | ## Quick Start |
| 47 | |
| 48 | ### 1. Install the CLI |
| 49 | |
| 50 | ```bash |
| 51 | # macOS / Linux (Homebrew) |
| 52 | brew install rp1-run/tap/rp1 |
| 53 | rp1 install |
| 54 | |
| 55 | # Windows (Scoop) |
| 56 | scoop bucket add rp1 https://github.com/rp1-run/scoop-bucket |
| 57 | scoop install rp1 |
| 58 | rp1 install |
| 59 | |
| 60 | # Or use the install script |
| 61 | curl -fsSL https://rp1.run/install.sh | sh |
| 62 | ``` |
| 63 | |
| 64 | 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. |
| 65 | |
| 66 | ### 2. Initialize your project |
| 67 | |
| 68 | ```bash |
| 69 | cd your-project |
| 70 | rp1 init |
| 71 | ``` |
| 72 | |
| 73 | This will set up rp1 and install plugins for your AI assistant (Claude Code, OpenCode, or Codex CLI). |
| 74 | |
| 75 | ### 3. Restart your AI tool and run |
| 76 | |
| 77 | ```bash |
| 78 | /knowledge-build # Generate your codebase knowledge base |
| 79 | ``` |
| 80 | |
| 81 | **[Full installation guide →](https://rp1.run/getting-started/installation/)** |
| 82 | |
| 83 | --- |
| 84 | |
| 85 | ## Beta Releases |
| 86 | |
| 87 | Want to try upcoming features before they're officially released? |
| 88 | |
| 89 | ### Install Beta |
| 90 | |
| 91 | ```bash |
| 92 | brew install rp1-run/tap/rp1-beta |
| 93 | rp1 install |
| 94 | ``` |
| 95 | |
| 96 | > **Note:** You cannot have both stable and beta installed simultaneously. Installing one requires uninstalling the other first. |
| 97 | |
| 98 | ### Verify |
| 99 | |
| 100 | ```bash |
| 101 | rp1 --version |
| 102 | # Should show a pre-release version like 0.7.0-beta.1 |
| 103 | ``` |
| 104 | |
| 105 | ### Rollback to Stable |
| 106 | |
| 107 | ```bash |
| 108 | brew uninstall rp1-beta && brew install rp1-run/tap/rp1 |
| 109 | rp1 install |
| 110 | ``` |
| 111 | |
| 112 | --- |
| 113 | |
| 114 | ## What Can You Do? |
| 115 | |
| 116 | ### Ship a feature |
| 117 | |
| 118 | ```bash |
| 119 | /build user-auth |
| 120 | ``` |
| 121 | |
| 122 | ### Review a PR |
| 123 | |
| 124 | ```bash |
| 125 | /pr-review "feature/auth" |
| 126 | ``` |
| 127 | |
| 128 | ### Investigate a bug |
| 129 | |
| 130 | ```bash |
| 131 | /code-investigate "bug-123" "Login fails intermittently" |
| 132 | ``` |
| 133 | |
| 134 | ### Quick code check |
| 135 | |
| 136 | ```bash |
| 137 | /code-check |
| 138 | ``` |
| 139 | |
| 140 | **[See all commands →](https://rp1.run/reference/)** |
| 141 | |
| 142 | --- |
| 143 | |
| 144 | ## Principles |
| 145 | |
| 146 | | | | |
| 147 | |---|---| |
| 148 | | **Batteries Included |