Skip to content

Open-source desktop client for the Agent Client Protocol. Run multiple AI coding agents side by side with rich tool visualization, MCP integrations, and built-in terminal.

Notifications You must be signed in to change notification settings

OpenSource03/openacpui

Repository files navigation

OpenACP UI

Latest Release Platform Electron License Build


Warning

This project is in active development. Expect bugs, breaking changes, and missing features. Documentation is not available yet — check back soon.

Stop juggling terminals. OpenACP UI is a native desktop app that puts your AI coding agents, tools, and context in one window — with a UI that actually helps you work.

Features

Run multiple agents side by side — Claude Code, ACP agents, and any compatible backend. Each session runs independently with its own state, history, and context. Switch between them instantly.

See what tools are doing — Every tool call renders as a rich interactive card. File edits show word-level diffs with syntax highlighting. Bash output appears inline. Subagent tasks nest with step-by-step progress tracking.

Connect any MCP server — Plug in external tools via the Model Context Protocol. Jira issues, Confluence pages, and other integrations render with dedicated UIs — not raw JSON. OAuth flows handled automatically.

Built-in terminal and browser — Full PTY terminal with multiple tabs right next to your chat. Open web pages in an embedded browser without switching windows.

Project workspaces — Each project maps to a folder on disk. Sessions, history, and settings stay organized per project. Git status, staging, commits, and branches built into the sidebar.

Thinking mode — Watch Claude reason through problems in collapsible thinking blocks before it acts.

Glass UI on macOS — Native liquid glass transparency on macOS Tahoe+. Looks sharp on every other platform too.

Supported Agents

OpenACP UI works with any CLI that speaks the Agent Client Protocol. Each agent needs to be installed and authenticated separately. See the full ACP Agent Registry for all supported agents.

Agent Command Notes
Claude Code npx @zed-industries/claude-code-acp Native support, permission modes
Gemini CLI gemini --experimental-acp Experimental ACP flag
Codex CLI codex acp Requires OPENAI_API_KEY
Goose goose acp
Docker cagent cagent acp agent.yml Container-based agents

Adding an agent

Agents are configured in agents.json at your app data directory. Each entry defines the command, args, and environment:

{
  "Claude Code": {
    "command": "npx",
    "args": ["@zed-industries/claude-code-acp"],
    "env": { "ACP_PERMISSION_MODE": "acceptEdits" }
  }
}

You can also add agents directly from the app sidebar.

Install

Platform Download
macOS (Apple Silicon) .dmg (arm64)
macOS (Intel) .dmg (x64)
Windows .exe installer
Linux .AppImage / .deb

Development

git clone https://github.com/OpenSource03/openacpui.git
cd openacpui
pnpm install
pnpm dev

Build installers

pnpm dist:mac      # macOS DMG (arm64 + x64)
pnpm dist:win      # Windows NSIS installer
pnpm dist:linux    # Linux AppImage + deb

Contributing

  1. Fork the repo and create a feature branch
  2. Follow the conventions in CLAUDE.md
  3. Test with pnpm dev
  4. Open a pull request

License

MIT


Built on the Agent Client Protocol

About

Open-source desktop client for the Agent Client Protocol. Run multiple AI coding agents side by side with rich tool visualization, MCP integrations, and built-in terminal.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages