1. 使用

https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent

1.1 安装

npm install -g @mariozechner/pi-coding-agent

1.2 启动

pi

1.3 增加自定义Providers

Add providers via ~/.pi/agent/models.json

说明：https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/models.md

{
  "providers": {
    "deepseek": {
      "baseUrl": "https://api.deepseek.com",
      "api": "openai-completions",
      "apiKey": "",
      "models": [
      { "id": "deepseek-reasoner" },
        { "id": "deepseek-chat" }
      ]
    }
  }
}

1.4 对话

1.5 扩展 pi extensions

Place in ~/.pi/agent/extensions/, .pi/extensions/, or a pi package to share with others. See docs/extensions.md and examples/extensions/.

https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/extensions.md

1.6 Pi packages

2. 主要的结构

2.1 agent

npm install @mariozechner/pi-agent-core

使用

import { Agent } from "@mariozechner/pi-agent-core";
import { getModel } from "@mariozechner/pi-ai";

const agent = new Agent({
  initialState: {
    systemPrompt: "You are a helpful assistant.",
    model: getModel("anthropic", "claude-sonnet-4-20250514"),
  },
});

agent.subscribe((event) => {
  if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
    // Stream just the new text chunk
    process.stdout.write(event.assistantMessageEvent.delta);
  }
});

await agent.prompt("Hello!");