pi

There are many shitty coding agents, but this one is mine.

$ npm install -g @mariozechner/pi-coding-agent

Features

Minimal. Opinionated. Extensible.

Lean core keeps your context clean. Use only what you need.

4 toolsread, write, edit, bash
Multi-providerAnthropic, OpenAI, Google, Mistral, Groq, xAI, OpenRouter, Ollama, or add your own
/modelswitch models mid-conversation
Sessionscontinue, resume, branch
Compactionauto-summarize long conversations
Bash modeprefix with ! to run commands
Imagespaste or drag into context

The rest is in the docs.

Philosophy

pi is opinionated about what it won't do. These are intentional design decisions to minimize context bloat and avoid anti-patterns.

No MCP. Build CLI tools with READMEs (see Skills). The agent reads them on demand. Would you like to know more? If you must, use mcporter.

No sub-agents. Spawn pi instances via tmux. Observability and steerability for you and the agent.

No permission popups. Security theater. Run in a container or build your own with Hooks.

No plan mode. Gather context in one session, write plans to file, start fresh for implementation.

No built-in to-dos. They confuse models. Use a TODO.md file.

No background bash. Use tmux. Full observability, direct interaction.

Read the blog post for the full rationale.