# dandjo/pi.dev-extensions architecture

> Architecture diagram of the GitHub repository dandjo/pi.dev-extensions, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dandjo/pi.dev-extensions
- Repository: https://github.com/dandjo/pi.dev-extensions

## Overview

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: [`extensions/subagents.ts`](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/subagents.ts) (Subagents), [`extensions/background-agents.ts`](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/background-agents.ts) (Agent panel), [`extensions/claude-code-agents.ts`](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-code-agents.ts) (Claude agent formats), [`extensions/claude-usage.ts`](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-usage.ts) (Subscription usage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent["Agent tools"]
  node_questions["Ask questions"]
  node_sidequestion["Side questions<br/>[btw.ts]"]
  node_goals["Goal evaluator<br/>[goal.ts]"]
  node_subagents["Subagents<br/>[subagents.ts]"]
  node_agentpanel["Agent panel"]
  node_wait["Wait tools<br/>[wait.ts]"]
  node_schedule["Scheduled prompts<br/>[scheduled-tasks.ts]"]
  node_context["Context compaction<br/>[context-gc.ts]"]
end

subgraph group_sessions["Session experience"]
  node_memory["Project memory<br/>[memory.ts]"]
  node_titles["Session titles<br/>[session-title.ts]"]
  node_socket["Session messaging<br/>[session-socket.ts]"]
  node_diff["Diff review<br/>[diff.ts]"]
  node_status["Status line<br/>[statusline.ts]"]
  node_compact["Tool-row display<br/>[compact-tools.ts]"]
  node_tmux["Tmux activity"]
end

subgraph group_claude["Claude compatibility"]
  node_hooks["Claude hooks"]
  node_plugins["Claude plugins"]
  node_claudeagents["Claude agent formats"]
  node_login["Claude login<br/>[claude-login.ts]"]
  node_usage["Subscription usage<br/>[claude-usage.ts]"]
  node_remote["Remote Control"]
  node_stream["Stream responses"]
  node_sdkupdate["SDK updates"]
  node_resume["Resume fix"]
end

subgraph group_integrations["External integrations"]
  node_web["Web research<br/>[web-tools.ts]"]
  node_openproject["OpenProject API<br/>[openproject.ts]"]
  node_gitlab["GitLab and CI<br/>[gitlab.ts]"]
  node_clipboard["Clipboard access<br/>[clipboard.ts]"]
  node_chrome["Chrome control<br/>[web-tools.ts]"]
end

subgraph group_maintenance["Reliability and upkeep"]
  node_resilience["Network resilience"]
  node_packageupdate["Package updates<br/>[package-update.ts]"]
end

node_user(("Pi user"))
node_openprojectapi(("OpenProject service"))
node_gitlabservice(("GitLab service"))

node_user -->|"asks"| node_questions
node_user -->|"asks"| node_sidequestion
node_user -->|"sets goal"| node_goals
node_user -->|"delegates"| node_subagents
node_user -->|"views agents"| node_agentpanel
node_user -->|"waits on"| node_wait
node_user -->|"schedules"| node_schedule
node_user -->|"manages context"| node_context
node_user -->|"uses memory"| node_memory
node_user -->|"messages sessions"| node_socket
node_user -->|"reviews changes"| node_diff
node_user -->|"researches"| node_web
node_user -->|"manages work"| node_openproject
node_openproject -->|"calls API"| node_openprojectapi
node_user -->|"manages projects"| node_gitlab
node_gitlab -->|"calls API"| node_gitlabservice
node_user -->|"reads and writes"| node_clipboard
node_user -->|"controls browser"| node_chrome
node_user -->|"connects remotely"| node_remote
node_user -->|"runs hooks"| node_hooks
node_user -->|"loads plugins"| node_plugins
node_user -->|"uses agent formats"| node_claudeagents
node_user -->|"signs in"| node_login
node_user -->|"checks limits"| node_usage
node_usage -->|"adds usage"| node_status
node_user -->|"uses streamed replies"| node_stream
node_user -->|"updates SDK"| node_sdkupdate
node_user -->|"resumes sessions"| node_resume
node_user -->|"rides out outages"| node_resilience
node_user -->|"updates packages"| node_packageupdate
node_claudeagents -->|"extends Agent"| node_subagents
node_agentpanel -->|"requires"| node_subagents

click node_questions "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/ask-user-question.ts"
click node_sidequestion "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/btw.ts"
click node_goals "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/goal.ts"
click node_subagents "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/subagents.ts"
click node_agentpanel "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/background-agents.ts"
click node_wait "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/wait.ts"
click node_schedule "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/scheduled-tasks.ts"
click node_context "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/context-gc.ts"
click node_memory "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/memory.ts"
click node_titles "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/session-title.ts"
click node_socket "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/session-socket.ts"
click node_diff "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/diff.ts"
click node_status "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/statusline.ts"
click node_compact "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/compact-tools.ts"
click node_tmux "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/tmux-tab-activity.ts"
click node_hooks "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-code-hooks.ts"
click node_plugins "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-code-plugins.ts"
click node_claudeagents "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-code-agents.ts"
click node_login "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-login.ts"
click node_usage "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-usage.ts"
click node_remote "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-remote-control.ts"
click node_stream "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-sdk-stream-only.ts"
click node_sdkupdate "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-sdk-update.ts"
click node_resume "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-sdk-resume-fix.ts"
click node_web "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/web-tools.ts"
click node_openproject "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/openproject.ts"
click node_gitlab "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/gitlab.ts"
click node_clipboard "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/clipboard.ts"
click node_chrome "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/web-tools.ts"
click node_resilience "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/network-resilience.ts"
click node_packageupdate "https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/package-update.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_questions,node_sidequestion,node_goals,node_subagents,node_agentpanel,node_wait,node_schedule,node_context,node_user toneBlue
class node_memory,node_titles,node_socket,node_diff,node_status,node_compact,node_tmux toneAmber
class node_hooks,node_plugins,node_claudeagents,node_login,node_usage,node_remote,node_stream,node_sdkupdate,node_resume toneMint
class node_web,node_openproject,node_gitlab,node_clipboard,node_chrome toneRose
class node_resilience,node_packageupdate,node_openprojectapi,node_gitlabservice toneIndigo
```

## Components

### Agent tools

- [Ask questions](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/ask-user-question.ts): `extensions/ask-user-question.ts`
- [Side questions](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/btw.ts): `extensions/btw.ts`
- [Goal evaluator](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/goal.ts): `extensions/goal.ts`
- [Subagents](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/subagents.ts): `extensions/subagents.ts`
- [Agent panel](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/background-agents.ts): `extensions/background-agents.ts`
- [Wait tools](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/wait.ts): `extensions/wait.ts`
- [Scheduled prompts](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/scheduled-tasks.ts): `extensions/scheduled-tasks.ts`
- [Context compaction](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/context-gc.ts): `extensions/context-gc.ts`

### Session experience

- [Project memory](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/memory.ts): `extensions/memory.ts`
- [Session titles](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/session-title.ts): `extensions/session-title.ts`
- [Session messaging](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/session-socket.ts): `extensions/session-socket.ts`
- [Diff review](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/diff.ts): `extensions/diff.ts`
- [Status line](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/statusline.ts): `extensions/statusline.ts`
- [Tool-row display](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/compact-tools.ts): `extensions/compact-tools.ts`
- [Tmux activity](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/tmux-tab-activity.ts): `extensions/tmux-tab-activity.ts`

### Claude compatibility

- [Claude hooks](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-code-hooks.ts): `extensions/claude-code-hooks.ts`
- [Claude plugins](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-code-plugins.ts): `extensions/claude-code-plugins.ts`
- [Claude agent formats](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-code-agents.ts): `extensions/claude-code-agents.ts`
- [Claude login](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-login.ts): `extensions/claude-login.ts`
- [Subscription usage](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-usage.ts): `extensions/claude-usage.ts`
- [Remote Control](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-remote-control.ts): `extensions/claude-remote-control.ts`
- [Stream responses](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-sdk-stream-only.ts): `extensions/claude-sdk-stream-only.ts`
- [SDK updates](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-sdk-update.ts): `extensions/claude-sdk-update.ts`
- [Resume fix](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/claude-sdk-resume-fix.ts): `extensions/claude-sdk-resume-fix.ts`

### External integrations

- [Web research](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/web-tools.ts): `extensions/web-tools.ts`
- [OpenProject API](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/openproject.ts): `extensions/openproject.ts`
- [GitLab and CI](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/gitlab.ts): `extensions/gitlab.ts`
- [Clipboard access](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/clipboard.ts): `extensions/clipboard.ts`
- [Chrome control](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/web-tools.ts): `extensions/web-tools.ts`

### Reliability and upkeep

- [Network resilience](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/network-resilience.ts): `extensions/network-resilience.ts`
- [Package updates](https://github.com/dandjo/pi.dev-extensions/blob/main/extensions/package-update.ts): `extensions/package-update.ts`

### Other components

- **Pi user**
- **OpenProject service**
- **GitLab service**

## Connections

- Pi user → Ask questions: asks (evidence: `README.md`)
- Pi user → Side questions: asks (evidence: `README.md`)
- Pi user → Goal evaluator: sets goal (evidence: `README.md`)
- Pi user → Subagents: delegates (evidence: `README.md`)
- Pi user → Agent panel: views agents (evidence: `README.md`)
- Pi user → Wait tools: waits on (evidence: `README.md`)
- Pi user → Scheduled prompts: schedules (evidence: `README.md`)
- Pi user → Context compaction: manages context (evidence: `README.md`)
- Pi user → Project memory: uses memory (evidence: `README.md`)
- Pi user → Session messaging: messages sessions (evidence: `README.md`)
- Pi user → Diff review: reviews changes (evidence: `README.md`)
- Pi user → Web research: researches (evidence: `README.md`)
- Pi user → OpenProject API: manages work (evidence: `README.md`)
- OpenProject API → OpenProject service: calls API (evidence: `README.md`)
- Pi user → GitLab and CI: manages projects (evidence: `README.md`)
- GitLab and CI → GitLab service: calls API (evidence: `README.md`)
- Pi user → Clipboard access: reads and writes (evidence: `README.md`)
- Pi user → Chrome control: controls browser (evidence: `README.md`)
- Pi user → Remote Control: connects remotely (evidence: `README.md`)
- Pi user → Claude hooks: runs hooks (evidence: `README.md`)
- Pi user → Claude plugins: loads plugins (evidence: `README.md`)
- Pi user → Claude agent formats: uses agent formats (evidence: `README.md`)
- Pi user → Claude login: signs in (evidence: `README.md`)
- Pi user → Subscription usage: checks limits (evidence: `README.md`)
- Subscription usage → Status line: adds usage (evidence: `README.md`)
- Pi user → Stream responses: uses streamed replies (evidence: `README.md`)
- Pi user → SDK updates: updates SDK (evidence: `README.md`)
- Pi user → Resume fix: resumes sessions (evidence: `README.md`)
- Pi user → Network resilience: rides out outages (evidence: `README.md`)
- Pi user → Package updates: updates packages (evidence: `README.md`)
- Claude agent formats → Subagents: extends Agent (evidence: `README.md`)
- Agent panel → Subagents: requires (evidence: `README.md`)
