How lineville/herdr-flightdeck-layout works
This repository is a collection of Herdr desktop mods centered on Flight Deck: users organize repository spaces and worktrees, launch agent terminals or chats, and monitor agents in an orbital view. Supporting mods provide tab and file navigation, context menus, worktree management, and Claude/Codex usage meters. The sampled code shows shared state and host commands, but not every mod’s registration or UI wiring; uncertain links are omitted.
Main entry points: flightdeck/main.js Agent fleet view · deck-tabs/main.js Tab navigation · deck-spaces/main.js Space and worktree tree · fetch.py Usage fetcher
Components 16
Workspace navigation
- Space and worktree tree
mods/deck-spaces/main.js - Tab navigation
mods/deck-tabs/main.js - File browser
mods/deck-files/main.js - Sidebar context menu
mods/deck-menu/main.js - New agent menu
mods/deck-new-menu/main.js - Worktree dialog
mods/deck-worktree/main.js
Flight Deck
- Agent fleet view
mods/flightdeck/main.js - Orbit geometry
mods/flightdeck/orbit.js - Status parsing and model look
mods/flightdeck/telemetry.js - Demo fleet data
mods/flightdeck/demo.js
Usage metering
- Usage status bar
mods/usage-meter/main.js - Usage fetcher
mods/usage-meter/fetch.py
Other components
- Herdr user
- Herdr host
- Anthropic usage API
- ChatGPT usage API
Connections 18
- Herdr user → Tab navigation: uses tabs
mods/deck-tabs/main.js - Herdr user → New agent menu: launches agents
mods/deck-new-menu/main.js - Herdr user → Usage status bar: checks usage
mods/usage-meter/main.js - Space and worktree tree → Herdr host: reads commands
mods/deck-spaces/main.js - Space and worktree tree → Tab navigation: publishes tree
mods/deck-spaces/main.js - Tab navigation → Herdr host: runs tab actions
mods/deck-tabs/main.js - Tab navigation → Space and worktree tree: reads shared tree
mods/deck-tabs/main.js - File browser → Herdr host: runs Git
mods/deck-files/main.js - Sidebar context menu → Herdr host: runs tab actions
mods/deck-menu/main.js - New agent menu → Herdr host: creates tabs
mods/deck-new-menu/main.js - Worktree dialog → Herdr host: runs Git
mods/deck-worktree/main.js - Agent fleet view → Herdr host: reads agent state
mods/flightdeck/main.js - Agent fleet view → Orbit geometry: projects positions
mods/flightdeck/main.js - Agent fleet view → Status parsing and model look: parses status
mods/flightdeck/main.js - Agent fleet view → Demo fleet data: uses demo data
mods/flightdeck/main.js - Usage status bar → Herdr host: executes fetcher
mods/usage-meter/main.js - Usage fetcher → Anthropic usage API: requests usage
mods/usage-meter/fetch.py - Usage fetcher → ChatGPT usage API: requests usage
mods/usage-meter/fetch.py