ACP UI

A modern, cross-platform desktop client for the Agent Client Protocol (ACP). Connect to AI coding agents like GitHub Copilot, Claude Code, Gemini CLI, and Qwen Code from a unified interface.

📥 Installation

Download the latest release for your platform from GitHub Releases:

Platform	Download
Windows	.msi installer or .exe (NSIS)
macOS (Apple Silicon)	.dmg (ARM64)
macOS (Intel)	.dmg (x64)
Linux (x64)	.deb or .AppImage or .rpm
Linux (ARM64)	.deb or .AppImage or .rpm

✨ Features

• Multi-Agent Support — Connect to any ACP-compatible agent
• Session Management — Create, resume, and manage conversation sessions
• Rich Chat Interface — Markdown rendering, syntax highlighting, tool call visualization
• Slash Commands — Quick access to agent capabilities with /command syntax
• Permission Controls — Approve or deny agent actions before execution
• Session Modes — Switch between agent modes (ask, code, architect, etc.)
• Model Picker — Select from available AI models (unstable API)
• Agent Thinking — View the agent's reasoning process (collapsible)
• Environment Variables — Configure per-agent environment variables (API keys, settings)
• Traffic Monitor — Debug and inspect ACP protocol messages in real-time
• Hot-Reload Config — Edit agent configurations without restarting
• Cross-Platform — Windows, macOS (ARM/Intel), Linux (x64/ARM64)

🎯 Default Agents

ACP UI comes pre-configured with these agents:

Agent	Package
GitHub Copilot	@github/copilot-language-server
Claude Code	@zed-industries/claude-code-acp
Gemini CLI	@google/gemini-cli
Qwen Code	@qwen-code/qwen-code

🛠️ Configuration

Agent configurations are stored in:

Platform	Path
Windows	%APPDATA%\acp-ui\agents.json
macOS	~/Library/Application Support/acp-ui/agents.json
Linux	~/.config/acp-ui/agents.json

Example Configuration

{
  "agents": {
    "GitHub Copilot": {
      "command": "npx",
      "args": ["@github/copilot-language-server@latest", "--acp"],
      "env": {}
    },
    "Claude Code": {
      "command": "npx",
      "args": ["@zed-industries/claude-code-acp@latest"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    },
    "Gemini CLI": {
      "command": "npx",
      "args": ["@google/gemini-cli@latest", "--experimental-acp"],
      "env": {}
    },
    "Qwen Code": {
      "command": "npx",
      "args": ["@qwen-code/qwen-code@latest", "--acp", "--experimental-skills"],
      "env": {}
    }
  }
}

Note: Environment variables are passed to the agent process on startup. Use these for API keys, custom settings, or overriding default behavior.

📖 Usage

1. Select an Agent — Choose from the dropdown in the sidebar
2. Set Working Directory — Click "Select Folder" to choose your project root
3. Create Session — Click "New Session" to start chatting
4. Use Slash Commands — Type / to see available commands
5. Resume Sessions — Click on saved sessions in the sidebar to resume

🚀 Development

Prerequisites

• Node.js 18+
• Rust 1.70+
• Platform-specific build tools (see Tauri Prerequisites)

Setup

# Clone the repository
git clone https://github.com/formulahendry/acp-ui.git
cd acp-ui

# Install dependencies
npm install

# Run in development mode
npm run tauri dev

Build for Production

npm run tauri build

🔗 Links

• Agent Client Protocol
• Tauri Documentation

📄 License

MIT License