# jholhewres/devpit architecture

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

- Interactive diagram: https://gitdiagram.com/jholhewres/devpit
- Repository: https://github.com/jholhewres/devpit

## Overview

devpit is a local-first desktop control room for coding agents. A person manages project cards and runs work from the board, while tmux-backed sessions continue independently of the window; the app exposes their activity through terminal panes, costs, and notifications. The orchestrator and optional assistant provide cross-project context, schedules, and handoffs, with browser and remote features as additional capabilities. The graph follows documented behavior and visible call sites; several major subsystems are represented by their exact paths but their internal wiring was not sampled.

Main entry points: [`apps/desktop/src/assistant_watch.rs`](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/assistant_watch.rs) (Assistant heartbeat), [`apps/desktop/src/board.rs`](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/board.rs) (Project board), [`apps/desktop/src/arranging.rs`](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/arranging.rs) (Pane arrangement), [`apps/desktop/src/assistant.rs`](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/assistant.rs) (Assistant mode)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_web["Desktop UI<br/>[main.tsx]"]
  node_handler["Command handler<br/>[handler.rs]"]
end

subgraph group_work["Project work"]
  node_projects["Projects<br/>[projects.rs]"]
  node_board["Project board<br/>[board.rs]"]
  node_cardactivity["Card activity<br/>[card_activity.rs]"]
end

subgraph group_sessions["Agent sessions"]
  node_arranging["Pane arrangement<br/>[arranging.rs]"]
  node_paneio["Pane I/O<br/>[pane_io.rs]"]
  node_blocks["Command blocks<br/>[blocks.rs]"]
  node_tap["Terminal tap<br/>[tap.rs]"]
  node_sessionsvc["Session runtime<br/>[sessions.rs]"]
  node_tmux["tmux sessions<br/>[clients.rs]"]
end

subgraph group_assist["Orchestration"]
  node_orchestrator["Orchestrator chat<br/>[orchestrator.rs]"]
  node_assistant["Assistant mode<br/>[assistant.rs]"]
  node_watch["Assistant heartbeat<br/>[assistant_watch.rs]"]
  node_briefing["Project briefing<br/>[briefing.rs]"]
  node_schedules["Schedules<br/>[schedules.rs]"]
  node_asking["Permission questions<br/>[asking.rs]"]
  node_askingpicks["Question choices<br/>[asking_picks.rs]"]
end

subgraph group_integrations["Connected services"]
  node_notices["Notifications<br/>[notices.rs]"]
  node_browser["Browser pane<br/>[browser.rs]"]
  node_telegram["Telegram channel<br/>[telegram.rs]"]
  node_filesystem["Local workspace<br/>[wsfiles.rs]"]
end

node_person(("Person"))

node_person -->|"uses"| node_web
node_web -.->|"invokes commands"| node_handler
node_person -->|"moves cards"| node_board
node_board -->|"reads activity"| node_cardactivity
node_person -->|"manages projects"| node_projects
node_board -->|"starts step work"| node_sessionsvc
node_person -->|"arranges panes"| node_arranging
node_arranging -->|"reads pane cwd"| node_paneio
node_arranging -->|"reads last cwd"| node_blocks
node_sessionsvc -.->|"keeps sessions"| node_tmux
node_person -->|"chats across projects"| node_orchestrator
node_assistant -->|"requests briefing"| node_briefing
node_assistant -->|"delegates tools"| node_schedules
node_watch -->|"checks routines"| node_schedules
node_watch -->|"emits notices"| node_notices
node_watch -->|"sends messages"| node_telegram
node_person -->|"answers questions"| node_asking
node_asking -->|"uses choices"| node_askingpicks
node_person -->|"uses browser pane"| node_browser
node_person -->|"views files and diffs"| node_filesystem

