Acp Studio — Git skill for Claude Code

ACP Studio

**English summary** — ACP Studio is a desktop (Electron) and web workbench for any coding agent that speaks the [Agent Client Protocol (ACP)](https://agentclientprotocol.com) over stdio. It ships presets for Codex, Claude Code, Gemini CLI, Cursor CLI, GitHub Copilot CLI, OpenCode, DeepSeek Harness and Google Antigravity, reuses each CLI's own local login (no API keys stored), and gives you sessions & history, a permission-approval flow, tool-call/plan visualisation, an integrated PTY terminal, @-file mentions and git diff review/undo for each agent turn. Stack: React 19 + Vite + Tailwind v4 front end, Hono gateway (Bun or Node), Electron shell.

ACP Studio 是一个**通用 ACP 编码智能体工作台**：把任何支持 ACP（Agent Client Protocol）的命令行编码智能体接进同一个图形界面， 在桌面端（Electron）或浏览器里和它们对话、审批它们的操作、查看它们改了哪些文件。

---

功能

以下功能都已在代码中实现（括号内为主要实现位置）：

**多智能体接入**

• 内置 8 个预设，统一走各家官方 CLI，复用其本地登录态，Studio 不保存任何密钥（server/universal/presets.ts）
• 自定义智能体：界面里添加，或用 ACP_AGENTS_JSON 环境变量 / ~/.acp-studio/agents.json 配置 {id, command, args, env}（server/universal/registry.ts、src/components/universal/CustomAgentModal.tsx）
• 连接时做 initialize 能力协商，按智能体实际能力开关界面功能（fork、providers、附加目录、图片输入等）

**会话**

• 新建 / 加载（历史回放）/ 恢复 / 列表 / 关闭 / 删除 / fork 会话；可设置 cwd、附加目录、MCP servers（src/hooks/useSessionLifecycle.ts、src/components/universal/SessionSettingsModal.tsx）
• 本地会话记录（按智能体隔离，存浏览器 localStorage，src/lib/threads.ts）
• 模式切换、模型 / 思考等级等配置项、Providers 面板（ModelBrowserModal.tsx、ProvidersModal.tsx）

**对话与可视化**

• 流式渲染正文、思考过程（可折叠）、工具调用状态、计划（plan）、slash 命令联想、token 用量与费用（src/lib/universal-api.ts、src/components/assistant/）
• Markdown + 代码高亮（Shiki）+ Mermaid 图（按需加载）
• 附件：文本、图片、文件拖拽 / 粘贴
• @ 引用工作区文件（只读搜索，限定在 cwd 内，/api/universal/workspace/files）
• 生成中继续发送会进入队列；支持“插队”；传输类错误自动重试（默认 2 次）（src/hooks/useChatSend.ts）

**审批与表单**

• 智能体请求权限（session/request_permission）时弹出审批卡片（PermissionDialog.tsx）
• 智能体请求结构化输入（elicitation/create）时按 JSON Schema