🔧
/|\
/ | \
/ | \
/___🤖__\
Power tools for pi. Clone repos and tear them apart. Type-check with the TypeScript 7 native compiler. Farm work out to Codex in background loops. Lease secrets safely. Bridge any MCP server with OAuth. Quit when you want to quit.
# install dependencies
curl -sL https://raw.githubusercontent.com/joelhooks/pi-tools/main/setup.sh | bash
# install extensions
pi install git:github.com/joelhooks/pi-tools
pi config # enable/disable individual extensions| Extension | What |
|---|---|
repo-autopsy 🔬 |
Clone GitHub repos and analyze them — ripgrep, ast-grep, deps, hotspots, blame, tokei stats |
ts-check ⚡ |
TypeScript diagnostics + intelligence via tsgo LSP (TypeScript 7 native) — hover, definitions, references, auto-diagnostics after edits |
codex-exec 🚀 |
Run codex tasks in the background with async result reporting |
ralph-loop 🔁 |
Autonomous coding loops via Codex — PRD-driven stories or free-form prompt loops with progress reporting |
agent-secrets 🛡️ |
Lease secrets with TTLs via agent-secrets — status, revoke, audit, env generation |
mcp-bridge 🌉 |
Connect to any remote MCP server with OAuth — auto-registers tools into pi |
session-reader 📖 |
Discover and parse sessions from pi, Claude Code, and Codex |
skill-shortcut ⚡ |
$skill-name autocomplete shortcut for /skill:skill-name |
aliases 🚪 |
/quit and /q → /exit |
Two modes:
PRD mode — reads prd.json in the working directory, picks stories by priority, spawns codex to implement each one. Marks stories as done when they pass. Reports each iteration back to pi.
Use ralph_loop in prd mode to implement the stories in this project
Prompt mode — runs a prompt repeatedly up to N iterations. Each iteration is a fresh codex session.
Use ralph_loop in prompt mode with "Run the tests and fix any failures" for 5 iterations
Progress appears as messages in your pi session. Use ralph_jobs to check status or cancel.
Connect to any remote MCP server that supports OAuth. Tools are auto-discovered and registered into pi, prefixed by server name.
# Add a server
/mcp-add notion https://mcp.notion.com/mcp
/mcp-add linear https://mcp.linear.app/mcp
# Authenticate (opens browser)
/mcp-login notion
# Check status
/mcp-list
# Reconnect after restart (auto on session start)
/mcp-reconnect
# Remove
/mcp-remove notionCommands: /mcp-add, /mcp-remove, /mcp-login, /mcp-logout, /mcp-list, /mcp-reconnect
Tool: mcp_status
State stored in ~/.pi/mcp-bridge/ (OAuth client registrations, tokens, PKCE verifiers). Tools from each server are registered as <name>_<tool> (e.g., notion_search, notion_update_block).
On session start, auto-connects to all servers with saved tokens. If tokens are expired, shows a status warning — run /mcp-login <name> to re-auth.
Requires @modelcontextprotocol/sdk (installed by setup.sh).
Lease credentials safely with TTLs. No env files committed, no plaintext on disk.
Use secrets_lease to get the slack_bot_token with a 30 minute TTL
Tools: secrets_lease, secrets_status, secrets_revoke, secrets_audit, secrets_env
Requires agent-secrets daemon running.
MIT