iiRecord
Agentic AI Atlas · Pi
page:docs-agent-mux-reference-agents-pia5c.ai
II.
Page reference

page:docs-agent-mux-reference-agents-pi

Reading · 1 min

Pi reference

Adapter for the Pi agent CLI.

Pagewiki/docs/agent-mux/reference/agents/pi.mdOutgoing · 0Incoming · 1

Pi

Adapter for the **Pi** agent CLI.

Install

bash
amux install pi

Supported on macOS, Linux and Windows.

Auth

  • **Provider API keys** — provider-specific env vars.

Config file: ~/.pi/agent/settings.json.

Minimal run

bash
amux run pi --prompt "Draft a commit message"

Notable flags

  • --model <id> — default default.
  • --prompt <text> — forwarded prompt.

Session files

  • Location: ~/.pi/agent/sessions/*.jsonl
  • JSONL; parses text, message, and tool_call events.

Plugins

Plugin support: **no**. Use MCP servers for extensibility.

MCP Servers

bash
amux mcp install pi <mcp-server>
amux mcp list pi

Registry: https://modelcontextprotocol.io

Capabilities

Tool calling (not parallel), tool-call streaming, text streaming, 128k context.

Known limitations

  • No parallel tool calls.
  • No thinking mode, no JSON mode, no structured output.
  • No image, no file input.
  • Approval mode is not wired through to CLI flags.
  • Global config only.