$ cat ~/map/pi-coding-agent-npm.md

@earendil-works/pi-coding-agent

The official npm package — install the Pi coding agent CLI with one command.

officialtools✓ Oct 16

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

## TL;DR

The official npm package for pi — one documented global install provides the pi binary, a coding agent CLI with read, bash, edit, and write tools plus session management.

## Key points

• $Official scoped package maintained under @earendil-works; it provides the pi binary (bin: pi), and its npm description is a coding agent CLI with read, bash, edit, write tools and session management. The source lives in the coding-agent package of the earendil-works/pi monorepo.
• $The documented install is npm install -g --ignore-scripts @earendil-works/pi-coding-agent — --ignore-scripts disables dependency lifecycle scripts during install, and pi does not require install scripts for normal npm installs.
• $Installer alternative for Linux/macOS: curl -fsSL https://pi.dev/install.sh | sh; removal is npm uninstall -g @earendil-works/pi-coding-agent, with matching global remove commands for pnpm, Yarn, or Bun.
• $The package requires Node.js >=22.19.0 (engines field). Launch with pi in a project directory, then authenticate via /login for subscription providers or set an API key such as ANTHROPIC_API_KEY beforehand.
• $By default pi gives the model four tools — read, write, edit, and bash — and it runs in four modes: interactive TUI, print/JSON, RPC for process integration, and an SDK for embedding. Full documentation lives at pi.dev.

## FAQ

## References

• npm package ↗
• GitHub repository ↗
• Official docs ↗

Last updated: Aug 31, 2026