# RepoPrompt CE [![CI](https://github.com/repoprompt/repoprompt-ce/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/repoprompt/repoprompt-ce/actions/workflows/ci.yml?query=branch%3Amain) [![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE) ![Platform: macOS 26+](https://img.shields.io/badge/platform-macOS%2026%2B-black) **A free, open-source native macOS app and agent orchestrator for context engineering.** RepoPrompt CE helps coding agents understand your codebase before they act. It assembles focused, reviewable context from files, CodeMaps, repository structure, and Git diffs, then hands that context to AI tools and CLI agents. RepoPrompt CE also builds an agent harness around its bundled MCP server. Connect MCP-compatible clients and CLI agents to search repositories, inspect files, curate context, run agent sessions, and orchestrate work through a shared native macOS interface. ## Get Started Choose one of these setup paths. You do not need to open Xcode. ### Install with Homebrew For the signed and notarized public app, use the dedicated RepoPrompt CE Homebrew tap: ```bash brew tap repoprompt/repoprompt-ce brew install --cask repoprompt-ce ``` This installs `/Applications/RepoPrompt CE.app` from the [`repoprompt/homebrew-repoprompt-ce`](https://github.com/repoprompt/homebrew-repoprompt-ce) tap. The cask consumes the promoted public updater ZIP from [`repoprompt/repoprompt-ce-updates`](https://github.com/repoprompt/repoprompt-ce-updates); it does not build from source. Source-build paths remain below for contributors and local development. ### Build and launch locally For development and quick evaluation, double-click [`Launch RepoPrompt CE.command`](Launch%20RepoPrompt%20CE.command) in Finder. The launcher requires Python 3, builds RepoPrompt CE through the coordinated developer daemon, opens the debug app, and keeps a small terminal window available for rebuild, status, and stop controls. It does not provide an uncoordinated no-Python fallback because lifecycle actions validate the exact debug executable path. It preserves an explicit compatible `DEVELOPER_DIR`, or selects an installed full Xcode for the launcher process without changing the system-wide `xcode-select` setting. The debug launcher uses an available `Apple Development:` signing identity. If your Mac does not have one, run the same debug app from Terminal with explicit ad-hoc signing: ```bash ALLOW_ADHOC_SIGNING=1 ./conductor app relaunch ``` Ad-hoc debug builds use in-memory secure storage, so saved API keys and secure permission changes do not persist across launches. For persistent debug Keychain storage, pass a stable Apple Development identity explicitly: ```bash SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" ./conductor app relaunch ``` For a stable locally signed app under `/Applications`, use the local production installer below. Its self-signed identity is separate from the debug launcher's Apple Development signing path. > **Note:** If you use the debug app to modify RepoPrompt CE itself, validation > flows that launch the app or run live smoke checks may rebuild and relaunch it. > Expect the debug app to restart while those checks run. | Key | Action | | --- | ------------------------------------------- | | `r` | Rebuild and relaunch | | `s` | Show app status | | `x` | Stop the app | | `q` | Close the launcher without stopping the app | ### Install a local production build For a release-mode app under `/Applications`, install Python 3 and double-click [`Install RepoPrompt CE Local Production.command`](Install%20RepoPrompt%20CE%20Local%20Production.command) in Finder. The Finder launcher uses the coordinated developer daemon. The installer builds RepoPrompt CE from source and replaces any existing `/Applications/RepoPrompt CE.app` using a dedicated self-signed certificate trusted only on your Mac. macOS may ask you to approve the certificate. It requires a full Xcode installation and selects a compatible installed Xcode for the installer process without changing your system-wide `xcode-select` setting. The resulting app is local-only. It is not notarized and should not be copied to another Mac or redistributed. ### Source-build requirements - macOS 26 or later - Xcode 26, or matching Command Line Tools with the macOS 26 SDK. The Finder debug launcher and local production installer require the full Xcode app. ### Develop in Xcode Generate and open the disposable contributor workspace with: ```bash make xcode ``` In Xcode 26.3, use `RepoPrompt CE App` for the packaged debug app, `RepoPrompt CE MCP` for the coordinated MCP executable, and `RepoPrompt CE Tests` for tests. The test scheme delegates to conductor because `RepoPromptMCP` is an executable-only SwiftPM target. Xcode also exposes the native `RepoPrompt` and `repoprompt-mcp` product schemes. See [`docs/architecture/xcode-workspace.md`](docs/architecture/xcode-workspace.md) for generation, validation, cleanup, and workflow boundaries. Release packaging is unchanged and does not use the generated workspace. ## Features - **Context engineering**: Build dense, reviewable prompts with the files and repository details an AI model actually needs. - **Codebase orientation**: Combine file trees, selected file contents, line slices, CodeMaps, and Git diffs. - **Context Builder**: Let an agent explore the repository, identify relevant files, and curate context within a token budget. Long-running MCP calls expose [request-scoped progress](docs/mcp-progress.md) when the client supplies a progress token. - **Compose inspector**: Review selected files and codemaps, configure prompt packaging and Git context, and copy a fresh model-ready prompt without leaving Agent Mode. - **Agent orchestration**: Run and coordinate CLI-backed coding agents from the native macOS app. See [`docs/worktrees.md`](docs/worktrees.md) for app-managed worktrees and `.worktreeinclude` local file copying. - **MCP server and CLI integration**: Connect external MCP-compatible tools and CLI agents to RepoPrompt CE's repository context and agent harness. - **Multi-root workspaces**: Work across related repositories, packages, and documentation folders in one workspace. - **Reviewable handoffs**: Inspect and refine selected context before sending it to another model or agent. ## About the Community Edition RepoPrompt CE is the free, open-source community edition of RepoPrompt. It is a native macOS workspace for context engineering, agent orchestration, and local development. Maintainers track release signing, Sparkle metadata, dependency pins, and third-party notices in [`docs/open-source-readiness.md`](docs/open-source-readiness.md). ## Contributor Documentation - [`AGENTS.md`](AGENTS.md): coordinated builds, tests, launches, live MCP checks, source placement, and contribution preflight - [`CONTRIBUTING.md`](CONTRIBUTING.md): contribution policy and pull request steps - [`docs/architecture/compose.md`](docs/architecture/compose.md): Compose inspector architecture, invariants, and state ownership - [`docs/architecture/source-layout.md`](docs/architecture/source-layout.md): source ownership and placement rules - [`docs/architecture/provider-plugins.md`](docs/architecture/provider-plugins.md): Agent Mode provider architecture - [`docs/architecture/xcode-workspace.md`](docs/architecture/xcode-workspace.md): generated Xcode developer workflow and boundaries - [`docs/releasing.md`](docs/releasing.md): release-candidate and publishing workflows - [`docs/open-source-readiness.md`](docs/open-source-readiness.md): public readiness inventory ## License RepoPrompt CE is licensed under [Apache-2.0](LICENSE).