全部智能体 CLI
NeuroSquad 中的 pi

pi 保持极简。其余交给画布

pi 刻意没有 MCP、没有钩子、没有权限弹窗。NeuroSquad 按 pi 推荐的方式加载一个扩展，于是每张 pi 卡片都知道它是在工作、在等你，还是已完成；通过箭头使用终端、笔记和其他智能体；会话和费用一目了然。

下载 Windows 版看看实际效果
官方网站pi.dev
  • 真实的 pi，你自己的登录
  • 不写入 ~/.pi
  • 免费，支持 Windows 10 和 11
扩展事件

它知道 pi 何时完成——靠 pi 自己的事件

pi 没有钩子系统，但有扩展 API。NeuroSquad 扩展监听 pi 的三个事件，把每一轮报告给它的卡片。

agent_startpi 事件
工作中

pi 开始一轮。卡片图标开始旋转，“团队状态”卡片把它计为工作中，上一条通知随之撤下。

ui_prompt_startpi 事件
等你处理

某个扩展打开了对话框——你自己的权限闸门，或 NeuroSquad 在调用第三方工具前的询问。卡片闪烁，通知显示对话框的标题。

agent_settledpi 事件
已完成

没有剩下的事：没有重试、没有压缩、没有排队的消息。队列里的下一条提示发出，上下文指示器拿到 pi 自己的数字。

pi 从不询问——除非你想要

它自带的工具不弹窗直接运行。任何扩展的对话框（例如 pi 示例里的 permission gate）都会让卡片变成“等你处理”。

“已完成”就是真的完成

只有在 pi 没有重试、压缩或后续消息时才触发 agent_settled，重试途中不会被当成完成。

一点即达

点击通知会切换到对应工作区，镜头飞到那张卡片并让它闪烁。

看看实际效果

你会用 pi 做的三件事

应用的复刻，一步步播放。对话框提问时，由你来回答。

pi 用自带工具修复失败的测试，权限闸门扩展在删除前拦下它，这一轮结束时工作日志自动写好。

它能得到的一切

pi 在 NeuroSquad 中的全部能力

全部来自一个扩展文件和 pi 自己的参数。凡是 NeuroSquad 为 pi 补上的东西，卡片上都会注明。

  • 01

    清楚自己的状态

    pi 自己的扩展事件报告每一轮，不靠安静的终端去猜。

  • 一个扩展，由 pi 自己加载

    每张卡片都以 -e neurosquad-extension.js 启动——所有卡片同一个文件，每次启动重写。卡片专属的一切都在环境变量里；文件和参数里没有任何密钥。

    文档: 一个扩展，由 pi 自己加载

  • “已完成”和“在等你”是两回事

    agent_start 标记工作中，ui_prompt_start 标记在等你，agent_settled 标记已完成。回答对话框（ui_prompt_end）后恢复工作中。

    文档: “已完成”和“在等你”是两回事

  • 通知用对话框自己的话

    通知第一行就是 pi 正在显示的对话框标题，例如 ⚠️ Dangerous command: rm -rf dist。每个智能体一条；等待中的通知会一直保留到你回答；点击即飞到卡片。

    文档: 通知用对话框自己的话

  • 每张卡片都是独立会话

    首次启动用卡片 id 作 --session-id，之后用 --session。/new、/resume、/fork 都会被跟踪，重启后继续你真正所在的会话。

    文档: 每张卡片都是独立会话

  • “团队状态”卡片

    工作区里所有 AI 智能体都在一张卡片上，并显示模型——来自 pi 的会话日志，首轮之前则取 pi 自己设置里的默认值。

    文档: “团队状态”卡片
  • 02

    通过画布工作

    pi 没有 MCP 客户端，于是扩展充当它。从卡片引出的箭头就是一组工具。

  • NeuroSquad 实现

    箭头就是工具

    扩展是一个小型 MCP 客户端：画一条箭头连到终端、笔记、浏览器或智能体，pi 就会以自己工具的形式获得 neurosquad_terminal_*、neurosquad_note_* 等。

    文档: 箭头就是工具
  • NeuroSquad 实现

    同一轮就能用上新工具

    出现新箭头时，扩展重新列出工具并启用新的。自己画出箭头的调用会等这一步完成，所以 pi 能立刻使用新卡片。

    文档: 同一轮就能用上新工具

  • 它能自己添加卡片

    canvas_spawn_card 会在旁边打开终端、笔记、浏览器或助手——另一个带首条提示的 pi——并已用箭头连好。

    文档: 它能自己添加卡片

  • 画布模式

    pi 以 --exclude-tools bash,powershell 启动，命令在你能看到的终端卡片里运行。pi 本身没有网页工具，无需再关。

    文档: 画布模式
  • NeuroSquad 实现

    MCP 服务器，每次调用都询问

    从 MCP Registry 安装的服务器通过扩展接入 pi。每次调用前，pi 会显示 NeuroSquad 的对话框：Allow once、Allow for this session 或 Deny。

    文档: MCP 服务器，每次调用都询问
  • 03

    为长时间运行而生

    上下文占满、失败的轮次和预算，都在卡片上处理。

  • 上下文指示器

    每轮结束时 pi 报告自己的统计——令牌数和本轮所用模型的窗口——所以圆环显示的正是 pi 压缩所依据的数字。

    文档: 上下文指示器

  • 压缩

    “压缩”按钮发送 pi 自己的 /compact。

    文档: 压缩

  • 达到上限后继续

    pi 会先自行重试。若这一轮仍然失败，会报告错误文本和 Retry-After；卡片倒计时到重置时刻并发送 “continue”。

    文档: 达到上限后继续

  • 提示队列

    把接下来的消息排好：每条都在 pi 真正结束后发出，绝不会在重试或后续消息途中。每日提示也一样。

    文档: 提示队列

  • 工作日志与交接

    最后的回答从 pi 的会话文件读取：每轮后写入相连的笔记，写进新智能体的首条提示，或返回给在 agent_wait 中等待的主导智能体。

    文档: 工作日志与交接
  • 04

    团队协作

    多个 pi 智能体——或多种 CLI 混用——在同一个项目上互不干扰。

  • 隔离的 worktree

    给智能体一个独立的 git worktree，并行的智能体就不会改同一批文件。设置命令和要复制的文件会在 pi 启动前准备好它。

    文档: 隔离的 worktree

  • 添加审阅者

    一键在同一个 worktree 中启动另一种 CLI 的智能体，从 pi 引出箭头，并附上“只审阅、不修改任何内容”的提示。

    文档: 添加审阅者
  • NeuroSquad 实现

    来自 skills.sh 的技能

    连到技能卡片的箭头会给 pi 提供 skill_load，列出每个技能及其适用时机——与其他工具走同一个扩展。

    文档: 来自 skills.sh 的技能

  • 不会卡在项目信任上

    pi 在信任项目自带的 .pi 或 .agents/skills 前会询问。文件夹是你选的，所以卡片传入 --approve——仅限本次运行，不写入 pi 的信任列表。

    文档: 不会卡在项目信任上

  • 没有危险模式——也不需要

    pi 运行工具前从不询问，所以 pi 卡片始终像其他 CLI 的危险模式那样工作。开关被隐藏，而不是假装有用。

    文档: 没有危险模式——也不需要
  • 05

    费用、控制与访问

    花了多少、还能花多少、用哪个模型，以及如何访问它。

  • 精确的用量与费用

    从 pi 自己的会话文件读取，连同 pi 记录的费用。卡片进入过的每个会话都算在它名下，工具自己调用模型产生的用量也会计入。

    文档: 精确的用量与费用

  • 预算刹车

    超过工作区上限时，卡片收到 Escape——Ctrl+C 只会清空 pi 的编辑器，按第二次还会退出。会话保留；自动提示暂停，直到你提高上限。

    文档: 预算刹车

  • OpenRouter 模型

    扩展用卡片的密钥注册自己的提供方，你在 pi 中保存的登录无法覆盖它。密钥只存在于这张卡片的环境变量里。

    文档: OpenRouter 模型

  • 以 NeuroSquad 署名

    在每个发往 OpenRouter 的请求上——包括你自己的 pi 登录——扩展都会把 pi 的署名请求头替换为 NeuroSquad 的。

    文档: 以 NeuroSquad 署名

  • 在手机上

    扫描二维码，整块画布就会在手机浏览器中打开：查看 pi 的终端，回答对话框，发送下一条提示。

    文档: 在手机上
