How dandjo/pi.dev-extensions works
Pi extensions add independent tools, commands, session behaviors, and integrations to the terminal coding-agent workflow. A user invokes Pi or a particular extension; extensions may then call external services, adjust agent context, or expose session UI. The README documents the principal capabilities and a few extension dependencies. Source excerpts show implementation details for selected modules, but most extension internals and their wiring were not sampled, so edges are limited to documented relationships.
Main entry points: subagents.ts Subagents · background-agents.ts Agent panel · claude-code-agents.ts Claude agent formats · claude-usage.ts Subscription usage
Components 34
Agent tools
- Ask questions
extensions/ask-user-question.ts - Side questions
extensions/btw.ts - Goal evaluator
extensions/goal.ts - Subagents
extensions/subagents.ts - Agent panel
extensions/background-agents.ts - Wait tools
extensions/wait.ts - Scheduled prompts
extensions/scheduled-tasks.ts - Context compaction
extensions/context-gc.ts
Session experience
- Project memory
extensions/memory.ts - Session titles
extensions/session-title.ts - Session messaging
extensions/session-socket.ts - Diff review
extensions/diff.ts - Status line
extensions/statusline.ts - Tool-row display
extensions/compact-tools.ts - Tmux activity
extensions/tmux-tab-activity.ts
Claude compatibility
- Claude hooks
extensions/claude-code-hooks.ts - Claude plugins
extensions/claude-code-plugins.ts - Claude agent formats
extensions/claude-code-agents.ts - Claude login
extensions/claude-login.ts - Subscription usage
extensions/claude-usage.ts - Remote Control
extensions/claude-remote-control.ts - Stream responses
extensions/claude-sdk-stream-only.ts - SDK updates
extensions/claude-sdk-update.ts - Resume fix
extensions/claude-sdk-resume-fix.ts
External integrations
- Web research
extensions/web-tools.ts - OpenProject API
extensions/openproject.ts - GitLab and CI
extensions/gitlab.ts - Clipboard access
extensions/clipboard.ts - Chrome control
extensions/web-tools.ts
Reliability and upkeep
- Network resilience
extensions/network-resilience.ts - Package updates
extensions/package-update.ts
Other components
- Pi user
- OpenProject service
- GitLab service
Connections 32
- Pi user → Ask questions: asks
README.md - Pi user → Side questions: asks
README.md - Pi user → Goal evaluator: sets goal
README.md - Pi user → Subagents: delegates
README.md - Pi user → Agent panel: views agents
README.md - Pi user → Wait tools: waits on
README.md - Pi user → Scheduled prompts: schedules
README.md - Pi user → Context compaction: manages context
README.md - Pi user → Project memory: uses memory
README.md - Pi user → Session messaging: messages sessions
README.md - Pi user → Diff review: reviews changes
README.md - Pi user → Web research: researches
README.md - Pi user → OpenProject API: manages work
README.md - OpenProject API → OpenProject service: calls API
README.md - Pi user → GitLab and CI: manages projects
README.md - GitLab and CI → GitLab service: calls API
README.md - Pi user → Clipboard access: reads and writes
README.md - Pi user → Chrome control: controls browser
README.md - Pi user → Remote Control: connects remotely
README.md - Pi user → Claude hooks: runs hooks
README.md - Pi user → Claude plugins: loads plugins
README.md - Pi user → Claude agent formats: uses agent formats
README.md - Pi user → Claude login: signs in
README.md - Pi user → Subscription usage: checks limits
README.md - Subscription usage → Status line: adds usage
README.md - Pi user → Stream responses: uses streamed replies
README.md - Pi user → SDK updates: updates SDK
README.md - Pi user → Resume fix: resumes sessions
README.md - Pi user → Network resilience: rides out outages
README.md - Pi user → Package updates: updates packages
README.md - Claude agent formats → Subagents: extends Agent
README.md - Agent panel → Subagents: requires
README.md