自定义 Provider CLI

Mopheus 支持两种方式接入内置列表之外的 Provider：

自定义别名：克隆内置 Provider 的协议和行为，同时修改命令、路径环境变量或启动参数。
ACP Provider：接入任何实现 Agent Client Protocol 的 CLI。

注册信息保存在当前 Mopheus profile 的 providers.json 中。

自定义别名

使用 --uses-provider 继承内置 Provider：

mopheus provider register my-claude \
  --uses-provider claude \
  --cmd-name my-claude \
  --env-var MY_CLAUDE_PATH

别名会继承源 Provider 的协议、Skill 注入路径、文件系统沙箱能力和默认交互行为。注册参数可以覆盖命令和环境变量。

ACP Provider

使用 CLI 的命令名注册兼容 ACP 的 CLI：

mopheus provider register my-agent acp --cmd-name my-agent

mopheus provider register kiro acp \
  --cmd-name kiro-cli \
  --env-var KIRO_PATH

除非 Provider 声明更强的能力，ACP Provider 使用下一 turn 交互投递。默认 home 和 workdir 子目录使用命令 basename，而不是 Provider 别名；需要时显式覆盖：

mopheus provider register qoder acp \
  --cmd-name qodercli \
  --home-subdir .qoder \
  --workdir-subdir .qoder

ACP 无人值守参数

注册时可以声明 Provider 的启动参数和无人值守权限策略：

mopheus provider register qoder acp \
  --cmd-name qodercli \
  --acp-args=--acp,--permission-mode,bypass_permissions \
  --blocked-custom-args=--permission-mode,--dangerously-skip-permissions \
  --unattended-mode bypassPermissions \
  --verify-unattended-before-prompt

请按 CLI 实际需要设置最小权限策略。文件系统沙箱见文件系统沙箱。

管理注册项

mopheus provider list
mopheus provider remove my-agent

只有能通过配置的路径环境变量或 $PATH 找到的已注册命令，才会作为可用 runtime 展示。