Pi Agent tutorial

Official steps: Quickstart.

Install

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

Linux / macOS also:

curl -fsSL https://pi.dev/install.sh | sh

2026-05-07: primary package is @earendil-works/pi-coding-agent. Do not install @mariozechner/pi-coding-agent.

First prompt

pi

Print mode: pi -p "query". Event stream: --mode json. Model switch: /model or Ctrl+L.

Project files from pi.dev: AGENTS.md (loaded from ~/.pi/agent/, parents, cwd) and SYSTEM.md. Packages: pi install npm:@foo/pi-tools.

Defaults (pi.dev + README): no built-in sub-agents, plan mode, MCP, or permission system.

Next

Cheatsheet · Glossary · OpenClaw