Pi — Mopheus Docs

pi-coding-agent 是开源智能体 CLI。Mopheus 使用 --mode rpc 启动 Pi，并通过标准输入/输出上的 RPC 消息控制会话、提交 prompt 和接收事件。启动时始终使用 --session-id <session-id>；恢复任务时复用同一个 ID，因此 session 文件被清理后 Pi 会自动重建，而不是启动失败。session 目录通过 PI_CODING_AGENT_SESSION_DIR 按 workspace 隔离。

项目	值
二进制文件	`pi`
路径覆盖变量	`MOPHEUS_PI_PATH`
验证命令	`pi --version`
最低版本	0.67.2
协议	RPC
任务 Skill 路径	`.pi/skills/`
文件系统沙箱	Linux 支持

使用 Mopheus 自带安装器时，会将内容保持不变的 Pi standalone 发布包解压到 $HOME/.local/pi，并在 $HOME/.local/bin/pi 创建 pi 可执行文件链接。如果 PATH 中已有 pi 命令，安装器会保留它并跳过内置副本。也可以继续使用 npm install -g --ignore-scripts @earendil-works/pi-coding-agent 手动安装；自定义命令路径时可手动设置 MOPHEUS_PI_PATH，或参考 pi 安装指南。

Pi 使用两个配置文件：~/.pi/agent/models.json 定义自定义 Provider 和模型，~/.pi/agent/settings.json 设置默认 Provider 和模型。Mopheus 不管理这些文件或 Pi 的全局 auth.json。当前 Mopheus 前端不会向 Pi 传入模型选择，因此 Pi 使用 settings.json 中配置的默认模型。下面的 models.json 示例同时配置私有 OpenAI 兼容接口和智谱 GLM Coding Plan；Coding Plan key 必须使用专用 endpoint https://open.bigmodel.cn/api/coding/paas/v4，不能使用普通 API endpoint https://open.bigmodel.cn/api/paas/v4。API key 通过环境变量提供：

{
  "providers": {
    "private": {
      "baseUrl": "https://llm.example.com/v1",
      "api": "openai-completions",
      "apiKey": "${PRIVATE_LLM_API_KEY}",
      "models": [{ "id": "private-coder" }]
    },
    "glm": {
      "baseUrl": "https://open.bigmodel.cn/api/coding/paas/v4",
      "api": "openai-completions",
      "apiKey": "${GLM_API_KEY}",
      "models": [{ "id": "glm-5.2" }]
    }
  }
}

将对应密钥导出到启动 Mopheus daemon 的环境中。详见 pi 自定义模型文档和智谱 API 文档。

在 ~/.pi/agent/settings.json 中设置默认模型。下面以 GLM 为例；使用私有模型时，将 defaultProvider 改为 private，并将 defaultModel 改为 private-coder：

{
  "defaultProvider": "glm",
  "defaultModel": "glm-5.2"
}

Pi

On this page