pi

# 安装
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

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": {}
    }
  }
}

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

# 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

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

{
  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
}

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

Review staged changes.

Focus: $ARGUMENTS

<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

pi update
pi update --self

# 修复会话 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"]
}