How pducharme/codex-claude-quota-display works
Quota Display is a macOS quota companion with an optional network API source and ESP32 mini-screen. The main path is provider sessions on the source Mac → quota bridge → Companion or device display. The Designer adds configurable pages, local and connected data, and nearby-flight alerts. Edges are limited to README statements and shown source references/calls; unsampled details are not assumed.
Main entry points: designer.py Designer config · main.cpp Device runtime · quota_bridge.py Quota bridge · DesignerRuntime.h Page rendering
Components 22
Mac Companion
- Menu companion
bridge/quota_menu.swift
Quota API
- Quota bridge
bridge/quota_bridge.py
Page Designer
- Designer config
bridge/designer.py - Designer editor
bridge/designer/app.js - Connected data
bridge/designer_integrations.py - Mac data
bridge/designer_local.py - Web services
bridge/designer_services.py
Mini-screen Firmware
- Device runtime
firmware/src/main.cpp - Configuration checks
firmware/src/ConfigurationValidation.h - Sleep schedule
firmware/src/DisplaySleep.h - Page rendering
firmware/include/DesignerRuntime.h - Page rotation
firmware/include/DesignerSelection.h - Flight rendering
firmware/include/DesignerSky.h - Designer fonts
firmware/include/DesignerFonts.h - Flight fonts
firmware/include/DesignerSkyFonts.h - LCD driver
firmware/lib/Arduino_AXS15231/src/Arduino_AXS15231.cpp
Other components
- Mac user
- Codex app
- Claude Desktop
- Remote clients
- T-Display S3
- Flight data
Connections 23
- Mac user → Menu companion: configures
README.md - Codex app → Menu companion: provides session
README.md - Claude Desktop → Menu companion: provides session
README.md - Menu companion → Quota bridge: uses local API
README.md - Quota bridge → Remote clients: serves quotas
README.md - Quota bridge → T-Display S3: serves quotas
README.md - Mac user → Designer editor: edits pages
README.md - Designer config → Connected data: uses connections
bridge/designer.py - Designer config → Mac data: uses local data
bridge/designer.py - Designer config → Web services: polls services
bridge/designer.py - Quota bridge → Designer config: routes Designer
bridge/quota_bridge.py - Designer config → Flight data: fetches nearby flights
bridge/designer.py - Device runtime → Quota bridge: fetches quotas
firmware/src/main.cpp - Device runtime → Configuration checks: validates settings
firmware/src/main.cpp - Device runtime → Sleep schedule: checks sleep
firmware/src/main.cpp - Device runtime → Page rendering: starts Designer
firmware/src/main.cpp - Page rendering → Page rotation: selects pages
firmware/include/DesignerRuntime.h - Page rendering → Flight rendering: renders flight page
firmware/include/DesignerRuntime.h - Page rendering → Designer fonts: uses fonts
firmware/include/DesignerRuntime.h - Flight rendering → Flight fonts: uses fonts
firmware/include/DesignerSky.h - Device runtime → LCD driver: drives display
- Designer editor → Designer config: publishes pages
README.md - Designer config → Device runtime: publishes pages
README.md