pi-codex-connectors Skill 技能

项目简介

pi-codex-connectors 是一款为 Pi 编程 Agent 打造的扩展包，让你在 Pi 任意模型（Anthropic、OpenAI、本地模型……）下都能复用 ChatGPT Codex 账号里已经授权的全部 Connector——GitHub、Gmail、Google Calendar / Drive、Slack、Linear、Figma 等。Codex 继续掌管你的登录态与 Connector 凭据，Pi 这边只需一个轻量 stdio 通道把工具调用透传过去，避免每个 Pi 模型都要重新接入一遍。

核心能力

1. 跨模型复用 Connector：Codex 一处登录，Pi 全模型可用。通过 codex_connectors / codex_connector_schema / codex_connector_call 三个工具把上百条 schema 屏蔽成清晰接口。
2. Codex app-server 自动托管：首次使用由扩展启动 codex app-server（stdio），按需拉起一个无模型、仅启用 apps 通道的临时线程。
3. 动态目录构建：通过 app/installed + mcpServerStatus/list 实时拉取可用 Connector 与工具清单，避免硬编码。
4. 写入策略可配置：PI_CODEX_CONNECTORS_WRITES 环境变量支持 ask（默认 TUI 弹窗）/ allow（自动化放行）/ deny（永不执行），并对超过 2000 字符的参数强制人工确认。
5. 会话级授权与会话隔离：会话开始时请求一次性授权；切换会话或更换模型都会重置授权，避免跨会话泄漏敏感数据。
6. 可选白名单：PI_CODEX_CONNECTORS_ALLOW=GitHub,Linear（逗号分隔）限制可发现的 Connector 范围，最小化暴露面。

安装配置

1. 环境前置：Node.js 22.19+、已安装 Pi（npm:@mariozechner/pi-coding-agent）。
2. Codex 登录：codex login（用已连接 GitHub / Gmail 等 Connector 的 ChatGPT 账号）。
3. 安装扩展：pi install npm:@wileai/pi-codex-connector；项目级则写到 ~/.pi/agent/settings.json 或 .pi/settings.json 的 packages 数组。
4. 可选环境变量：PI_CODEX_CONNECTORS_CODEX（自定义 Codex 可执行）、PI_CODEX_CONNECTORS_ALLOW（白名单）、PI_CODEX_CONNECTORS_WRITES（写入策略）、PI_CODEX_CONNECTORS_DATA（无头模式必须显式 allow）。
5. 更新与回滚：pi update npm:@wileai/pi-codex-connector 升级；旧包名 pi-codex-connectors 需先 pi remove 再重新安装。

使用步骤

1. 在 Pi 中输入 /codex-connectors（加 refresh 强制刷新）查看当前 Connector 目录。
2. 模型按需调用 codex_connectors 列出相关 Connector，再用 codex_connector_schema 取参数 schema。
3. 模型用 codex_connector_call 发起调用，写入类工具按 PI_CODEX_CONNECTORS_WRITES 走确认流程。
4. 大结果在内存中被截断（不落盘），可用窄查询 / 分页继续拉取更多。

适用场景

• 用 Pi 跑 Anthropic / OpenAI / 本地模型，又想借 Codex 的 Connector 生态做研究、文档、Issue、看板操作。
• 团队里只有部分成员开通 ChatGPT Plus / Pro 的 Connector 权限，可让所有人通过 Pi 间接使用。
• 在 CI / 自动化里跑只读 Connector 操作（GitHub issue 查询、Google Calendar 排期查询）。
• 多模型协作场景下统一工具调用入口，避免每个模型都重做一遍 MCP 接入。
• 给现有 Pi 工作流加上邮件 / 日历 / 文档同步能力。

适用人群

• Pi / Claude Code / Codex 多模型混用的开发者。
• 已经订阅 ChatGPT Plus / Pro、深度使用 Connector 的个人或小团队。
• 想把 Connector 当 MCP Server 用、又不想自己写桥接脚本的 Agent 集成方。

工作原理

扩展启动后用 stdio 把 Codex app-server 拉起，开一个无模型的临时 Codex 线程（只开 apps 通道，关闭用户自己注册的 MCP 服务器）。通过 MCP 标准接口（app/installed、mcpServerStatus/list、mcpServer/tool/call）枚举并调用 Connector；Codex 负责 OAuth 与凭据管理，Pi 这边完全不接触 token，所有工具结果都直接喂给当前 Pi 模型。

官方链接

• GitHub 仓库：https://github.com/wileai/pi-codex-connectors
• 项目主页：https://wileai.github.io/pi-codex-connectors/
• 许可证：MIT