awesome-pi-agent
Concise, curated resources for extending and integrating the pi coding agent
(Yes, it was tempting to call it shitty-list).
Primary project
Extensions
Extensions are TypeScript/JavaScript modules that enhance pi-agent functionality by handling events, registering tools, or adding UI components. Previously called "hooks" or "custom tools".
- agent-stuff (mitsupi) — Skills and extensions for pi (answer, review, loop, files, todos, codex-tuning, whimsical)
- cloud-research-agent — AI agent in cloud sandbox for researching GitHub repositories and libraries
- michalvavra/agents — User extensions and configuration examples
- filter-output — Redact sensitive data (API keys, tokens, passwords) from tool results before LLM sees them
- security — Block dangerous bash commands and protect sensitive paths from writes
- pi-extensions — Collection of debugging and utility extensions
- debug — Session path clipboard utility and debugging tools
- meta — Meta operations for pi agent
- processes — Process management utilities
- pi-agent-scip — SCIP code intelligence tools for pi agent
- pi-extensions — Collection of extensions for pi coding agent
- toolwatch — Tool call auditing and approval system with SQLite logging
- pi-hooks — Minimal reference extensions
- checkpoint — Git-based checkpoint system for restoring code state when branching conversations
- lsp — Language Server Protocol integration with auto-diagnostics and on-demand queries
- permission — Layered permission control with four levels (off, low, medium, high)
- pi-canvas — Interactive TUI canvases (calendar, document, flights) rendered inline using native pi TUI
- pi-cost-dashboard — Interactive web dashboard to monitor and analyze API costs
- pi-extensions — Collection of delightful extensions for pi agent
- pi-interview-tool — Web-based form tool with keyboard navigation, themes, and image attachments
- pi-notification-extension — Telegram/bell alerts when the agent finishes and waits for input
- pi-notify-pp — Rich notification extension with tool stats, error tracking, and OSC 777 support
- pi-powerline-footer — Powerline-style status bar with git integration, context awareness, and token intelligence
- pi-prompt-template-model — Prompt templates with model/skill/thinking frontmatter and auto-restore
- pi-rewind-hook — Rewind file changes with git-based checkpoints and conversation branching
- pi-ssh-remote — Extension that redirects all file operations and commands to a remote host via SSH
- pi-extensions — Collection of extensions for pi coding agent
- files — Browse and open files mentioned in conversation
- skill-task — Route
/skill: commands to task tool when skills opt in
- task-tool — Run isolated pi subprocesses for single, chain, or parallel work
- rhubarb-pi — Collection of small extensions for pi agent
- background-notify — Notifications when tasks complete (audio beep, terminal focus)
- session-emoji — AI-powered emoji in footer representing conversation context
- session-color — Colored band in footer to visually distinguish sessions
- safe-git — Require approval before dangerous git operations
- ben-vargas/pi-packages — Packages for pi (extensions, skills, prompt templates, themes)
- ferologics/pi-notify — Native desktop notifications via OSC 777
- ogulcancelik/pi-ghostty-theme-sync — Sync Ghostty terminal theme with pi session
- ogulcancelik/pi-sketch — Quick sketch pad - draw in browser, send to models
- pi-dcp — Dynamic context pruning extension for intelligent conversation optimization
- pi-gui — GUI extension providing visual interface for pi agent
- pi-screenshots-picker — Screenshot picker extension for better screenshot selections
- pi-super-curl — Extension to empower curl requests with coding agent capabilities
- shitty-extensions — Community extensions collection
- cost-tracker — Session spending analysis from pi logs
- handoff — Transfer context to new focused sessions
- memory-mode — Save instructions to AGENTS.md with AI-assisted integration
- oracle — Get second opinion from alternative AI models without switching contexts
- plan-mode — Read-only exploration mode for safe code exploration
- status-widget — Persistent provider status indicator in footer
- ultrathink — Rainbow animated effect with Knight Rider shimmer
- usage-bar — AI provider usage statistics with status polling
Skills
Skills are reusable workflows described in natural language (SKILL.md format) that guide the agent through complex tasks.
- agent-stuff (mitsupi) — Skills and extensions for pi (commit, changelog, GitHub, web browser, tmux, Sentry, and more)
- pi-amplike — Pi skills for web search and webpage extraction (Jina APIs)
- pi-skills — Community skills collection
- brave-search — Web search and content extraction via Brave Search API
- browser-tools — Interactive browser automation via Chrome DevTools Protocol
- gccli — Google Calendar CLI for events and availability
- gdcli — Google Drive CLI for file management and sharing
- gmcli — Gmail CLI for email, drafts, and labels
- transcribe — Speech-to-text transcription via Groq Whisper API
- vscode — VS Code integration for diffs and file comparison
- youtube-transcript — Fetch YouTube video transcripts
- agent-desktop — Desktop application for pi agent with native UI
- CodexBar — macOS menu bar app for tracking AI coding tool usage (session + weekly limits, reset timers) — supports Codex, Claude, Cursor, Gemini, and more
- claude-code-ui — Real-time dashboard for monitoring Claude Code sessions with AI-powered summaries, PR tracking, and multi-repo support
- codemap — Compact, token-aware codebase maps for LLMs and coding agents (TypeScript/JavaScript symbol extraction, markdown structure)
- gondolin — Linux micro-VM sandbox with programmable network/filesystem and Pi integration
- gob — Process manager for AI agents with background job support and TUI interface
- lima — Linux micro-VM environment for isolated agent execution
- losingle/pi-mono — Fork of pi-mono with custom modifications and enhancements
- nono — Secure, kernel-enforced capability sandbox for AI agents (Landlock on Linux, Seatbelt on macOS) — blocks dangerous commands and enforces OS-level security primitives
- opencode-dynamic-context-pruning — Context optimization system for extended conversations
- PiSwarm — Parallel GitHub issue and PR processing using the
pi agent and Git worktrees
- task-factory — Queue-first work orchestrator for Pi with planning, execution skills, and web UI
- pi-ds — TUI design system components for pi-mono extensions with TypeScript support
- pi-mobile — Android client for Pi coding agent with session management over Tailscale
- pi-stuffed — Collection of pi extensions including Reddit integration and more
- pi-sub — Monorepo for usage tracking extensions with shared core (sub-core, sub-bar UI widget)
Prompt Templates
Prompt templates (formerly "slash commands") let you create reusable prompt shortcuts with parameters.
No community prompt templates yet — contributions welcome!
Themes
- pi-rose-pine — Rose Pine themes for pi coding agent (main, moon, dawn variants)
Providers & Integrations
- pi-acp — ACP adapter for pi agent
- pi-config — Project config example
- pi-synthetic — Pi provider for Synthetic (open-source models via Anthropic-compatible API)
Examples & Recipes
Official Documentation
Deep links into the official pi-mono repository:
- Extensions guide — Unified extensions API (hooks, tools, events, UI)
- Package README — High-level package README and quick start
- Docs directory — Full documentation (CLI, SDK, RPC, sessions, compaction, themes)
- Examples directory — Working examples for extensions, SDK usage, and more
- Theme guide — Theme schema, color tokens, and examples
- Migration guide — Upgrading from hooks/tools to extensions
- Web UI utilities — Provider dialogs and model discovery utilities
- Model registry — Core model/provider registry implementation
- Pods models.json — Example models.json for pods and local runners
Submission Checklist
When adding a new resource, ensure the following:
Please add only one-line entries (short description + link). Maintainers may re-order or trim entries during review.
Contributing
Fork, create a topic branch, add your entry to the appropriate section in this README (one-line entry, alphabetical), and open a Pull Request using the PR template.
This repository includes automated tools for discovering new pi-agent resources shared in Discord servers. See discord_scraping/ for:
- Puppeteer-based scraper with forum post support
- Incremental message tracker with state persistence
- GitHub link extraction from channels and forums
- Automatic filtering for pi-agent content
- Integration with awesome list checking
Run ./discord_scraping/run.sh to find new resources to add to this list.
CI
Link-checker workflow: .github/workflows/check-links.yml (runs on push and PRs)
License
MIT — see LICENSE