@meetopenbot/pi

OpenBot agent plugin powered by the Pi coding agent SDK.

Pi provides a full agent runtime with built-in tools (read, bash, edit, write, grep, find, ls), session management, and model/provider support. This plugin wraps Pi as an OpenBot agent runtime — each agent:invoke runs a Pi turn and streams progress back via agent:output.

Installation

npm install @meetopenbot/pi

Add the plugin to your agent in AGENT.md:

plugins:
  - id: '@meetopenbot/pi'
    config:
      provider: anthropic
      model: claude-opus-4-5
      thinkingLevel: medium
      tools: read,bash,edit,write,grep,find,ls

Configuration

Option	Description
cwd	Working directory for Pi tools and resource discovery. Defaults to the OpenBot channel cwd, then process.cwd().
agentDir	Pi config directory (credentials, settings, sessions). Default: ~/.pi/agent.
provider	Model provider (e.g. anthropic, openai).
model	Model id (e.g. claude-opus-4-5).
thinkingLevel	Extended thinking: off, minimal, low, medium, high, xhigh.
tools	Comma-separated built-in tools to enable.
excludeTools	Comma-separated tool names to disable.
noTools	all or builtin to disable tools.
systemPrompt	Override Pi's system prompt for this agent.

API Keys

Pi resolves credentials via AuthStorage (see Pi SDK docs):

1. Runtime overrides
2. ~/.pi/agent/auth.json
3. Environment variables (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.)

Sessions

Each OpenBot thread gets its own Pi session. The session file path is stored in thread state so conversations continue across turns.

License

MIT