@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