pi

badlogic/pi-mono
- MIT, TypeScript
- 一个固执己见（opinionated）且极简的终端编码助手，是 pi-mono 项目的一部分。支持多种 LLM 提供商（OpenAI, Anthropic, Google 等）和 MCP (Model Context Protocol)。
- 扩展性强
- 极简设计
  - 没有 MCP
  - 没有 Permission - 默认执行所有
  - 内置几个个 Tool
  - 没有 Plan
参考
会自动下载 fd, ripgrep
- Widnows C:\Users\$USER\.pi\agent\bin

# 安装
bun add -g @earendil-works/pi-coding-agent
# 或者使用 npm
npm install -g --ignore-scripts @earendil-works/pi-coding-agent

export PI_SKIP_VERSION_CHECK=1 # 只关版本检查
export PI_CACHE_RETENTION=long # 1h 缓存
export PI_TELEMETRY=0          # 关遥测

pi

Variable	Description
`PI_CODING_AGENT_DIR`	`~/.pi/agent`
`PI_PACKAGE_DIR`
`PI_SKIP_VERSION_CHECK`	关闭版本检测
`PI_TELEMETRY`	1/true/yes to enable or 0/false/no to disable
`PI_CACHE_RETENTION`	long (Anthropic: 1h, OpenAI: 24h)
`VISUAL`, `EDITOR`

~/.pi/agent/keybindings.json
PI_CODING_AGENT=true
- env 检测

快捷键	说明
主界面
Enter	提交输入
Shift+Enter	换行
Esc	中断/取消当前操作或生成
Ctrl+C	清空编辑器；在选择器里取消
Ctrl+D	编辑器为空时退出
Ctrl+Z	挂起到后台，之后可 fg 回来
Ctrl+G	用外部编辑器打开输入
Ctrl+V	粘贴剪贴板图片
Ctrl+L	打开模型选择器
Ctrl+P	切换到下一个模型
Shift+Ctrl+P	切换到上一个模型
Shift+Tab	切换 thinking level
Ctrl+T	展开/折叠 thinking blocks
Ctrl+O	展开/折叠 tool output
消息队列
Alt+Enter	Queue follow-up message；当前回复后继续发送
Alt+Up	Dequeue；把队列消息恢复到编辑器
编辑器
←/→/↑/↓	移动光标
Ctrl+A / Ctrl+E	行首 / 行尾
Ctrl+B / Ctrl+F	左/右移动一格
Alt+B / Alt+F	左/右移动一个词
Ctrl+W	删除前一个词
Alt+D	删除后一个词
Ctrl+U	删除到行首
Ctrl+K	删除到行尾
Ctrl+Y	粘贴最近删除内容
Alt+Y	循环 kill ring
Ctrl+-	撤销
pi -r/Resume
Ctrl+D	删除当前选中的 session - 会请求确认
Ctrl+P	显示/隐藏路径
Ctrl+N	只看 named sessions
Ctrl+S	切换排序
Ctrl+R	重命名

$PWD/.pi/
- settings.json
- SYSTEM.md
- APPEND_SYSTEM.md
- skills/
- prompts/
- extenstions/
- npm/
  - node_modules/
- git/
  - github.com/org/repo/
- themes/
~/.pi/agent
- auth.json
- models.json
- sessions/--PATH--/TIMESTAMP_UUID.jsonl
.agents/skills
- 主要支持 skills 递归向上查找

pi install -l npm:@org/pi-package
pi install -l git:github.com/org/repo

{
  "enableInstallTelemetry": false,
  "skills": [
    // "+/path/SKILL.md"
  ]
}

{
  "providers": {
    "name": {
      "baseUrl": "",
      "apiKey": "",
      "api": "openai-completions",
      "headers": {},
      "compact": {},
      "models": [
        {
          "id": "model-id",
          "name": "",
          "reasoning": true,
          "contextWindow": 128000,
          "maxTokens": 16384,
          "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
        }
      ],
      "modelOverrides": {}
    }
  }
}

