Pi Agent Home
February 14, 2026 · View on GitHub
This repository is my Pi coding agent home directory. I keep it under version control and symlink it to ~/.pi/agent so Pi loads configuration, extensions, skills, and runtime state from here.
ln -s /path/to/this/repo ~/.pi/agent
Contents
agents/— agent profile prompt overrides (planner,reviewer,scout,worker).extensions/— local extensions (see below).skills/— custom agent skills (npm,workon,sample-skill).
Extensions
Each extension lives in extensions/<name>/ with its own README.md and settings documentation.
| Extension | Description |
|---|---|
| pi-calendar | Calendar tool, web dashboard, and event reminders |
| pi-channels | Two-way messaging (Telegram, webhooks) with chat bridge |
| pi-cron | Cron scheduler for recurring agent prompts |
| pi-dotenv | Deprecated — kept as no-op for backwards compatibility |
| pi-github | GitHub PR management, issues, CI, and review feedback commands |
| pi-heartbeat | Periodic health checks with web dashboard and alerts |
| pi-jobs | Agent run telemetry and cost tracking |
| pi-kysely | Shared Kysely database registry with table-level RBAC |
| pi-logger | Centralized structured JSONL logging via event bus |
| pi-memory | Persistent memory — long-term facts, daily logs, search |
| pi-npm | NPM workflow tool (install, publish, version, audit, etc.) |
| pi-personal-crm | Personal CRM with contacts, companies, interactions |
| pi-projects | Project tracking dashboard with git status |
| pi-subagent | Parallel task delegation via isolated subprocesses |
| pi-supabase | Read-only Supabase queries with realtime notifications |
| pi-td | Task management with optional web dashboard |
| pi-telemetry | Local-only privacy-safe event telemetry |
| pi-vault | Obsidian vault tool and health dashboard |
| pi-web-dashboard | Web dashboard landing page |
| pi-webnav | Web navigation and scraping tool |
| pi-webserver | Shared HTTP server with auth for all web extensions |
| pi-workon | Project context switching and scaffolding |
Skills
| Skill | Description |
|---|---|
changelog-generator | Generate and update changelogs from git history |
git-project-status | Comprehensive status reports for git repositories |
handoff | Generate continuation prompts for fresh agent sessions |
npm | Manage npm packages — install, publish, version bump, audit, and run scripts |
readme-reviewer | Review and generate README files for any project |
sample-skill | Template skill for creating new skills |
workon | Switch working context to a project — loads AGENTS.md, git status, and td issues |
Disclaimer
These are my personal extensions, catered to my own workflow and needs — they might not suit everyone. Feedback is welcome via GitHub issues or reach out to me on X.