A local-first desktop workspace for AI coding agents & harnesses.
-black?style=flat-square&logo=apple){kind=icon}
Download for macOS or Windows · First conversation · User guide · Architecture · Contributing
Capsule is a desktop workspace for the coding agents you already run. Claude Code, Codex, Grok Build and other ACP harnesses do the work; Capsule gives them a window — projects, conversations, diffs, approvals and a record of what each turn changed, on your own machine.
It does not install coding CLIs or hold their provider API keys. Install and sign in to a supported CLI, then choose its available runtime route. Some harnesses require an OpenClaw Gateway and its ACP adapter.
Runs the agents you have. Start, cancel and close a harness session, and switch a conversation from one agent to another without losing the thread. Steer and live setting changes depend on the runtime route; unsupported changes report a limitation instead of claiming success.
Keeps a record of the work. Turns retain the activity the agent reports. Git-backed turns capture checkpoints for saved diffs and restoration. A completed reply is not proof that tests passed: verification receipts require a saved local check and matching revision evidence.
Reviews changes where you are. Diffs, changed files, and pull requests read in the app instead of a browser tab.
Keeps your work on your computer. A local SQLite database, tokens encrypted with the operating system's credential protection when available, no analytics and no telemetry. Read PRIVACY.md for browser, provider, catalog and remote-access data flows.
Works without a Gateway. Direct mode spawns an ACP-capable CLI itself, so an install with nothing else running still gets a working turn.
Verifiable downloads. Public macOS releases require Developer ID signing and notarization. The initial Windows preview is unsigned and includes a SHA-256 checksum; a checksum verifies file integrity, not publisher identity.
Download the Apple Silicon DMG or Windows 10/11 x64 installer from GitHub Releases:
- Open the downloaded
.dmg. - Drag Capsule into your Applications folder.
- Launch Capsule.
On Windows, run the Capsule-<version>-x64-setup.exe installer. This first
Windows preview is unsigned: Windows may show an unknown-publisher or
SmartScreen warning. Download only from this repository's releases and review
the release notes. Do not disable system security protections. Windows ARM and
WSL-hosted agents are not covered. See Windows preview.
After installation, compatible updates download inside the app and offer Restart & install. Save your work before restarting. Unsigned or incompatible builds may require a manual download; see Updating Capsule.
Install and sign in to your coding CLI, attach a disposable project folder, choose an available harness and ask for a small change. Review the resulting diff, run a saved check, then decide whether to commit. The first-conversation guide walks through the flow; providers and credentials explains route prerequisites.
Capsule is an ACP client, not an implementation of an agent's coding loop. Direct mode uses ACP v1 over stdio; the Gateway route uses OpenClaw's operator connection. Support depends on the installed harness, negotiated capabilities and selected route—not simply on an agent appearing in a directory.
- Direct conversations resume the agent's saved session when it advertises resume or load support. Agent-reported settings can be changed in place; unsupported restores and settings fail explicitly.
- Browser interaction requires a direct agent with HTTP MCP support and your explicit grant. The Browser panel can also start a temporary background page and separately share read-only snapshots with paired viewers.
- The Agents panel shows reported delegation, not independently controlled child processes. Missing activity or token data stays unknown.
- Paired devices are read-only. Downloads target macOS Apple Silicon and an unsigned Windows 10/11 x64 preview. Native protocol fixtures are tested, not every signed-in provider on Windows.
See supported behavior and current limits, browser controls and the contributor-facing ACP compatibility map for specifics.
Use the bug report form with About → Copy version info, the selected agent and runtime route, reproduction steps, and a redacted screenshot when useful. For freezes, include the operation and repository size plus the relevant local diagnostics. Review exports for private paths before sharing. Report security issues through SECURITY.md.
Capsule is built as a pnpm monorepo using Electron, Vite, React, and TypeScript.
- macOS (Apple Silicon arm64 recommended)
- Node.js:
22+ - pnpm:
10+
# Clone the repository
git clone https://github.com/realbakari/Capsule-App.git
cd Capsule-App
# Install dependencies (automatically sets up Electron & native modules)
pnpm install
# Start the desktop app in development mode
pnpm devpnpm test # Run Vitest test suite under Electron
pnpm lint # Run ESLint across packages
pnpm typecheck # Run TypeScript checks
pnpm build # Build all packages and desktop renderer
pnpm package:mac # Package macOS; signing/notarization require credentialsIf pnpm dev warns about Electron or native modules:
node scripts/ensure-electron.mjs # Downloads Electron binary if skipped
node scripts/ensure-native.mjs # Compiles SQLite for Electron┌─────────────────────────────────────────────────────────┐
│ Capsule UI │
│ (Collapsible Sidebar · Composer · Run Inspector) │
└────────────────────────────┬────────────────────────────┘
│ IPC (Strict Allowlist)
┌────────────────────────────▼────────────────────────────┐
│ Capsule Core │
│ (Projects · Sessions · Run Events · Keychain Storage) │
└──────────────┬───────────────────────────┬──────────────┘
│ │
┌──────────────▼────────────┐ ┌────────────▼──────────────┐
│ OpenClaw Adapter │ │ Direct ACP host │
│ (Protocol 4 Gateway RPC) │ │ (native ACP CLIs) │
└───────────────────────────┘ └───────────────────────────┘
Capsule enforces clean architectural separation:
- Adapters own all I/O.
- The UI renderer only imports
@capsule/sharedand@capsule/ui. - SQLite, filesystem operations, and Keychain are isolated in the Electron main process via
@capsule/core.
Read CONTRIBUTING.md first, and AGENTS.md if an agent is doing the work.
- Fork the repo & create your feature branch:
git checkout -b feat/my-feature - Ensure tests and lint pass:
pnpm test && pnpm lint && pnpm typecheck - Commit your changes:
git commit -m "feat: my new feature" - Push the branch and open a pull request.
MIT © Bakari Mustafa — see LICENSE.
- Privacy — local storage and network activity.
- Security — reporting a vulnerability, and what Capsule does and does not defend against.
- Terms of use — how the software is offered.