How jholhewres/devpit works
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: assistant_watch.rs Assistant heartbeat · board.rs Project board · arranging.rs Pane arrangement · assistant.rs Assistant mode
Components 23
Desktop interface
- Desktop UI
web/src/main.tsx - Command handler
apps/desktop/src/handler.rs
Project work
- Projects
apps/desktop/src/projects.rs - Project board
apps/desktop/src/board.rs - Card activity
apps/desktop/src/card_activity.rs
Agent sessions
- Pane arrangement
apps/desktop/src/arranging.rs - Pane I/O
apps/desktop/src/pane_io.rs - Command blocks
apps/desktop/src/blocks.rs - Terminal tap
apps/desktop/src/tap.rs - Session runtime
apps/desktop/src/sessions.rs - tmux sessions
crates/tmux/src/clients.rs
Orchestration
- Orchestrator chat
apps/desktop/src/orchestrator.rs - Assistant mode
apps/desktop/src/assistant.rs - Assistant heartbeat
apps/desktop/src/assistant_watch.rs - Project briefing
apps/desktop/src/briefing.rs - Schedules
apps/desktop/src/schedules.rs - Permission questions
apps/desktop/src/asking.rs - Question choices
apps/desktop/src/asking_picks.rs
Connected services
- Notifications
apps/desktop/src/notices.rs - Browser pane
apps/desktop/src/browser.rs - Telegram channel
apps/desktop/src/telegram.rs - Local workspace
apps/desktop/src/wsfiles.rs
Other components
- Person
Connections 20
- Person → Desktop UI: uses
README.md - Desktop UI → Command handler: invokes commands
- Person → Project board: moves cards
README.md - Project board → Card activity: reads activity
apps/desktop/src/board.rs - Person → Projects: manages projects
README.md - Project board → Session runtime: starts step work
apps/desktop/src/board.rs - Person → Pane arrangement: arranges panes
README.md - Pane arrangement → Pane I/O: reads pane cwd
apps/desktop/src/arranging.rs - Pane arrangement → Command blocks: reads last cwd
apps/desktop/src/arranging.rs - Session runtime → tmux sessions: keeps sessions
- Person → Orchestrator chat: chats across projects
README.md - Assistant mode → Project briefing: requests briefing
apps/desktop/src/assistant.rs - Assistant mode → Schedules: delegates tools
apps/desktop/src/assistant.rs - Assistant heartbeat → Schedules: checks routines
apps/desktop/src/assistant_watch.rs - Assistant heartbeat → Notifications: emits notices
apps/desktop/src/assistant_watch.rs - Assistant heartbeat → Telegram channel: sends messages
apps/desktop/src/assistant_watch.rs - Person → Permission questions: answers questions
apps/desktop/src/asking.rs - Permission questions → Question choices: uses choices
apps/desktop/src/asking.rs - Person → Browser pane: uses browser pane
README.md - Person → Local workspace: views files and diffs
README.md