Skills › Scientific Agent Skills › pi-agent › overview.md

overview.md

39 lines · skills/pi-agent/references/overview.md at 5f2bc03

Uses an outside tool

Most marks come from matching words in the file, so treat them as pointers.

1# Pi Documentation Overview

3Source: https://pi.dev/docs/latest

5Reviewed against Pi 0.99.2 and the package versions listed in `../SKILL.md` on 2026-09-30.

7Pi is a minimal terminal coding harness. The core stays small and most workflow-specific behavior lives in TypeScript extensions, skills, prompt templates, themes, and Pi packages. Positioning on `https://pi.dev/`: "There are many agent harnesses but this one is yours" — interactive, print/JSON, RPC, and SDK interfaces, multiple providers with mid-session model switching, tree-structured shareable sessions, steering and follow-up during a run, and extensible primitives instead of baked-in features.

Pi Documentation Overview

Source: https://pi.dev/docs/latest

Reviewed against Pi 0.99.2 and the package versions listed in ../SKILL.md on 2026-09-30.

Pi is a minimal terminal coding harness. The core stays small and most workflow-specific behavior lives in TypeScript extensions, skills, prompt templates, themes, and Pi packages. Positioning on https://pi.dev/: "There are many agent harnesses but this one is yours" — interactive, print/JSON, RPC, and SDK interfaces, multiple providers with mid-session model switching, tree-structured shareable sessions, steering and follow-up during a run, and extensible primitives instead of baked-in features.

Raw lines 1 to 8

9## Top-Level Areas

11- Start here: quickstart, usage, providers, llama.cpp, security, containerization, settings, keybindings, sessions, compaction.

12- Customization: extensions, skills, prompt templates, themes, Pi packages, native MCP, codemode, custom and virtual models, custom providers.

13- Programmatic usage: SDK, RPC mode, JSON event stream mode, TUI components.

14- Reference: environment variables, session file format and SessionManager API.

15- Platform setup: Windows, Termux, tmux, terminal setup, shell aliases.

16- Development: local source setup, rebranding, debug logs, tests, package structure.

Top-Level Areas

Start here: quickstart, usage, providers, llama.cpp, security, containerization, settings, keybindings, sessions, compaction.
Customization: extensions, skills, prompt templates, themes, Pi packages, native MCP, codemode, custom and virtual models, custom providers.
Programmatic usage: SDK, RPC mode, JSON event stream mode, TUI components.
Reference: environment variables, session file format and SessionManager API.
Platform setup: Windows, Termux, tmux, terminal setup, shell aliases.
Development: local source setup, rebranding, debug logs, tests, package structure.

Raw lines 9 to 17

Uses an outside tool MCP :12

18## Quick Install

20```bash

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

22pi

23```

25On Linux/macOS the installer is also available:

27```bash

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

29```

31pnpm and bun global installs work too (`pnpm add -g --ignore-scripts ...`, `bun add -g --ignore-scripts ...`).

33Authenticate with `/login` for subscription providers or set API keys such as `ANTHROPIC_API_KEY` before startup.

Quick Install

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

On Linux/macOS the installer is also available:

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

pnpm and bun global installs work too (pnpm add -g --ignore-scripts ..., bun add -g --ignore-scripts ...).

Authenticate with /login for subscription providers or set API keys such as ANTHROPIC_API_KEY before startup.

Raw lines 18 to 34

35## Ecosystem

37Package gallery at `https://pi.dev/packages` lists community extensions tagged `pi-package`. Source: `https://github.com/earendil-works/pi` (formerly `pi-mono`; docs live under `packages/coding-agent/docs/`, and doc pages still link the old repo name, which redirects).

39Pi requires Node.js >= 22.19.0. The published version this skill was written against is `0.99.2` (`https://pi.dev/api/latest-version` reports the current one).

Ecosystem

Package gallery at https://pi.dev/packages lists community extensions tagged pi-package. Source: https://github.com/earendil-works/pi (formerly pi-mono; docs live under packages/coding-agent/docs/, and doc pages still link the old repo name, which redirects).

Pi requires Node.js >= 22.19.0. The published version this skill was written against is 0.99.2 (https://pi.dev/api/latest-version reports the current one).

Raw lines 35 to 39