Pi Agent setup.

00Install Pi

The macOS / Linux install command from the Pi website. Once installed, run pi and use /login to connect a model provider.

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

01Basic

Everyday essentials: web access, side questions, a tidier transcript, and persistent goals.

• pi-web-access

  Web search, page fetching, PDF extraction, and video analysis for Pi.

  npm page ↗Repository ↗

• pi-btw

  Ask a side question with /btw without adding it to the main conversation context.

  npm page ↗Repository ↗

• pi-tidy

  Fold tool calls into a cleaner transcript while keeping failures, edit diffs, and running jobs visible.

  npm page ↗Repository ↗

• pi-goal-x

  Plan goals with /goal, persist progress, and check completion with an independent auditor.

  npm page ↗Repository ↗

pi install npm:pi-web-access && pi install npm:@narumitw/pi-btw && pi install npm:pi-tidy && pi install npm:pi-goal-x

02Optional

Optional delegation and observability tools. I use subagents only when explicitly authorized.

• pi-subagents

  Delegate explicitly authorized tasks to focused child agents, with parallel reviews, background jobs, and reusable workflows.

  npm page ↗Repository ↗

• pi-stamp

  Add transcript timestamps, with optional assistant metadata, response timing, and tool timing.

  npm page ↗Repository ↗

pi install npm:pi-subagents && pi install npm:@narumitw/pi-stamp

03Codex related

Account, compaction, and usage tools I use in my Codex workflow. Some also support other providers.

• pi-accounts

  Manage and switch named OAuth accounts, including OpenAI Codex, with /accounts.

  npm page ↗Repository ↗

• pi-codex-compact

  Use Responses compaction protocols with compatible providers, with a Pi-native fallback when needed.

  npm page ↗Repository ↗

• pi-usage

  Check provider usage, limits, reset times, and API balances with /usage.

  npm page ↗Repository ↗

pi install npm:@narumitw/pi-accounts && pi install npm:@narumitw/pi-codex-compact && pi install npm:@narumitw/pi-usage