28 lines (22 loc) · 1.18 KB

summary

Architecture overview: modules, entry points, and data flow.

read_when

Reviewing architecture before feature work

Refactoring app structure, app lifecycle, or module boundaries

Architecture overview

Modules

Sources/CodexBarCore: fetch + parse (Codex RPC, PTY runner, Claude probes, OpenAI web scraping, status polling).
Sources/CodexBar: state + UI (UsageStore, SettingsStore, StatusItemController, menus, icon rendering).
Sources/CodexBarWidget: WidgetKit extension wired to the shared snapshot.
Sources/CodexBarCLI: bundled CLI for codexbar usage/status output.

Entry points

CodexBarApp: SwiftUI keepalive + Settings scene.
AppDelegate: wires status controller, Sparkle updater, notifications.

Data flow

Background refresh → UsageFetcher/provider probes → UsageStore → menu/icon/widgets.
Settings toggles feed SettingsStore → UsageStore refresh cadence + feature flags.

Concurrency & platform

Swift 6 strict concurrency enabled; prefer Sendable state and explicit MainActor hops.
macOS 15+ targeting; avoid deprecated APIs when refactoring.

See also: docs/providers.md, docs/refresh-loop.md, docs/ui.md.