---

What is Acepe?

Acepe is an Agentic Developer Environment (ADE) built for teams and developers who want AI agents to do real work inside a controlled engineering workflow.

Instead of treating agents like chat tabs or editor plugins, Acepe gives you a workspace to run multiple agents in parallel, inspect every tool call, review every file change, manage branches and worktrees, and turn useful output into commits and pull requests.

Why Acepe?

• Orchestrate agents, don't just chat with them — Run multiple agents side by side across multiple repos and tasks.
• Review before you trust — Inspect diffs, tool calls, checkpoints, and generated changes before they land.
• Ship from one place — Manage branches, commits, and pull requests without bouncing across tools.
• Built for serious project work — Native desktop app, worktree-aware, and designed for long-running agent sessions.

Features

Agent Orchestration

• Multi-agent sessions — Run multiple agents across multiple projects simultaneously
• Agent marketplace — Install agents (Claude Code, Cursor, Codex, OpenCode) or register custom ones
• Model selection — Switch models and modes per session
• Session history — Full conversation history with search, forking, and resuming

Review & Change Control

• Diff viewer — Side-by-side and unified diffs with syntax highlighting
• Checkpoints — Snapshot file state, compare across checkpoints, revert individual files or entire checkpoints
• Modified files panel — Track all agent changes with +/- stats and file tree navigation
• Git integration — Branch management, staging, commits, push/pull — all from the UI

Guardrails & Visibility

• Granular permissions — Approve, deny, or auto-approve tool calls per type (read, write, terminal, web)
• Permission queue — Batch-review pending tool requests
• Execution history — See every tool call with inputs, outputs, and timing

Shipping Workflow

• PR workflow — Create, review, and merge pull requests
• Commit badges — SHAs and PR references render as interactive badges in conversations
• Diff stats — Inline +X -Y change counts on badges, click to open full diff viewer

Workspace for Agentic Work

• Multi-project — Work across multiple repositories in a single window
• Multi-panel layout — Resizable panels with per-panel agent sessions
• Built-in terminal — Native PTY terminal embedded per agent panel
• Built-in browser — Webview panel with navigation for previewing apps
• @-mentions — Reference files, code, and images in messages

Built for Real Teams

• Worktree support — Isolated git worktrees for parallel agent work
• Keyboard shortcuts — Customizable keybindings and command palette
• Dark / light mode — System-aware theming
• Auto-updates — Built-in updater for new releases
• Notifications — Native OS notifications for agent activity

Supported Agents

Acepe is designed to be the place where you manage agent work, regardless of which coding agent you prefer.

Agent	Provider	Protocol
Claude Code	Anthropic	JSON-RPC / stdio
Cursor	Anysphere	JSON-RPC / stdio
Codex	Zed Industries	JSON-RPC / stdio
OpenCode	Community	HTTP / SSE

Quick Start

Use Acepe when you want AI agents to operate inside a workflow that still feels like disciplined software engineering: parallel sessions, visible changes, review checkpoints, and a clean path to a PR.

Download

Grab the latest release from acepe.dev/download or the releases page.

Build from Source

Install a local, unsigned build directly into /Applications:

git clone https://github.com/flazouh/acepe.git
cd acepe
bun run install:source

The command checks the prerequisites, installs the locked dependencies, builds Acepe.app, and installs it only after the build succeeds. It will not replace an existing installation unless you pass --force.

# Install without administrator access
bun run install:source -- --destination "$HOME/Applications"

# Replace an existing source installation
bun run install:source -- --force

Prerequisites: macOS, Bun 1.3+, Rust stable, and the Xcode Command Line Tools (xcode-select --install). Run bun run install:source -- --help for every option.

For development with hot reload, run:

bun install --frozen-lockfile
bun run --cwd packages/desktop tauri

Architecture

Acepe combines a native desktop shell with agent integrations, local project context, review tooling, and git workflows so you can keep the entire loop, from prompt to PR, in one place.

For the core product-state model and architecture vocabulary, see docs/concepts/.

┌──────────────────────────────────┐
│  Frontend (SvelteKit + Svelte 5) │
│  Agent workspace, review UI      │
└───────────────┬──────────────────┘
                │ Tauri IPC
┌───────────────▼──────────────────┐
│  Backend (Tauri + Rust)          │
│  Sessions, git, indexing, state  │
└───────────────┬──────────────────┘
                │ Agent runtimes
┌───────────────▼──────────────────┐
│  Coding agents                   │
│  Claude, Cursor, Codex, OpenCode │
└──────────────────────────────────┘

Contributing

We welcome contributions! See CONTRIBUTING.md to get started.

If you're looking for something to work on, check issues tagged good first issue or help wanted.

License

MIT — free to use, copy, modify, distribute, and sell, as long as the copyright and license notice stay with the software.

Acknowledgments

Built with Tauri, Svelte, and shadcn-svelte.

---