Pi Agent

Pi is a minimal terminal coding agent harness. Adapt Pi to your workflows without forking. Extend with TypeScript extensions, skills, prompt templates, and themes. Bundle as Pi packages and share via npm or git.

Key Features

• Minimal Core: Ships with read, write, edit, and bash tools — build from there
• Extensible: TypeScript extensions with access to tools, commands, keyboard shortcuts, and events
• Skills System: Install community skills or create your own
• Four Modes: Interactive TUI, print/JSON, RPC over stdin/stdout, and SDK for embedding
• Multi-provider: OpenAI, Anthropic, Google, Azure, Bedrock, Mistral, Groq, xAI, Ollama, and more
• Session Management: Resume, fork, clone, and compact conversations
• Self-extensible: Ask Pi to build its own extensions on the fly
• Package System: Bundle and share extensions as npm/git packages

Usage

# Install globally
npm install -g @earendil-works/pi-coding-agent

# Interactive mode
pi

# Single query
pi -p "Explain the architecture of this project"

# With specific model
pi --model anthropic/claude-sonnet-4

Surfaces

• Terminal TUI (primary)
• RPC mode for process integration
• SDK for embedding in apps (used by OpenClaw)