一目了然

谁在等待，花了多少

同时运行多个 pi 智能体时，这两张卡片回答你最常问的问题。

“团队状态”卡片

工作区里每个智能体的状态、模型和本轮用时。等你的排在最前，并显示对话框标题。点击某个状态即可筛选。

  • coupon-fixPiclaude-sonnet-4-5⚠️ Dangerous command: rm -rf dist — Allow?等你处理3:51
  • api-migrationPiclaude-sonnet-4-5把路由迁移到新客户端工作中12:24
  • deps-auditPigpt-5-mini检查过时的依赖工作中4:08
  • docs-passPigpt-5-mini更新 README已完成6分钟前

用量与费用

从你磁盘上 pi 的会话文件读取，带有 pi 为每个请求记录的费用，并按卡片报告过的会话归属到卡片。

智能体令牌费用
coupon-fix1,108,442US$2.68
api-migration796,120US$1.71
docs-pass241,906US$0.09
总计2,146,468US$4.48
精确到皮美元，仅在显示时四舍五入。执行 /new 或 /resume 后，卡片用过的每个会话仍算在它名下。
幕后

真实的 pi，加上几个参数

NeuroSquad 启动的就是你自己运行的那个 pi，运行在卡片内的真实终端中。它添加的全部内容如下：

NeuroSquad 为命令添加的参数
❯ pi
--session-id <card id>首次启动卡片 id 成为 pi 的会话 id
--session <its session id>之后的启动重启后继续 pi 最后报告的会话
--approve每次启动信任本项目自带的 pi 文件，仅限本次运行
-e <userData>/pi/neurosquad-extension.js每次启动状态、MCP 工具、对话框和 OpenRouter——所有卡片同一个文件
NEUROSQUAD_MCP_TOKEN, NEUROSQUAD_HOOK_URL … in the environment每次启动这张卡片的地址和令牌，不落盘、不进 argv
--exclude-tools bash,powershell卡片模式关闭 pi 的 shell 工具，改用画布上的终端

不写入 ~/.pi

你自己的 pi 的设置、登录、扩展和会话都不受影响。扩展放在 NeuroSquad 的数据文件夹里。

没有危险模式参数

没有可跳过的东西：pi 运行工具前从不询问。使用 OpenRouter 的卡片会加上 --model neurosquad-openrouter/<模型>。

用 Escape 中断

Escape 会停止 pi 的这一轮并保留进程。预算刹车和其他停止操作都用它；Ctrl+C 会清空输入或直接退出。

常见问题

关于 NeuroSquad 中的 pi

给 pi 一块画布

免费支持 Windows 10 和 11。你的代码、登录和费用都留在你的电脑上。

下载 Windows 版阅读文档
Windows 10 / 11 · 64 位全部 19 款智能体 CLI