$git clone https://github.com/repoprompt/repoprompt-ceA free, open-source native macOS app and agent orchestrator for context engineering.
| 1 | # RepoPrompt CE |
| 2 | |
| 3 | [](https://github.com/repoprompt/repoprompt-ce/actions/workflows/ci.yml?query=branch%3Amain) |
| 4 | [](LICENSE) |
| 5 |  |
| 6 | |
| 7 | **A free, open-source native macOS app and agent orchestrator for context engineering.** |
| 8 | |
| 9 | RepoPrompt CE helps coding agents understand your codebase before they act. It |
| 10 | assembles focused, reviewable context from files, CodeMaps, repository |
| 11 | structure, and Git diffs, then hands that context to AI tools and CLI agents. |
| 12 | |
| 13 | RepoPrompt CE also builds an agent harness around its bundled MCP server. |
| 14 | Connect MCP-compatible clients and CLI agents to search repositories, inspect |
| 15 | files, curate context, run agent sessions, and orchestrate work through a shared |
| 16 | native macOS interface. |
| 17 | |
| 18 | ## Get Started |
| 19 | |
| 20 | Choose one of these setup paths. You do not need to open Xcode. |
| 21 | |
| 22 | ### Install with Homebrew |
| 23 | |
| 24 | For the signed and notarized public app, use the dedicated RepoPrompt CE |
| 25 | Homebrew tap: |
| 26 | |
| 27 | ```bash |
| 28 | brew tap repoprompt/repoprompt-ce |
| 29 | brew install --cask repoprompt-ce |
| 30 | ``` |
| 31 | |
| 32 | This installs `/Applications/RepoPrompt CE.app` from the |
| 33 | [`repoprompt/homebrew-repoprompt-ce`](https://github.com/repoprompt/homebrew-repoprompt-ce) |
| 34 | tap. The cask consumes the promoted public updater ZIP from |
| 35 | [`repoprompt/repoprompt-ce-updates`](https://github.com/repoprompt/repoprompt-ce-updates); |
| 36 | it does not build from source. Source-build paths remain below for contributors |
| 37 | and local development. |
| 38 | |
| 39 | ### Build and launch locally |
| 40 | |
| 41 | For development and quick evaluation, double-click |
| 42 | [`Launch RepoPrompt CE.command`](Launch%20RepoPrompt%20CE.command) in Finder. |
| 43 | |
| 44 | The launcher requires Python 3, builds RepoPrompt CE through the coordinated |
| 45 | developer daemon, opens the debug app, and keeps a small terminal window |
| 46 | available for rebuild, status, and stop controls. It does not provide an |
| 47 | uncoordinated no-Python fallback because lifecycle actions validate the exact |
| 48 | debug executable path. |
| 49 | |
| 50 | The debug launcher uses an available `Apple Development:` signing identity. If |
| 51 | your Mac does not have one, run the same debug app from Terminal with explicit |
| 52 | ad-hoc signing: |
| 53 | |
| 54 | ```bash |
| 55 | ALLOW_ADHOC_SIGNING=1 ./conductor app relaunch |
| 56 | ``` |
| 57 | |
| 58 | Ad-hoc debug builds use in-memory secure storage, so saved API keys and secure |
| 59 | permission changes do not persist across launches. For persistent debug |
| 60 | Keychain storage, pass a stable Apple Development identity explicitly: |
| 61 | |
| 62 | ```bash |
| 63 | SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" ./conductor app relaunch |
| 64 | ``` |
| 65 | |
| 66 | For a stable locally signed app under `/Applications`, use the local production |
| 67 | installer below. Its self-signed identity is separate from the debug launcher's |
| 68 | Apple Development signing path. |
| 69 | |
| 70 | > **Note:** If you use the debug app to modify RepoPrompt CE itself, validation |
| 71 | > flows that launch the app or run live smoke checks may rebuild and relaunch it. |
| 72 | > Expect the debug app to restart while those checks run. |
| 73 | |
| 74 | | Key | Action | |
| 75 | | --- | ------------------------------------------- | |
| 76 | | `r` | Rebuild and relaunch | |
| 77 | | `s` | Show app status | |
| 78 | | `x` | Stop the app | |
| 79 | | `q` | Close the launcher without stopping the app | |
| 80 | |
| 81 | ### Install a local production build |
| 82 | |
| 83 | For a release-mode app under `/Applications`, install Python 3 and double-click |
| 84 | [`Install RepoPrompt CE Local Production.command`](Install%20RepoPrompt%20CE%20Local%20Production.command) |
| 85 | in Finder. The Finder launcher uses the coordinated developer daemon. |
| 86 | |
| 87 | The installer builds RepoPrompt CE from source and replaces any existing |
| 88 | `/Applications/RepoPrompt CE.app` using a dedicated self-signed certificate |
| 89 | trusted only on your Mac. macOS may ask you to approve the certificate. |
| 90 | |
| 91 | The resulting app is local-only. It is not notarized and should not |