$ npm install -g @earendil-works/pi-coding-agent
$ pi
✓ Pi v1.0.0 ready
▸ How can I help you today? █

Overview

A minimal terminal coding agent. Small at the core, infinitely extensible.

Start here

Quickstart

Install, authenticate, and run your first session in minutes. → Quickstart

Using Pi

Interactive mode, slash commands, context files, and the full CLI reference. → Using Pi

Providers

Subscription and API-key setup for Anthropic, OpenAI, and more. → Providers

Security

Project trust, sandbox boundaries, and vulnerability reporting. → Security

Settings

Global and per-project settings reference. → Settings

Sessions

Session management, branching, and tree navigation. → Sessions

Extensions TypeScript modules for tools, commands, events, and custom UI.

Skills Agent Skills for reusable on-demand capabilities.

Prompt Templates Reusable prompts that expand from slash commands.

Themes Built-in and custom terminal themes.

Pi Packages Bundle and share extensions, skills, prompts, and themes.

Custom Models Add model entries for Ollama, vLLM, LM Studio, and proxies.

Custom Providers Implement custom APIs and OAuth flows.

SDK Embed Pi in Node.js applications.

RPC Mode Integrate over stdin/stdout JSONL.

JSON Event Stream Print mode with structured events.

TUI Components Build custom terminal UI for extensions.

Windows Set up Pi on Windows with WSL or Git Bash.

Termux on Android Run Pi on Android via Termux.

tmux Configure tmux modifier key pass-through.

Terminal Setup Kitty keyboard protocol and font configuration.