macOS
Homebrewverified · 100%
brew install pi-coding-agentlocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install pi-coding-agentMacPorts ports tree · llm/pi-coding-agent/Portfile · source: api.github.com
brew / rank 698
Install pi-coding-agent with Homebrew, dnf, MacPorts, Nix, zypper, scoop, apt, winget
AI agent toolkit. Version 1.4.0 via Homebrew; verified 2026-11-03. Also installable with nix: nix profile install nixpkgs#pi-coding-agent.
install
Additional install commands
Linux
Fedora dnfverified · 92%
sudo dnf install pi-coding-agentFedora Rawhide package metadata · pi-coding-agent · source: dl.fedoraproject.org
Nixverified · 92%
nix profile install nixpkgs#pi-coding-agentnixpkgs package indexes · pkgs/by-name/pi/pi-coding-agent/package.nix · source: api.github.com
openSUSE zypperverified · 92%
sudo zypper install pi-coding-agentopenSUSE Tumbleweed package metadata · pi-coding-agent · source: download.opensuse.org
Debian aptverified · 92%
sudo apt install piDebian stable package indexes · pi · source: deb.debian.org
Windows
Scoopverified · 92%
scoop install main/pi-coding-agentScoop official bucket manifest trees · bucket/pi-coding-agent.json · source: api.github.com
Windows Package Managerverified · 92%
winget install --id EarendilWorks.pi -eWindows Package Manager source index · EarendilWorks.pi · source: cdn.winget.microsoft.com
overview
Package summary
AI agent toolkit
Project links
Commands and aliases
- pi
history
Project history and usage
Pi is an extensible terminal AI agent and TypeScript toolkit for inspecting files, editing projects, running commands, automating sessions, and embedding agent behavior in other applications.
Project history
Pi began as an open-source agent-harness monorepo containing a unified LLM API, agent runtime, terminal UI components, and an interactive coding-agent CLI. The project later moved into the Earendil Works organization and its canonical repository became earendil-works/pi.
The official documentation describes Pi as a minimal terminal agent designed to be adapted through extensions, skills, prompt templates, themes, packages, custom providers, and MCP servers. Its CLI and SDK share the same underlying agent facilities.
Adoption history
Pi is distributed as the @earendil-works/pi-coding-agent npm package and through a first-party installer. The supplied package facts also record distribution in Homebrew, Nix, MacPorts, Scoop, Winget, and several Linux package ecosystems, reflecting rapid packaging of the terminal-agent category.
How it is used
Users start pi inside a working directory and interactively ask it to inspect files, edit content, and run commands. It also supports one-shot print mode, JSON event streams, RPC control, resumable sessions, project instructions, model-provider selection, and SDK-based embedding.
User settings and model overrides live under the agent directory, which defaults to ~/.pi/agent. Trusted projects can add .pi/settings.json and project-local extensions, skills, prompts, themes, and MCP configuration.
Why package nerds care
Pi represents the minimal, extensible branch of coding-agent design. Package enthusiasts care about its small core, multi-provider model layer, project-local resources, TypeScript extension API, reusable skills and prompt templates, structured event modes, and ability to serve as an embeddable SDK rather than only an interactive CLI.
Timeline
- 2025: Pi's public repository lineage began as the pi-mono agent toolkit.
- 2026: The project moved to Earendil Works and adopted github.com/earendil-works/pi as its canonical repository.
- 2026: The official site announced Pi 1.0.
Related projects
- The official monorepo includes Pi's coding-agent CLI, agent runtime, unified model API, terminal UI, and SDK packages. Pi packages bundle extensions, skills, prompts, and themes for reuse.
Sources
security posture
No protected-tool coverage found yet
No matching local secret-handling manifest was found for pi-coding-agent. Package metadata is still published here so future coverage has a stable package URL.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 5 platform targets.
- Installs with 1 runtime dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
~/.pi/agent/settings.json./.pi/settings.json~/.pi/agent/models.json
Credential files
Credential-bearing paths to review before unattended agent runs.
- Unix
~/.pi/agent/auth.json
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
pi | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-11-04
manager version1.4.0
manager updated2026-11-03
local dataok
upstreamnot checked
latest detectednot detected
- infoRelease/tag comparison is only available for GitHub repositories.https://pi.dev/none confidence
install metadata
Package metadata
| Package key | brew:pi-coding-agent |
|---|---|
| Version | 1.4.0 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/pi-coding-agent |
| Homepage | https://pi.dev/ |
| Upstream docs | https://pi.dev/ |
| License | MIT |
| Source archive | https://registry.npmjs.org/@earendil-works/pi-coding-agent/-/pi-coding-agent-1.5.0.tgz |
| Last updated | 2026-11-03T11:57:07Z |
| Pulse | updated |
| Dependencies | node |
| Bottle | available (on arm64_golden_gate, arm64_linux, arm64_sequoia, arm64_tahoe, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | pi-coding-agent |
| Version Scheme | 0 |
| Revision | 0 |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
pi-coding-agent
nix profile install nixpkgs#pi-coding-agent- normalized package name match
- Matched by: Pi Coding Agent
dnf95%
pi-coding-agent 0.84.2-1.fc46
An open source coding agent
https://github.com/earendil-works/pi
sudo dnf install pi-coding-agent- License: MIT AND Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND ISC AND BlueOak-1.0.0 AND 0BSD AND CC-BY-SA-4.0 AND CC0-1.0
- Category: Unspecified
- Architecture: noarch
- Source Package: pi-coding-agent
- 2 dependencies
- 1 provides
- normalized package name match
- Matched by: Pi Coding Agent
zypper95%
pi-coding-agent 0.84.3-1.1
Minimal terminal coding agent
https://github.com/earendil-works/pi
sudo zypper install pi-coding-agent- License: 0BSD AND Apache-2.0 AND BSD-3-Clause AND BlueOak-1.0.0 AND ISC AND MIT
- Category: Unspecified
- Architecture: noarch
- Source Package: pi-coding-agent
- 2 dependencies
- 2 provides
- normalized package name match
- Matched by: Pi Coding Agent
zypper95%
pi-coding-agent-examples 0.84.3-1.1
Example extensions for pi-coding-agent
https://github.com/earendil-works/pi
sudo zypper install pi-coding-agent-examples- License: 0BSD AND Apache-2.0 AND BSD-3-Clause AND BlueOak-1.0.0 AND ISC AND MIT
- Category: Unspecified
- Architecture: noarch
- Source Package: pi-coding-agent
- 1 dependencies
- 1 provides
- normalized package name match
- Matched by: Pi Coding Agent
MacPorts95%
pi-coding-agent
sudo port install pi-coding-agent- normalized package name match
- Matched by: Pi Coding Agent
Scoop95%
main/pi-coding-agent
scoop install main/pi-coding-agent- normalized package name match
- Matched by: Pi Coding Agent
Debian apt92%
pi 1.3.7-1+b1
Compute Archimedes' constant Pi to arbitrary precision
sudo apt install pi- Section: math
- Architecture: amd64
- Source Package: cln
- 4 dependencies
- installed executable or alias match
- Matched by: Pi
Ubuntu apt92%
pi 1.3.7-1
Compute Archimedes' constant Pi to arbitrary precision
sudo apt install pi- Section: universe/math
- Architecture: amd64
- Source Package: cln
- 4 dependencies
- installed executable or alias match
- Matched by: Pi
zypper92%
cln 1.3.7-1.9
Class Library for Numbers (C++)
sudo zypper install cln- License: GPL-2.0-or-later
- Category: Productivity/Scientific/Math
- Architecture: x86_64
- Source Package: cln
- 7 dependencies
- 4 provides
- installed executable or alias match
- Matched by: Pi
zypper92%
kernel-firmware-brcm 20260610-1.2
Kernel firmware files for Broadcom wireless drivers
https://git.kernel.org/cgit/linux/kernel/git/firmware/linux-firmware.git/
sudo zypper install kernel-firmware-brcm- License: GPL-2.0-or-later AND SUSE-Firmware AND GPL-2.0-only
- Category: System/Kernel
- Architecture: noarch
- Source Package: kernel-firmware-brcm
- 4 dependencies
- 32 provides
- installed executable or alias match
- Matched by: Pi
winget92%
EarendilWorks.pi
winget install --id EarendilWorks.pi -e- installed executable or alias match
- Matched by: Pi
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- package relationship graph
- package version freshness
- package-page enrichment
- pkg.so package database
- pkgdb category and tag curation