click node_web "https://github.com/jholhewres/devpit/blob/main/web/src/main.tsx"
click node_handler "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/handler.rs"
click node_projects "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/projects.rs"
click node_board "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/board.rs"
click node_cardactivity "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/card_activity.rs"
click node_arranging "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/arranging.rs"
click node_paneio "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/pane_io.rs"
click node_blocks "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/blocks.rs"
click node_tap "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/tap.rs"
click node_sessionsvc "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/sessions.rs"
click node_tmux "https://github.com/jholhewres/devpit/blob/main/crates/tmux/src/clients.rs"
click node_orchestrator "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/orchestrator.rs"
click node_assistant "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/assistant.rs"
click node_watch "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/assistant_watch.rs"
click node_briefing "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/briefing.rs"
click node_schedules "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/schedules.rs"
click node_asking "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/asking.rs"
click node_askingpicks "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/asking_picks.rs"
click node_notices "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/notices.rs"
click node_browser "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/browser.rs"
click node_telegram "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/telegram.rs"
click node_filesystem "https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/wsfiles.rs"

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_web,node_handler toneBlue
class node_projects,node_board,node_cardactivity toneAmber
class node_arranging,node_paneio,node_blocks,node_tap,node_sessionsvc,node_tmux toneMint
class node_orchestrator,node_assistant,node_watch,node_briefing,node_schedules,node_asking,node_askingpicks toneRose
class node_notices,node_browser,node_telegram,node_filesystem,node_person toneIndigo
```

## Components

### Desktop interface

- [Desktop UI](https://github.com/jholhewres/devpit/blob/main/web/src/main.tsx): `web/src/main.tsx`
- [Command handler](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/handler.rs): `apps/desktop/src/handler.rs`

### Project work

- [Projects](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/projects.rs): `apps/desktop/src/projects.rs`
- [Project board](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/board.rs): `apps/desktop/src/board.rs`
- [Card activity](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/card_activity.rs): `apps/desktop/src/card_activity.rs`

### Agent sessions

- [Pane arrangement](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/arranging.rs): `apps/desktop/src/arranging.rs`
- [Pane I/O](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/pane_io.rs): `apps/desktop/src/pane_io.rs`
- [Command blocks](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/blocks.rs): `apps/desktop/src/blocks.rs`
- [Terminal tap](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/tap.rs): `apps/desktop/src/tap.rs`
- [Session runtime](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/sessions.rs): `apps/desktop/src/sessions.rs`
- [tmux sessions](https://github.com/jholhewres/devpit/blob/main/crates/tmux/src/clients.rs): `crates/tmux/src/clients.rs`

### Orchestration

- [Orchestrator chat](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/orchestrator.rs): `apps/desktop/src/orchestrator.rs`
- [Assistant mode](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/assistant.rs): `apps/desktop/src/assistant.rs`
- [Assistant heartbeat](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/assistant_watch.rs): `apps/desktop/src/assistant_watch.rs`
- [Project briefing](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/briefing.rs): `apps/desktop/src/briefing.rs`
- [Schedules](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/schedules.rs): `apps/desktop/src/schedules.rs`
- [Permission questions](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/asking.rs): `apps/desktop/src/asking.rs`
- [Question choices](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/asking_picks.rs): `apps/desktop/src/asking_picks.rs`

### Connected services

- [Notifications](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/notices.rs): `apps/desktop/src/notices.rs`
- [Browser pane](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/browser.rs): `apps/desktop/src/browser.rs`
- [Telegram channel](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/telegram.rs): `apps/desktop/src/telegram.rs`
- [Local workspace](https://github.com/jholhewres/devpit/blob/main/apps/desktop/src/wsfiles.rs): `apps/desktop/src/wsfiles.rs`

### Other components

- **Person**

## Connections

- Person → Desktop UI: uses (evidence: `README.md`)
- Desktop UI → Command handler: invokes commands
- Person → Project board: moves cards (evidence: `README.md`)
- Project board → Card activity: reads activity (evidence: `apps/desktop/src/board.rs`)
- Person → Projects: manages projects (evidence: `README.md`)
- Project board → Session runtime: starts step work (evidence: `apps/desktop/src/board.rs`)
- Person → Pane arrangement: arranges panes (evidence: `README.md`)
- Pane arrangement → Pane I/O: reads pane cwd (evidence: `apps/desktop/src/arranging.rs`)
- Pane arrangement → Command blocks: reads last cwd (evidence: `apps/desktop/src/arranging.rs`)
- Session runtime → tmux sessions: keeps sessions
- Person → Orchestrator chat: chats across projects (evidence: `README.md`)
- Assistant mode → Project briefing: requests briefing (evidence: `apps/desktop/src/assistant.rs`)
- Assistant mode → Schedules: delegates tools (evidence: `apps/desktop/src/assistant.rs`)
- Assistant heartbeat → Schedules: checks routines (evidence: `apps/desktop/src/assistant_watch.rs`)
- Assistant heartbeat → Notifications: emits notices (evidence: `apps/desktop/src/assistant_watch.rs`)
- Assistant heartbeat → Telegram channel: sends messages (evidence: `apps/desktop/src/assistant_watch.rs`)
- Person → Permission questions: answers questions (evidence: `apps/desktop/src/asking.rs`)
- Permission questions → Question choices: uses choices (evidence: `apps/desktop/src/asking.rs`)
- Person → Browser pane: uses browser pane (evidence: `README.md`)
- Person → Local workspace: views files and diffs (evidence: `README.md`)
