II.
Page reference
Reading · 1 minpage:docs-agent-mux-reference-agents-pi
Pi reference
Adapter for the Pi agent CLI.
Pi
Adapter for the **Pi** agent CLI.
Install
amux install piSupported on macOS, Linux and Windows.
Auth
- **Provider API keys** — provider-specific env vars.
Config file: ~/.pi/agent/settings.json.
Minimal run
amux run pi --prompt "Draft a commit message"Notable flags
--model <id>— defaultdefault.--prompt <text>— forwarded prompt.
Session files
- Location:
~/.pi/agent/sessions/*.jsonl - JSONL; parses
text,message, andtool_callevents.
Plugins
Plugin support: **no**. Use MCP servers for extensibility.
MCP Servers
amux mcp install pi <mcp-server>
amux mcp list piRegistry: 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.