https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/src/core/model-registry.ts

Awesome

# ~/.pi/agent/extensions/pi-rtk-optimizer
pi install npm:pi-rtk-optimizer

Session

# session dir
ls ~/.pi/agent/sessions/-$(echo "$PWD/" | sed 's#/#-#g')-
cd ~/.pi/agent/sessions/-$(echo "$PWD/" | sed 's#/#-#g')-

jq -r 'select(.type=="message" and .message.role=="user") | if (.message.content|type)=="string" then .message.content else [.message.content[]? | select(.type=="text") | .text] | join("\n---\n") end' *.jsonl

Inside

type KnownApi =
  | 'openai-completions'
  | 'mistral-conversations'
  | 'openai-responses'
  | 'azure-openai-responses'
  | 'openai-codex-responses'
  | 'anthropic-messages'
  | 'bedrock-converse-stream'
  | 'google-generative-ai'
  | 'google-vertex';

openrouter-images
OpenAI-compatible proxy / Ollama / vLLM / LM Studio：openai-completions
Anthropic-compatible proxy：anthropic-messages
Google AI Studio：google-generative-ai
OpenAI Responses-compatible：openai-responses

项	openai-responses	openai-codex-responses
目标	OpenAI 官方 Responses API	ChatGPT/Codex 后端
默认 endpoint	model.baseUrl 通常 /v1 下 Responses	https://chatgpt.com/backend-api/codex/responses
认证	OpenAI API key	Codex/ChatGPT auth token
传输	OpenAI SDK streaming	WebSocket 优先，SSE fallback
system prompt	转成 Responses input	单独放 instructions
tools	标准 Responses tools	Codex 兼容 tools，strict: null
retry/timeout	SDK request options	自定义 retry、SSE header timeout、WebSocket fallback
典型 provider	openai, github-copilot, cloudflare-ai-gateway 等	openai-codex

openai-codex-responses
- baseUrl 是 https://chatgpt.com/backend-api
- 要求 key 是 JWT

Awesome

tintinweb/pi-subagents
- Agent
  - schedule
- get_subagent_result
- steer_subagent
- 给正在运行的子 agent 发 steering message。

{
  subagent_type: "Explore" | "Plan" | "general-purpose" | "<custom>",
  prompt: "...",
  description: "...",
  model?: "sonnet" | "provider/model",
  thinking?: "off" | "minimal" | "low" | "medium" | "high" | "xhigh",
  max_turns?: number,
  run_in_background?: boolean,
  resume?: string,
  isolated?: boolean,
  inherit_context?: boolean,
  isolation?: "worktree",
  schedule?: string
}

Prompt

---
# 不写则取正文第一条非空行，最多 60 字符
description: Review staged git changes
argument-hint: '[focus]'
---

Review staged changes.

Focus: $ARGUMENTS

Review $1 with $ARGUMENTS
- /review 789 XYZ

<project_context>

Project-specific instructions and guidelines:

<project_instructions path="/path/to/AGENTS.md">
...文件内容...
</project_instructions>

</project_context>

<available_skills>
<skill>
<name>pi-dev-guide</name>
<description>Use when modifying...</description>
<location>/path/to/SKILL.md</location>
</skill>
</available_skills>

<skill name="foo" location="/path/to/SKILL.md">
References are relative to /path/to/skill-dir.

...SKILL.md 正文，去掉 frontmatter...
</skill>

args

Version

v0.74

repo 变更为 badlogic/pi-mono -> earendil-works/pi
npm @mariozechner/pi-coding-agent -> @earendil-works/pi-coding-agent

pi update
pi update --self

FAQ

# 修复会话 cwd
cd /new/project/path
pi --fork /path/to/old/session.jsonl

图片输入

Current model does not support images. The image will be omitted from this request.

配置模型

{
  "input": ["text", "image"]
}

Awesome

Session​

Inside​

Awesome​

Prompt​

Version

v0.74​

FAQ

图片输入​

Session

Inside

Awesome

Prompt

v0.74

图片输入