What is Pi Coding Agent?

Pi is a minimal terminal coding harness designed to adapt to your workflows rather than forcing you to adapt to it. Unlike rigid AI coding tools that dictate how you work, Pi gives you a lightweight foundation you can customize with extensions, skills, prompt templates, and themes. You can bundle these customizations as Pi packages and share them via npm or git. Pi ships with powerful defaults but deliberately skips opinionated features like sub-agents and plan mode, letting you build exactly what you need.

Who it's for

• Developers who value control – You want to shape your coding assistant to match your exact workflow, not the other way around.
• Terminal power users – You live in the command line and prefer a minimal, extensible TUI over heavy IDE integrations.
• Context engineers – You need fine-grained control over prompt context, system instructions, and how your AI agent manages information across sessions.

Key features

Four interaction modes

Pi operates in interactive, print/JSON, RPC, and SDK modes. Use the full TUI for hands-on work, pi -p "query" for scripting, --mode json for event streams, or embed Pi directly into your applications via its SDK.

Session tree navigation

Sessions are stored as trees in a single file. Use /tree to navigate to any previous point and continue from there. Filter by message type, label entries as bookmarks, export to HTML with /export, or share via GitHub gist with /share.

Extensible context management

Pi's minimal system prompt lets you do actual context engineering. Load project instructions from AGENTS.md files, replace or append system prompts per-project with SYSTEM.md, and customize compaction behavior via extensions for topic-based or code-aware summaries.

Provider flexibility

Switch between Anthropic, OpenAI, Google, Azure, Bedrock, Mistral, Groq, Cerebras, xAI, Hugging Face, and more mid-session with /model or Ctrl+L. Add custom providers and models via models.json or extensions.

What stands out

"Pi isn't a sealed product. If you need a command, tool, provider, workflow, or UI tweak, just ask Pi to build it."

This philosophy sets Pi apart from every other coding agent. Instead of waiting for features to be added by a vendor, you can ask Pi to customize itself on the fly. Have it manipulate itself in place, hit /reload, and keep going. If you think others will find what you built useful, share it as a package. Features that other agents bake in—sub-agents, plan mode, permission gates, SSH execution, sandboxing, MCP integration—you can build yourself or install from the growing ecosystem of 50+ examples.

Worth checking out if…

You're tired of coding agents that force you into their workflow and want a tool that bends to your preferences. Pi is ideal if you enjoy building your own tooling, need precise control over context windows, or want to share custom AI workflows with your team via npm or git packages. It's also worth exploring if you work across multiple AI providers and want seamless switching without leaving the terminal.