RepoPrompt CE
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:
brew tap repoprompt/repoprompt-ce
brew install --cask repoprompt-ce
This installs /Applications/RepoPrompt CE.app from the
repoprompt/homebrew-repoprompt-ce
tap. The cask consumes the promoted public updater ZIP from
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 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:
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:
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.
Install a local production build
For a release-mode app under /Applications, install Python 3 and double-click
Install RepoPrompt CE Local Production.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 — full
Xcode.app, not Command Line Tools alone. RepoPrompt CE and its dependencies use the@Entryand#PreviewSwift macros, whose plugins (SwiftUIMacros,PreviewsMacros) ship only withXcode.app. Its bundled macOS 26 SDK satisfies the SDK requirement. Run./Scripts/doctor.shto verify your toolchain before building.
Develop in Xcode
Generate and open the disposable contributor workspace with:
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
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 when the client supplies a progress token.
- Context Composer: 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.mdfor app-managed worktrees and.worktreeincludelocal 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.
Contributor Documentation
AGENTS.md: coordinated builds, tests, launches, live MCP checks, source placement, and contribution preflightCONTRIBUTING.md: contribution policy and pull request stepsdocs/architecture/context-composer.md: Context Composer architecture, invariants, and state ownershipdocs/architecture/source-layout.md: source ownership and placement rulesdocs/architecture/provider-plugins.md: Agent Mode provider architecturedocs/architecture/xcode-workspace.md: generated Xcode developer workflow and boundariesdocs/releasing.md: release-candidate and publishing workflowsdocs/open-source-readiness.md: public readiness inventory
License
RepoPrompt CE is licensed under Apache-2.0.
