Pi is a minimal, highly hackable terminal coding agent harness. It ships with only 4 base tools (read, write, edit, bash) and zero bloat, but allows full customization via TypeScript Extensions, Skills, and Pi Packages.

How do I install and run Pi?

Run `npm install -g --ignore-scripts @earendil-works/pi-coding-agent` or `curl -fsSL https://pi.dev/install.sh | sh`. Set your API key (ANTHROPIC_API_KEY, DEEPSEEK_API_KEY, OPENAI_API_KEY) or run `pi` and `/login` to authenticate via subscription.

How does Pi differ from Claude Code, Cursor, and Aider?

Claude Code and Cursor are proprietary closed products; Aider is git-diff focused but less extensible. Pi is fully open-source and modular: UI, LLM provider (pi-ai), runtime (pi-agent-core), and CLI are decoupled, and it natively supports embedding via TypeScript SDK or JSON-RPC.

What are Pi Extensions and Skills?

Skills are procedural knowledge written in SKILL.md format; Extensions are full TypeScript modules that can hook into lifecycle events, register custom tools, add hotkeys, or customize prompt assembly.

Can Pi run headlessly in CI or scripts?

Yes. Pi supports 4 modes: Interactive (TUI), Print/JSON (`pi -p 'task'`), JSON-RPC over stdin/stdout, and the programmatic TypeScript SDK.

Pi Coding AgentActive open source · StableMIT

A minimal, hackable terminal coding harness

Built by Mario Zechner. Pi ships with only 4 base tools (read, write, edit, bash) and zero forced abstractions, but lets you extend it into any workflow via TypeScript extensions, skills, and packages.

Updated 2026-08-15. Laojin Global's own development environment runs directly on Pi.

90.6k

GitHub stars (snapshot)

11.2k

Forks (snapshot)

Active open source · Stable

Status

MIT

License

Open GitHub Repo Visit pi.dev Start with Quickstart

Founders

Objective and subjective source records we curated.

Creator

Mario Zechner

Creator of Pi Coding Agent, libGDX, RoboVM

Created Pi Coding Agent harness and libGDX cross-platform framework

Profile X

How to Get Started with Pi Coding Agent

3 steps to launch a clean, hackable AI coding agent in your terminal.

Install the CLI Globally

Install via npm, passing `--ignore-scripts` for security and clean install.

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Configure API Key or /login

Export your provider API key (e.g. ANTHROPIC_API_KEY) or start `pi` and run `/login` to authenticate.

export ANTHROPIC_API_KEY=sk-ant-...

Launch and Run Tasks

Run `pi` in your repo to enter the TUI. The model has read, write, edit, and bash tools ready out of the box.

pi

Pitfalls & Caveats

Practical boundaries and safety tips from real production usage.

⚠️

No Default Sub-agents or Plan Mode

Pi's philosophy is extreme minimalism. If you expect built-in multi-agent swarms or forced plan modes, you compose them yourself via Extensions or Skills.

⚠️

Always install with --ignore-scripts

The official guide recommends `--ignore-scripts` to bypass dependency lifecycle scripts during global install, ensuring cleaner security and stability.

⚠️

Bash Execution & Permission Scope

Pi gives the model direct terminal execution via the bash tool. In production or shared environments, pair it with containerization or scoped environment variables.

4 Operating Modes for Any Integration

Pi is more than a CLI. From interactive TUI to CI pipelines, JSON-RPC daemons, and programmatic SDK imports.

01
Interactive TUI
Full terminal TUI: syntax highlighting, hotkey queue, session branching, and auto compaction.
02
Print & JSON CLI
Headless one-shot CLI mode (`pi -p 'task'`), built for CI/CD automation and shell pipelines.
03
JSON-RPC Protocol
Exposes JSON-RPC over stdin/stdout for seamless integration into web (pi-web) or desktop GUIs.
04
TypeScript SDK
Import Pi Agent directly as a TypeScript library in Node.js (e.g. openclaw) for programmatic control.

Tutorials

All tutorials

Beginner · 2026-08-15

Pi Coding Agent Quickstart: 4 Base Tools & Minimal Terminal Workflow

Break free from commercial black boxes. Master the 4 base tools (read, write, edit, bash) for a clean, transparent terminal workflow.

Intermediate · 2026-08-15

Pi Agent Extensions & Skills: Build Your First TypeScript Tool & Workflow

Deep dive into Pi's extension ecosystem: build custom tools with TypeScript, listen to event hooks, and package workflows as Skills.

Intermediate · 2026-08-15

Pi Agent vs Claude Code vs Aider: Architecture & Selection Guide

Commercial black box vs open hackability. Comparing tool architecture, SDK embeddability, session trees, and extension cost across three coding agents.

Beside Claude Code & Aider

