[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81453":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":13,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":16,"rankGlobal":10,"rankLanguage":10,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":13,"starSnapshotCount":13,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},81453,"acp-agent-hub","xfbaby\u002Facp-agent-hub","xfbaby","Multi-platform ACP client (VS Code + CLI) for connecting AI coding agents — fork of vscode-acp with Windows fixes & improvements.","",null,"TypeScript",33,0,32,1,40.1,"MIT License",false,"main",true,[22,23,24,25,26],"acp","ai-agent","claude-code","developer-tools","rpc","2026-06-12 04:01:33","# ACP Client — Multi-Platform AI Agent Hub\n\n\u003Cp align=\"center\">\n  \u003Cstrong>One protocol. Three platforms. Eleven AI agents.\u003C\u002Fstrong>\n  \u003Cbr \u002F>\n  Connect any ACP-compatible AI coding agent from VS Code, terminal, or mobile.\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=formulahendry.acp-client\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVS%20Code-Marketplace-blue?logo=visualstudiocode\" alt=\"VS Code Marketplace\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@acp-mobile\u002Fcli\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@acp-mobile\u002Fcli?label=CLI\" alt=\"CLI npm\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green\" alt=\"MIT License\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fformulahendry\u002Fvscode-acp\u002Factions\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fformulahendry\u002Fvscode-acp\u002F.github\u002Fworkflows\u002Fci.yml?branch=main\" alt=\"CI Status\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fagentclientprotocol.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FACP-Protocol-purple\" alt=\"ACP Protocol\" \u002F>\u003C\u002Fa>\n  \u003Cbr \u002F>\n  \u003Ca href=\"#vscode-extension\">VS Code\u003C\u002Fa> ·\n  \u003Ca href=\"#cli\">CLI\u003C\u002Fa> ·\n  \u003Ca href=\"#mobile-app\">Mobile\u003C\u002Fa> ·\n  \u003Ca href=\"#project-structure\">Structure\u003C\u002Fa> ·\n  \u003Ca href=\"CONTRIBUTING.md\">Contributing\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"README.zh-CN.md\">中文版\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n**ACP Client** is an open-source, multi-platform implementation of the [Agent Client Protocol (ACP)](https:\u002F\u002Fagentclientprotocol.com\u002F). It acts as an **AI agent hub** that lets you connect, switch, and use ACP-compatible AI coding agents across **VS Code, the terminal, and mobile**.\n\n| Platform | Directory | Description |\n|----------|-----------|-------------|\n| **VS Code Extension** | `packages\u002Fvscode` | Chat panel and session management inside VS Code |\n| **CLI** | `packages\u002Fcli` | Interactive REPL and one-shot commands in the terminal |\n| **Mobile App** | `packages\u002Fmobile` | Connect to agents from your phone via a WebSocket relay |\n\nThis means you can use **GitHub Copilot, Claude Code, Gemini CLI, Qwen Code, Auggie CLI, Qoder CLI, Codex CLI, OpenCode, OpenClaw, Kiro CLI, and Hermes Agent** — all 11 AI coding agents — from whichever interface suits you, without vendor lock-in.\n\n---\n\n## Contents\n\n- [Why ACP?](#why-acp)\n- [Architecture Overview](#architecture-overview)\n- [Platforms](#platforms)\n  - [VS Code Extension](#vscode-extension)\n  - [CLI](#cli)\n  - [Mobile App](#mobile-app)\n- [Supported Agents](#supported-agents)\n- [Quick Start](#quick-start)\n- [Project Structure](#project-structure)\n- [Development](#development)\n- [Related Projects](#related-projects)\n- [Contributing](#contributing)\n\n---\n\n## Why ACP?\n\nThe AI coding tool landscape is fragmented. Each agent has its own UI, its own protocol, its own integration point. **ACP** solves this by providing a standard JSON-RPC protocol that any agent can implement and any client can consume.\n\n| Problem | ACP Solution |\n|---------|-------------|\n| Each agent needs its own UI | One client, many agents |\n| Switching agents means switching tools | Switch agents in-place via dropdown |\n| Mobile access to desktop agents | Relay server + mobile client |\n| Proprietary protocols | Open standard (JSON-RPC 2.0 over stdio\u002FWebSocket) |\n\nACP is the **USB-C of AI coding agents** — one connector for everything.\n\n---\n\n## Architecture Overview\n\n```\n                          ┌──────────────────────────────────────┐\n                          │         ACP Client (VS Code)          │\n                          │  ┌─────────┐  ┌────────┐  ┌────────┐ │\n                          │  │  Chat   │  │Session │  │Status  │ │\n                          │  │Webview  │  │  Tree  │  │  Bar   │ │\n                          │  └────┬────┘  └────┬───┘  └────┬───┘ │\n                          │       │             │            │     │\n                          │  ┌────▼─────────────▼────────────▼───┐ │\n                          │  │         SessionManager            │ │\n                          │  │  ConnectionManager  AgentManager  │ │\n                          │  └────┬──────────────────────────────┘ │\n                          └───────│─────────────────────────────────┘\n                                  │ ACP Protocol (JSON-RPC 2.0 over stdio)\n          ┌───────────────────────┼───────────────────────────────────────┐\n          │                       │                                       │\n          ▼                       ▼                                       ▼\n  ┌───────────────┐     ┌──────────────────┐                    ┌───────────────┐\n  │   CLI Client  │     │  ACP-compatible   │    WebSocket      │  Mobile App   │\n  │  (commander)  │     │  AI Agent Process │◄──────────────────►│  (ReactNative)│\n  │  REPL \u002F chat  │     │                   │                    │               │\n  └───────┬───────┘     │ Claude Code       │                    │  Chat UI      │\n          │             │ Gemini CLI        │                    └───────┬───────┘\n          │             │ GitHub Copilot    │                            │\n          │             │ Qwen Code         │                    ┌───────▼───────┐\n          │             │ Codex CLI         │                    │  Relay Server │\n          │             │ ...               │                    │  (WebSocket)  │\n          │             └───────────────────┘                    │  + SQLite     │\n          │                                                      └───────────────┘\n          └────────────────────── Shared Core ───────────────────┘\n```\n\nAll platforms share a **core library** (`packages\u002Fshared\u002F`) containing the ACP client implementation, session management, and type definitions. Each platform provides its own UI layer and platform-specific adapters (file system, terminal, permissions).\n\n---\n\n## Platforms\n\n### VS Code Extension\n\nAdds an ACP panel to VS Code's activity bar with:\n\n- **Chat Webview** — Full Markdown rendering, tool call visualization, thinking process display with streaming animation\n- **Session Tree** — Browse historical sessions per agent, click to restore context\n- **File System Integration** — Agents can read\u002Fwrite workspace files through VS Code's FS API\n- **Terminal Execution** — Real-time command output capture\n- **Permission Management** — Ask-on-each or auto-approve policies\n- **Protocol Traffic Log** — Debug all JSON-RPC messages in real-time\n\n![ACP Client Screenshot](packages\u002Fvscode\u002Fresources\u002Fscreenshot.png)\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Built-in Commands\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n| Command | Description |\n|---------|-------------|\n| `ACP: Connect to Agent` | Connect to an agent |\n| `ACP: Disconnect Agent` | Disconnect current agent |\n| `ACP: Restart Agent` | Restart agent process |\n| `ACP: New Conversation` | Start fresh conversation |\n| `ACP: Send Prompt` | Send message to agent |\n| `ACP: Cancel Current Turn` | Cancel ongoing response |\n| `ACP: Set Agent Mode` | Switch agent working mode |\n| `ACP: Set Agent Model` | Switch agent model |\n| `ACP: Attach File to Prompt` | Attach file to message |\n| `ACP: Show Protocol Traffic` | View JSON-RPC traffic |\n| `ACP: Browse Agent Registry` | Discover new agents |\n\n\u003C\u002Fdetails>\n\n### CLI\n\n![ACP Client Screenshot](packages\u002Fcli\u002Fresources\u002Fscreenshot.png)\n\nBuilt with [Commander.js](https:\u002F\u002Fgithub.com\u002Ftj\u002Fcommander.js):\n\n```bash\n# Interactive REPL (default)\nacp\n\n# Start REPL with auto-connect\nacp repl \"Claude Code\"\n\n# One-shot chat\nacp chat \"Claude Code\" \"Explain this codebase\"\n\n# Manage agents\nacp agent list\n\n# Browse sessions\nacp session list \"Claude Code\"\nacp session show \"Claude Code\" \u003Csession-id>\n\n# Configuration\nacp config list\nacp config set defaultAgent \"Gemini CLI\"\n```\n\n### Mobile App\n\nReact Native application that connects through the WebSocket relay server, enabling agent interaction from your phone. The mobile client is chat-only (no file system or terminal capabilities).\n\n### Relay Server\n\nNode.js WebSocket server (`@acp-mobile\u002Fserver`) that bridges mobile clients to agent processes:\n\n- WebSocket-to-stdio relay for ACP protocol\n- SQLite-backed session persistence\n- Pino structured logging\n\n---\n\n## Supported Agents\n\nThe project ships with **11 pre-configured agents**, ready to use out of the box:\n\n| Agent | Command | Provider |\n|-------|---------|----------|\n| **GitHub Copilot** | `npx @github\u002Fcopilot-language-server@latest --acp` | GitHub (Microsoft) |\n| **Claude Code** | `npx @agentclientprotocol\u002Fclaude-agent-acp@latest` | Anthropic |\n| **Gemini CLI** | `npx @google\u002Fgemini-cli@latest --experimental-acp` | Google |\n| **Qwen Code** | `npx @qwen-code\u002Fqwen-code@latest --acp --experimental-skills` | Alibaba |\n| **Auggie CLI** | `npx @augmentcode\u002Fauggie@latest --acp` | Augment |\n| **Qoder CLI** | `npx @qoder-ai\u002Fqodercli@latest --acp` | Qoder AI |\n| **Codex CLI** | `npx @zed-industries\u002Fcodex-acp@latest` | OpenAI (via Zed) |\n| **OpenCode** | `npx opencode-ai@latest acp` | Open Source |\n| **OpenClaw** | `npx openclaw acp` | Open Source |\n| **Kiro CLI** | `kiro-cli acp` | Kiro |\n| **Hermes Agent** | `hermes acp` | Nous Research |\n\nYou can also add **any custom ACP-compatible agent** via settings (VS Code) or config file (CLI).\n\n---\n\n## Quick Start\n\n### VS Code Extension\n\n**Run from source (development)**\n\n```bash\ncd packages\u002Fvscode\nnpm install\nnpm run compile\n```\n\nOpen the `packages\u002Fvscode` folder in VS Code and press `F5` to launch the Extension Development Host.\n\n> **Windows + Claude Code users**: If connection fails with `Internal error`, make sure [Claude Code CLI](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code) is installed, or configure the `CLAUDE_CODE_EXECUTABLE` environment variable for Claude Code in VS Code settings (`acp.agents`).\n\n### CLI\n\n**Run from source:**\n\n```bash\ncd packages\u002Fcli\nnpm install\nnpm run build\nnpm link          # Link the acp command to your global PATH\nacp agent list    # Verify installation\n```\n\nThe CLI config file is at `~\u002F.config\u002Facp\u002Fconfig.json` (Windows: `%USERPROFILE%\\.config\\acp\\config.json`). Run `acp config list` to view the current configuration.\n\n### Relay Server\n\n```bash\ncd packages\u002Fserver\nnpm install\nnpm run build\nnpm start\n\n# Listens on ws:\u002F\u002Flocalhost:3100 by default\n# Override the port with the ACP_SERVER_PORT environment variable\n# Mobile app connects through this relay server\n```\n\n---\n\n## Project Structure\n\nThis is a **monorepo** managed with npm workspaces. All platform-specific packages live under `packages\u002F`.\n\n```\nagenthub\u002F\n│\n├── packages\u002F\n│   ├── vscode\u002F                   # VS Code Extension (package.json, webpack, tsconfig)\n│   │   ├── src\u002F                  # Extension source code\n│   │   │   ├── extension.ts      # Entry point\n│   │   │   ├── config\u002F           # Agent configuration & registry client\n│   │   │   ├── core\u002F             # AgentManager, ConnectionManager, SessionManager\n│   │   │   ├── handlers\u002F         # FileSystem, Terminal, Permission, SessionUpdate\n│   │   │   ├── ui\u002F               # ChatWebview, SessionTree, StatusBar\n│   │   │   └── utils\u002F            # Logger, StreamAdapter, Telemetry\n│   │   ├── resources\u002F            # Icons, screenshots\n│   │   └── .vscode\u002F              # Launch config, settings for extension dev\n│   │\n│   ├── shared\u002F                   # @acp-mobile\u002Fshared — core types, managers, MobileAcpClient\n│   ├── cli\u002F                      # @acp-mobile\u002Fcli — Commander.js CLI with REPL\n│   ├── server\u002F                   # @acp-mobile\u002Fserver — WebSocket relay server\n│   └── mobile\u002F                   # React Native mobile app\n│\n├── .github\u002Fworkflows\u002F            # CI + publish pipelines\n├── docs\u002F                         # Architecture documentation\n│\n├── package.json                  # Monorepo root (npm workspaces)\n├── tsconfig.base.json            # Shared TypeScript config\n├── eslint.config.mjs             # ESLint flat config\n└── LICENSE                       # MIT\n```\n\n---\n\n## Development\n\n### Prerequisites\n\n- Node.js 18+\n- VS Code 1.85+ (for extension development)\n\n### Setup\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fformulahendry\u002Fvscode-acp.git\ncd vscode-acp\nnpm install\n```\n\n### VS Code Extension\n\n```bash\ncd packages\u002Fvscode\nnpm run compile          # webpack build\n```\n\nOpen the `packages\u002Fvscode\u002F` folder in VS Code and press `F5` to launch the Extension Development Host for debugging.\n\n### CLI\n\n```bash\ncd packages\u002Fcli\nnpm run build\n```\n\n### Testing\n\n```bash\n# Run VS Code extension tests\ncd packages\u002Fvscode\nnpm run lint            # ESLint (zero-warning policy)\nnpm run pretest         # Compile tests + lint\nnpm test                # Run VS Code extension tests\n\n# Or from root (runs all workspaces)\nnpm test\n```\n\n### Package VSIX\n\n```bash\ncd packages\u002Fvscode\nnpm run package                          # webpack production build\nnpx @vscode\u002Fvsce package                 # package as .vsix\n```\n\n---\n\n## Related Projects\n\n- [ACP UI](https:\u002F\u002Fgithub.com\u002Fformulahendry\u002Facp-ui) — Modern cross-platform ACP desktop client (Tauri)\n- [WeChat ACP](https:\u002F\u002Fgithub.com\u002Fformulahendry\u002Fwechat-acp) — Bridge WeChat messages to ACP agents\n- [Agent Client Protocol](https:\u002F\u002Fagentclientprotocol.com\u002F) — The open standard\n\n---\n\n## Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n","ACP Client 是一个多平台的AI编码代理连接工具，支持通过VS Code、终端或移动设备接入兼容ACP协议的AI编码代理。项目核心功能包括在不同平台上统一管理和切换AI代理，支持包括GitHub Copilot、Claude Code在内的11种AI编码代理。技术上采用TypeScript开发，并基于JSON-RPC协议实现跨平台通信。适用于需要灵活选择和切换AI编码辅助工具的开发者，尤其是希望避免单一供应商锁定的情况。",2,"2026-06-11 04:05:06","CREATED_QUERY"]