Paigy 是一个 MCP（Model Context Protocol）服务器，定位为 AI 智能体的语音收件箱。它的核心目标是解决长时间运行的智能体会话中，用户必须一直守在终端旁、否则可能错过智能体提问导致任务停滞的问题。当智能体真正需要用户做出决策时，Paigy 会按照与当下情境匹配的紧急程度把用户的手机拉入循环中。
【主要能力】 Paigy 支持多种联系用户的方式，紧急程度由低到高分为四个等级："inbox"（静默，留在收件箱）、"push"（安静的无声音被动通知）、"banner"（带声音的时效性锁屏横幅）、"call"（拨打手机）。 urgency 是一个请求而非保证，用户账户设置可以将其上限调低。用户可以通过语音或文字回复，回复会像任何其他工具响应一样返回给智能体，智能体随即继续执行，无需复制粘贴或重新打开终端。它还配合原生 Paigy iOS 应用，即使手机锁屏也能像真实电话一样响铃（CallKit），并可在锁屏界面查看或回复。
【使用方式】 Paigy 是一个标准 MCP 服务器（基于 stdio、TypeScript），不包含任何客户端专属代码，并已通过原始协议在非 Claude 客户端身份下验证。它支持多种接入方式：Claude Code（该仓库同时是它的插件与市场）、以及通过标准配置接入的其他 MCP 客户端，包括 Cline、Continue.dev、Zed、Cursor、Goose、mcphost，也支持基于 Ollama、LM Studio 或 llama.cpp 的本地模型环境。项目提供一行安装命令，适用于任意终端，可自动检测用户的智能体（Claude Code、Codex、Antigravity），将 Paigy 接入每一个智能体并完成一次手机配对。所有命令在执行前都会打印出来，使用 --dry-run 可查看计划。用户也可以手动配置。
Claude Code 插件方式最简便：连接后自动生效，未配对时首次使用会提示用户配对，运行 /paigy-onboard 会打开浏览器进行批准。Claude Desktop 可通过 MCPB 包在无终端情况下安装：下载 paigy.mcpb 后，在 Claude Desktop 中打开设置 → 扩展，将文件拖入（或双击）。之后让 Claude "pair with Paigy" 即可完成配对并显示一个在手机上批准用的代码。
每个会话在首次到达 Paigy 时会自动生成自己的身份，无需设置或匹配智能体名称。只有在刻意希望某客户端始终以固定命名身份发言时，才设置 PAIGY_AGENT=<name>，并用同名运行 onboard。在手机上批准后，登录 paigy.ai 即可开始接收消息。
【回复形态选择】 notify_user 应以最快可回答的形态提问，不要把决策留作自由文本。可用 select（配合 options）让用户从选项中挑选；confirm 可直接从横幅上用 Yes/No 或 Approve/Deny 按钮回答；其他 paige 会带横幅操作 "See Options · Hear them · Remind me later"。
【停滞任务处理】 当会话停止且其智能体拥有 Paigy Goals、并连续三天没有进展时，一个 Stop hook 会每天一次拦截停止并列出这些目标，让智能体在安静下来之前更新、完成或取消每一项。该功能是自动的、无需配置，由 @paigy/mcp（0.40.15 或更高版本）运行 paigy-stalled。除此以外保持静默：没有停滞任务、停止已被某个 hook 继续、当天已提醒过，或任何错误。Claude Code 通过插件接入 hooks/hooks.json，无需设置；Codex CLI 通过 Codex 插件接入 plugins/paigy/hooks/hooks.json，需先审阅并信任 Paigy hook；其他具备 Claude 风格 Stop hook 的 harness 可注册 npx -y -p @paigy/mcp@latest paigy-stalled 作为 Stop 命令。
【适用场景与限制】 适用于需要用户中途决策、被阻塞或长时间运行的智能体会话，让用户无需守在终端旁。对于较小或本地模型，工具描述要求智能体根据情境在几种回答形态（confirm、options、自由文本）中选择，Claude 能可靠遵循，较小的本地模型可能不太一致，自由文本始终可作为回退。应用与后端位于单独的仓库中。
