引擎

网关通过行业标准 ACP（stdio JSON-RPC）拉起上游 CLI。Shepaw 不改它们的行为，只把会话、模型、权限和终端代理到 App。目前内置 42 个引擎，也可用 engine add 注册自定义 CLI。

`--engine`	名称	上游命令
`claude-code`	Claude Code	`npx -y @agentclientprotocol/claude-agent-acp@latest`
`codex`	Codex	`npx -y @agentclientprotocol/codex-acp@latest`
`cursor`	Cursor	`agent acp`
`copilot`	GitHub Copilot	`copilot --acp`
`gemini`	Gemini CLI	`npx -y @google/gemini-cli@latest --acp`
`qwen-code`	Qwen Code	`qwen --acp`
`glm`	GLM Agent	`npx -y glm-acp-agent@latest`
`zcode`	ZCode	`npx -y zcode-acp-server@latest`
`deepseek-harness`	DeepSeek Harness	`npx -y @deepseek-ai/dsh-acp-demo@latest`
`kimi`	Kimi CLI	`kimi acp`
`codebuddy`	CodeBuddy Code	`codebuddy --acp`
`traecli`	TRAE CLI	`traecli acp serve`
`grok`	Grok	`grok agent stdio`
`pi`	Pi	`npx -y pi-acp`
`opencode`	OpenCode	`npx -y opencode-ai@latest acp`
`openclaw`	OpenClaw	`npx -y openclaw acp`
`hermes`	Hermes	`hermes acp`
`cline`	Cline	`npx -y cline@latest --acp`
`goose`	goose	`goose acp`
`junie`	Junie	`junie --acp true`
`auggie`	Auggie CLI	`npx -y @augmentcode/auggie@latest --acp`
`amp`	Amp	`amp-acp`
`factory-droid`	Factory Droid	`npx -y droid@latest exec --output-format acp-daemon`
`qoder`	Qoder CLI	`npx -y @qoder-ai/qodercli@latest --acp`
`kilo`	Kilo	`kilo acp`
`codewhale`	CodeWhale	`codewhale serve --acp`
`cortex-code`	Cortex Code	`cortex acp serve`
`vtcode`	VT Code	`vtcode acp`
`mistral-vibe`	Mistral Vibe	`vibe-acp`
`agoragentic`	Agoragentic	`npx -y agoragentic-mcp@latest --acp`
`autohand`	Autohand Code	`npx -y @autohandai/autohand-acp@latest`
`deepagents`	DeepAgents	`npx -y deepagents-acp@latest`
`dimcode`	DimCode	`npx -y dimcode@latest acp`
`dirac`	Dirac	`npx -y dirac-cli@latest --acp`
`fast-agent`	fast-agent	`uvx --from fast-agent-acp fast-agent-acp -x`
`minion-code`	Minion Code	`uvx --from minion-code minion-code acp`
`nova`	Nova	`npx -y @compass-ai/nova@latest acp`
`poolside`	Poolside	`pool acp`
`sigit`	siGit Code	`sigit`
`stakpak`	Stakpak	`stakpak acp`
`crow-cli`	crow-cli	`crow-cli acp`
`corust-agent`	Corust Agent	`corust-agent-acp`

自定义引擎

custom

shepaw-hub engine add my-agent --display "My Local Agent" --command "my-cli acp"

shepaw-acp-proxy serve --engine my-agent --engine-display-name "My Agent" \
  --acp-command "my-cli acp" --cwd ~/project --port 8090

自定义引擎写在 hub.json 的 customEngines，仪表盘引擎选择器里能看到。

Custom engines live in hub.json under customEngines and show up in the dashboard picker.

模型、模式、权限

ACP configOptions（category model）映射到 App 的模型列表 / 切换
PAW_ACP_SESSION_MODE 在 session 创建或恢复后写入上游（Claude acceptEdits、Codex on-request 等）
剩余 session/request_permission 默认问 App（PAW_ACP_APPROVAL_MODE=ask）
上游 terminal/* 在网关主机执行

凭据

在仪表盘「设置 → 引擎管理」，或给实例设置环境变量（ANTHROPIC_API_KEY、CURSOR_API_KEY …）。引擎没就绪时创建/启动实例会失败。

Use Settings → Engines in the dashboard, or instance env vars (ANTHROPIC_API_KEY, CURSOR_API_KEY, …). Creating or starting an instance fails if the engine is not ready.

引擎

Engines

自定义引擎

Custom engines

模型、模式、权限

Models, modes, permissions

凭据

Credentials