Based on official public documentation and licenses for technical orientation. Pi Agent is suited for teams who want complete control over agent behavior, custom extensions, or embedding into their own platforms.

Tool	License	Core Philosophy	Extensibility	Embedding (SDK/RPC)
Pi Agent (pi-coding-agent)	MIT	Minimal 4-tool chassis, zero forced abstractions	TypeScript Extensions + Skills + Packages	Native TypeScript SDK & stdin/stdout JSON-RPC
Claude Code	Proprietary / Closed	Official turnkey terminal agent by Anthropic	Supports Skills / hooks / MCP; core loop is closed	CLI only; no standalone SDK for embedding
Aider	Apache-2.0	Focused on git diff commits and pair programming	Custom prompts & repo map, no general plugin system	Python library support, primarily for CLI workflows

Official Directory

Official

Official site (pi.dev)
Official website for Pi and one-line install script.
GitHub repository
Official source, documentation, extension examples, and issues. MIT licensed.
npm package
CLI release and SDK on npm.

Docs & Manuals

Official Documentation
Extensions, skills, RPC protocol, SDK embedding, session compaction, and hotkey reference.
Extensions Guide
Write custom tools, event hooks, keybindings and prompts in TypeScript.
SDK Guide
Embed Pi Agent into your Node.js apps, web services, or desktop tools.
RPC Protocol Guide
Control Pi sessions over stdin/stdout JSON-RPC (the core of pi-web UI).

Community & Datasets

Discord Community
Official Discord community with creator Mario Zechner and developers.
Hugging Face Public Sessions
Real-world coding agent session datasets shared by Mario Zechner.

Ecosystem & Cases

OpenClaw (Real SDK Case)
A real-world open-source multi-platform terminal project embedding Pi Agent SDK.

Pi Agent · Directory card

Latest Updates

2026-08-14 · npm & GitHub · Official
Pi Coding Agent iterates rapidly, boosting streaming & extension package ecosystem
npm package @earendil-works/pi-coding-agent updates to v0.84+, polishing session branching, automatic compaction, and cross-platform TUI.
2026-06-20 · X (@badlogicgames) · Official
Mario Zechner launches open-source coding agent session sharing initiative
Publishing real-world open-source coding agent sessions to Hugging Face via pi-share-hf to advance open model post-training and evals.

What Pi Coding Agent Is: Mario Zechner's Minimal Open-Source Coding Agent

LaoJin's Pick

90.6k ★ · 2026-08

Pi Coding Agent

Mario Zechner's minimal terminal coding harness: 4 base tools, zero forced abstractions, fully hackable via TypeScript extensions, skills and SDK. Laojin Global's own dev stack runs on it.

FAQ

What is Pi Agent?: Pi is a minimal, highly hackable terminal coding agent harness. It ships with only 4 base tools (read, write, edit, bash) and zero bloat, but allows full customization via TypeScript Extensions, Skills, and Pi Packages.
How do I install and run Pi?: Run `npm install -g --ignore-scripts @earendil-works/pi-coding-agent` or `curl -fsSL https://pi.dev/install.sh | sh`. Set your API key (ANTHROPIC_API_KEY, DEEPSEEK_API_KEY, OPENAI_API_KEY) or run `pi` and `/login` to authenticate via subscription.
How does Pi differ from Claude Code, Cursor, and Aider?: Claude Code and Cursor are proprietary closed products; Aider is git-diff focused but less extensible. Pi is fully open-source and modular: UI, LLM provider (pi-ai), runtime (pi-agent-core), and CLI are decoupled, and it natively supports embedding via TypeScript SDK or JSON-RPC.
What are Pi Extensions and Skills?: Skills are procedural knowledge written in SKILL.md format; Extensions are full TypeScript modules that can hook into lifecycle events, register custom tools, add hotkeys, or customize prompt assembly.
Can Pi run headlessly in CI or scripts?: Yes. Pi supports 4 modes: Interactive (TUI), Print/JSON (`pi -p 'task'`), JSON-RPC over stdin/stdout, and the programmatic TypeScript SDK.

For Enterprise & Dev Teams

Need to deploy a team-level Agent system?

Open-source frameworks are free, but turning a runtime into an enterprise asset requires access control, RBAC sandboxes, and private RAG integrations. Laojin Global provides commercial-grade architecture and deployment support.

Schedule a Tech Call View Solutions

Cite This Hub

We encourage you to capture this hub into your knowledge base, research, or feed it straight to an AI agent under CC BY 4.0.

Raw Markdown Endpoint (For AI Agents)

Text Citation (For Articles/Reports)

Laojin Global. "Pi Agent (pi-coding-agent) Hub". Last updated 2026-08-15. Available at: https://www.laojinchuhai.com/en/pi-agent

How this hub stays current

Version updates and official links are maintained in src/content/pi-agent.ts. Tutorials, directory cards and picks attach via slug arrays.