PI agent

Published on 2026-06-02

Last updated on 2026-06-02

Technical

Pi Agent

install the main app

1
curl -fsSL https://pi.dev/install.sh | sh

install packages

1
❯ pi list
2
User packages:
3
  npm:pi-mcp-adapter
4
    /home/jenningsl/.pi/agent/npm/node_modules/pi-mcp-adapter
5
  npm:pi-web-access
6
    /home/jenningsl/.pi/agent/npm/node_modules/pi-web-access
7
  npm:pi-codex-goal
8
    /home/jenningsl/.pi/agent/npm/node_modules/pi-codex-goal
9
  npm:pi-dynamic-workflows
10
    /home/jenningsl/.pi/agent/npm/node_modules/pi-dynamic-workflows
11
  npm:pi-subagents
12
    /home/jenningsl/.pi/agent/npm/node_modules/pi-subagents
13
  npm:pi-chrome
14
    /home/jenningsl/.pi/agent/npm/node_modules/pi-chrome
15
  npm:pi-cache-graph
16
    /home/jenningsl/.pi/agent/npm/node_modules/pi-cache-graph
17
  npm:pi-intercom
18
    /home/jenningsl/.pi/agent/npm/node_modules/pi-intercom
19
  npm:pi-playwright
20
    /home/jenningsl/.pi/agent/npm/node_modules/pi-playwright
21
  npm:pi-browser-cdp-extension
22
    /home/jenningsl/.pi/agent/npm/node_modules/pi-browser-cdp-extension
23
  npm:@ff-labs/pi-fff
24
    /home/jenningsl/.pi/agent/npm/node_modules/@ff-labs/pi-fff
25
  npm:pi-simplify
26
    /home/jenningsl/.pi/agent/npm/node_modules/pi-simplify
27
  npm:@rezamonangg/pi-worktree
28
    /home/jenningsl/.pi/agent/npm/node_modules/@rezamonangg/pi-worktree

config default providers ~/.pi/agent/auth.json

1
{
2
  "deepseek": { "type": "api_key", "key": "YOUR_API_KEY" }
3
}

config custom providers ~/.pi/agent/models.json via https://pi.dev/models

1
{
2
  "providers": {
3
    "hai": {
4
      "baseUrl": "http://localhost:6655/anthropic",
5
      "api": "anthropic-messages",
6
      "apiKey": "YOUR_API_KEY",
7
      "models": [
8
        {
9
          "id": "anthropic--claude-opus-latest",
10
          "name":"anthropic--claude-opus-latest",
11
          "reasoning": true,
12
          "compat": {
13
            "forceAdaptiveThinking": true
14
          }
15
        },
16
        {
17
          "id": "anthropic--claude-sonnet-latest",
18
          "name":"anthropic--claude-sonnet-latest",
19
          "reasoning": true,
20
          "compat": {
21
            "forceAdaptiveThinking": true
22
          }
23
        }
24
      ]
25
    },
26
    "glm": {
27
         "apiKey": "YOUR_API_KEY",
28
         "models": [
29
           {
30
             "id": "glm-5.1",
31
             "name": "GLM-5.1",
32
             "reasoning": true,
33
             "input": [
34
               "text"
35
             ],
36
             "contextWindow": 200000,
37
             "maxTokens": 131072,
38
             "cost": {
39
               "input": 0,
40
               "output": 0,
41
               "cacheRead": 0,
42
               "cacheWrite": 0
43
             },
44
             "compat": {
45
               "supportsDeveloperRole": false,
46
               "thinkingFormat": "zai",
47
               "zaiToolStream": true
48
             }
49
           }
50
         ],
51
         "api": "anthropic-messages",
52
         "baseUrl": "https://open.bigmodel.cn/api/anthropic"
53
       }
54
  }
55
}

扩展

功能扩展类

npm:pi-mcp-adapter：使用 Lazy load 的方式加载 mcp 服务器，我基本全局不会开启 MCP，在某些特定项目上会用。
npm:pi-web-access：支持多个 Provider 的搜索聚合，效果很佳（社区有更多别的选择，可以自己找更好的实现）
npm:pi-subagents / npm:pi-intercom ：这个更稳定一些。
npm:pi-codex-goal：实现 /goal 功能
npm:pi-browser-cdp-extension: use CDP to control brower
npm:pi-powerline-footer: Powerline 风格的状态栏扩展
npm:@narumitw/pi-statusline: Rich Statusline for the Pi Coding Agent
npm:@rezamonangg/pi-worktree
npm:pi-autoresearch：增加 autoresearch 功能，为 Pi 提供运行自主优化循环所需的工具和工作流：尝试一个想法、进行基准测试、保留改进、回滚退化、重复进行
npm:@ogulcancelik/pi-herdr：控制 herdr，比skills+CLI 控制更稳
npm:pi-chrome: 让 Pi 使用你已登录的 Chrome 配置文件

功能优化和管理类

npm:pi-cache-graph：显示缓存命中率的变化，可用来 Debug 影响上下文的扩展
npm:pi-command-history：使用 Ctrl + Up 来找相同目录的历史 command。(Pi 默认 Up 只能着同 session 的，很怪)
npm:pi-discord-remote：这个插件很有意思，开启后它会为每个 session 都配置单独的会话，结束对话后自动销毁。这样在 discord 那边用起来就很简单，尤其是自动销毁。
npm:@vanillagreen/pi-extension-manager：可以不用卸载扩展，而是禁用扩展。这玩意很卡，可以不用。
npm:@vanillagreen/pi-session-manager：可以更好的在历史 session 中检索、跳转什么的，用处不大。
https://github.com/monotykamary/pi-tps：显示模型输出速度等信息
npm:pi-cost：打开webui 显示tokens 使用情况
npm:pi-inspect：打开webui 显示模型完整的上下文用于调试

Agent 行为优化类：会修改 Pi Agent 自身行为，影响较大

npm:pi-rtk-optimizer：使用 rtk 大幅压缩 Bash Tool 的输出
npm:@ff-labs/pi-fff：优化文件、内容的搜索功能，效果很好，推荐。之前有Bug老crash，最新版本修了一些。
npm:pi-loadout：可以关闭特定的tools和skills
npm:pi-dynamic-workflows：增加类似于 Claude Dynamic Workflow 的功能。

Back to Blog