{"id":44282633,"url":"https://github.com/formulahendry/vscode-acp","last_synced_at":"2026-02-15T02:00:37.092Z","repository":{"id":337205826,"uuid":"1152693599","full_name":"formulahendry/vscode-acp","owner":"formulahendry","description":"Agent Client Protocol client for VS Code — connect to any ACP-compatible AI coding agent","archived":false,"fork":false,"pushed_at":"2026-02-12T12:05:02.000Z","size":494,"stargazers_count":17,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-14T05:08:19.413Z","etag":null,"topics":["acp","agent-client-protocol","agentclientprotocol","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=formulahendry.acp-client","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/formulahendry.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-08T09:25:40.000Z","updated_at":"2026-02-13T19:40:58.000Z","dependencies_parsed_at":"2026-02-13T00:01:13.412Z","dependency_job_id":null,"html_url":"https://github.com/formulahendry/vscode-acp","commit_stats":null,"previous_names":["formulahendry/vscode-acp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/formulahendry/vscode-acp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formulahendry%2Fvscode-acp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formulahendry%2Fvscode-acp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formulahendry%2Fvscode-acp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formulahendry%2Fvscode-acp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/formulahendry","download_url":"https://codeload.github.com/formulahendry/vscode-acp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/formulahendry%2Fvscode-acp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29465397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T01:01:38.065Z","status":"online","status_checked_at":"2026-02-15T02:00:07.449Z","response_time":118,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acp","agent-client-protocol","agentclientprotocol","vscode","vscode-extension"],"created_at":"2026-02-10T22:05:23.685Z","updated_at":"2026-02-15T02:00:37.074Z","avatar_url":"https://github.com/formulahendry.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ACP Client for VS Code\r\n\r\nA [Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=formulahendry.acp-client) that provides a client for the [Agent Client Protocol (ACP)](https://agentclientprotocol.com/) — connect to any ACP-compatible AI coding agent directly from your editor.\r\n\r\n![ACP Client Screenshot](resources/screenshot.png)\r\n\r\n## Features\r\n\r\n- **Multi-Agent Support**: Connect to 8 pre-configured ACP agents or add your own\r\n- **Single-Agent Focus**: One agent active at a time — seamlessly switch between agents\r\n- **Interactive Chat**: Built-in chat panel with Markdown rendering, inline tool call display, and collapsible tool sections\r\n- **Thinking Display**: See agent reasoning in a collapsible block with streaming animation and elapsed time\r\n- **Slash Commands**: Autocomplete popup for agent-provided commands with keyboard navigation\r\n- **Mode \u0026 Model Picker**: Switch agent modes and models directly from the chat toolbar\r\n- **File System Integration**: Agents can read and write files in your workspace\r\n- **Terminal Execution**: Agents can run commands with terminal output display\r\n- **Permission Management**: Configurable auto-approve policies for agent actions\r\n- **Protocol Traffic Logging**: Inspect all ACP JSON-RPC messages with request/response/notification labels\r\n- **Agent Registry**: Browse and discover available ACP agents\r\n- **Chat Persistence**: Conversations are preserved when switching panels\r\n\r\n## Quick Start\r\n\r\n1. Install: [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=formulahendry.acp-client) | [Open in VS Code](https://vscode.dev/redirect?url=vscode%3Aextension%2Fformulahendry.acp-client) | [Open VSX Marketplace](https://open-vsx.org/extension/formulahendry/acp-client)\r\n2. Open the ACP Client panel from the Activity Bar (ACP icon)\r\n3. Click **+** to add an agent configuration, or use the defaults\r\n4. Click an agent to connect\r\n5. Start chatting!\r\n\r\n## Requirements\r\n\r\n- Node.js 18+ (for spawning agent processes)\r\n- An ACP-compatible agent installed or available via `npx`\r\n\r\n## Pre-configured Agents\r\n\r\nThe extension comes with default configurations for:\r\n\r\n| Agent | Command |\r\n|-------|---------|\r\n| GitHub Copilot | `npx @github/copilot-language-server@latest --acp` |\r\n| Claude Code | `npx @zed-industries/claude-code-acp@latest` |\r\n| Gemini CLI | `npx @google/gemini-cli@latest --experimental-acp` |\r\n| Qwen Code | `npx @qwen-code/qwen-code@latest --acp --experimental-skills` |\r\n| Auggie CLI | `npx @augmentcode/auggie@latest --acp` |\r\n| Qoder CLI | `npx @qoder-ai/qodercli@latest --acp` |\r\n| Codex CLI | `npx @zed-industries/codex-acp@latest` |\r\n| OpenCode | `npx opencode-ai@latest acp` |\r\n\r\nYou can add custom agent configurations in settings.\r\n\r\n## Extension Settings\r\n\r\n| Setting | Default | Description |\r\n|---------|---------|-------------|\r\n| `acp.agents` | *(8 agents)* | Agent configurations. Each key is the agent name, value has `command`, `args`, and `env`. |\r\n| `acp.autoApprovePermissions` | `ask` | How agent permission requests are handled: `ask` or `allowAll`. |\r\n| `acp.defaultWorkingDirectory` | `\"\"` | Default working directory for agent sessions. Empty uses current workspace. |\r\n| `acp.logTraffic` | `true` | Log all ACP protocol traffic to the ACP Traffic output channel. |\r\n\r\n## Commands\r\n\r\nAll commands are accessible via the Command Palette (`Ctrl+Shift+P`):\r\n\r\n| Command | Description |\r\n|---------|-------------|\r\n| `ACP: Connect to Agent` | Connect to an agent |\r\n| `ACP: New Conversation` | Start a new conversation with the connected agent |\r\n| `ACP: Send Prompt` | Send a message to the agent |\r\n| `ACP: Cancel Current Turn` | Cancel the current agent turn |\r\n| `ACP: Disconnect Agent` | Disconnect from the current agent |\r\n| `ACP: Restart Agent` | Restart the current agent process |\r\n| `ACP: Open Chat Panel` | Focus the chat webview |\r\n| `ACP: Add Agent Configuration` | Add a new agent to settings |\r\n| `ACP: Remove Agent` | Remove an agent configuration |\r\n| `ACP: Set Agent Mode` | Change the agent's operating mode |\r\n| `ACP: Set Agent Model` | Change the agent's model |\r\n| `ACP: Show Log` | Open the ACP Client log output channel |\r\n| `ACP: Show Protocol Traffic` | Open the ACP Traffic output channel |\r\n| `ACP: Browse Agent Registry` | Browse the ACP agent registry |\r\n\r\n## Keyboard Shortcuts\r\n\r\n| Shortcut | Action |\r\n|----------|--------|\r\n| `Ctrl+Shift+A` (`Cmd+Shift+A` on Mac) | Open Chat Panel |\r\n| `Escape` (when turn in progress) | Cancel Current Turn |\r\n\r\n## Development\r\n\r\n### Prerequisites\r\n\r\n- Node.js 18+\r\n- VS Code 1.85+\r\n\r\n### Setup\r\n\r\n```bash\r\ngit clone https://github.com/your-username/vscode-acp.git\r\ncd vscode-acp\r\nnpm install\r\n```\r\n\r\n### Build \u0026 Run\r\n\r\n```bash\r\nnpm run compile    # One-time build\r\nnpm run watch      # Watch mode for development\r\n```\r\n\r\nPress `F5` in VS Code to launch the Extension Development Host.\r\n\r\n### Testing\r\n\r\n```bash\r\nnpm run pretest    # Compile tests + lint\r\nnpm test           # Run tests\r\n```\r\n\r\n### Packaging\r\n\r\n```bash\r\nnpm run package    # Production build\r\nnpx @vscode/vsce package   # Create .vsix\r\n```\r\n\r\n## Architecture\r\n\r\nThe extension follows a modular architecture:\r\n\r\n- **Core**: `AgentManager`, `ConnectionManager`, `SessionManager`, `AcpClientImpl`\r\n- **Handlers**: `FileSystemHandler`, `TerminalHandler`, `PermissionHandler`, `SessionUpdateHandler`\r\n- **UI**: `SessionTreeProvider`, `ChatWebviewProvider`, `StatusBarManager`\r\n- **Config**: `AgentConfig`, `RegistryClient`\r\n- **Utils**: `Logger`, `StreamAdapter`\r\n\r\nCommunication with agents uses the ACP protocol (JSON-RPC 2.0 over stdio).\r\n\r\n## Known Issues\r\n\r\n- Agents must be available via the system PATH or `npx`\r\n- Some agents may require additional authentication setup\r\n- File attachment feature is not yet functional\r\n\r\n## Links\r\n\r\n- [ACP Client on Visual Studio Code Marketplace](https://marketplace.visualstudio.com/items?itemName=formulahendry.acp-client)\r\n- [Agent Client Protocol](https://agentclientprotocol.com/)\r\n- [GitHub Repository](https://github.com/nicepkg/vscode-acp)\r\n\r\n## License\r\n\r\nMIT — see [LICENSE](LICENSE) for details.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fformulahendry%2Fvscode-acp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fformulahendry%2Fvscode-acp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fformulahendry%2Fvscode-acp/lists"}