acp-ui  by formulahendry

Unified client for diverse AI coding agents

Created 3 months ago
267 stars

Top 96.0% on SourcePulse

GitHubView on GitHub
Project Summary

A modern, cross-platform client for the Agent Client Protocol (ACP), formulahendry/acp-ui provides a unified interface for connecting to diverse AI coding agents like GitHub Copilot, Claude, Gemini, and Qwen across desktop, mobile, and web platforms. It simplifies interaction with these agents, enhancing developer productivity by consolidating access and features into a single application.

How It Works

Leveraging the Agent Client Protocol (ACP), acp-ui utilizes the Tauri framework for native desktop applications (Windows, macOS, Linux) and web technologies for browser and mobile clients. Communication with AI agents primarily occurs over WebSocket, enabling connections to remote agents. While desktop builds can manage local stdio agents, web and mobile versions are restricted to remote connections due to sandbox environments.

Quick Start & Requirements

  • Installation: Download pre-built binaries from GitHub Releases for Windows, macOS, and Linux. An Android APK is available; iOS requires building from source. A web version is accessible at https://acp-ui.github.io/ with no installation needed.
  • Prerequisites: For development or building: Node.js 18+, Rust 1.70+, and platform-specific build tools (Tauri prerequisites). For Android builds: JDK 17 and Android SDK. For iOS builds: Xcode 15+.
  • Links: Web App: https://acp-ui.github.io/.

Highlighted Details

  • Supports a wide array of ACP-compatible agents, including GitHub Copilot, Claude Code, Gemini CLI, Qwen Code, and Codex CLI.
  • Offers extensive cross-platform compatibility: Web, Windows, macOS (ARM/Intel), Linux (x64/ARM64), Android, and iOS (via source build).
  • Facilitates remote agent connections over WebSocket, allowing access from mobile devices or browsers to agents running on other machines.
  • Key features include multi-agent support, session management, a rich chat interface with Markdown rendering and syntax highlighting, slash commands, permission controls, and a real-time traffic monitor.

Maintenance & Community

The provided README does not detail specific community channels (e.g., Discord/Slack), notable contributors, or sponsorships. Automated deployment workflows for the web version are configured.

Licensing & Compatibility

Licensed under the MIT License, this project permits broad use, modification, and distribution, including integration within closed-source commercial applications.

Limitations & Caveats

Web and mobile builds cannot run local stdio agents or access the host filesystem due to browser sandbox restrictions. HTTPS web pages are limited to wss:// connections. iOS builds necessitate manual compilation and an Apple Developer Program membership for signing.

Health Check
Last Commit

5 days ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
5
Star History
99 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.