ModelDeck
Local-first macOS companion for monitoring and switching Claude Code and Codex CLI accounts; no native Claude Code plugin is documented as the product mechanism.
README.mdmacOS menu bar account and usage monitor · Released application; package metadata reports version 1.1.8.
Source-visible macOS 14+ menu bar application with a bundled localhost Node daemon that monitors remaining Claude Code and Codex CLI rate-limit windows across isolated accounts, alerts on low capacity, and switches the account used by new CLI sessions without acting as a Claude Code plugin.
Selection
Boundaries
Strengths
Risk profile
The documented daemon binds only to 127.0.0.1, rejects unexpected Host and Origin headers, and requires a per-server token plus SameSite=Strict cookie for mutations. State is described as owner-only SQLite. Updates are described as EdDSA- and Apple-signature-verified. These controls were not independently inspected or audited.
Component inventory
Local-first macOS companion for monitoring and switching Claude Code and Codex CLI accounts; no native Claude Code plugin is documented as the product mechanism.
README.mdNative SwiftUI MenuBarExtra client for the local daemon, including the deck popover and Settings window.
macos/ModelDeckMac/Shows per-account remaining limits, reset times, plan tiers, model-scoped caps, and provider-aware sorting.
macos/ModelDeckMac/Sources/ModelDeckMacCreates named, isolated Claude or Codex profile homes and guides provider-owned browser sign-in plus identity confirmation.
macos/ModelDeckMac/Sources/ModelDeckMacAtomically switches the provider profile used by new terminal sessions and reports effective, mismatched, or unverified identity state.
macos/ModelDeckMac/Sources/ModelDeckMacDisplays healthy, low, or critical menu bar state and posts one notification when remaining usage crosses a configured threshold.
macos/ModelDeckMac/Sources/ModelDeckMacCore/UsageNotifications.swiftReports installed versus latest Claude Code and Codex CLI versions plus per-account authentication health.
macos/ModelDeckMac/Sources/ModelDeckMacNode.js and SQLite API service that reads provider usage, manages state, and serves the native app on loopback.
src/Optional single-page usage analytics view served by the daemon on its loopback listener.
dashboard/; src/dashboard-app.mjsStarts ModelDeck automatically through macOS SMAppService.
macos/ModelDeckMac/Sources/ModelDeckMacCoreOptionally checks public GitHub releases, verifies approved downloads, installs updates, and relaunches the app.
README.mdPackage-defined command-line entry point for the repository's local control plane.
bin/modeldeck.mjs; package.jsonRepository-local Claude Code skill documented as the authoritative orchestrator for lane routing, verification, review, and merges.
.claude/skills/orchestrate/SKILL.mdRepo configuration enables an external team-workflow pack whose skills are bound to this repository's tracker, review, memory, and handoff conventions.
.claude/settings.json; docs/agents/team-workflow.mdBinds or refreshes repository-specific tracker, verification, decision, handoff, and workflow facts.
docs/agents/team-workflow.mdProvides the everyday review floor, using repository-proven defect classes and mandatory security, accessibility, or compatibility lenses where applicable.
docs/agents/team-workflow.md; docs/agents/defect-classes.mdRuns a read-only repository review lane and records each run as a tracker issue for disposition.
docs/agents/team-workflow.mdMaintains decision records and terminology under the documented repository memory home and size bound.
docs/agents/team-workflow.mdRepository wrapper documented as the required launcher for Codex-backed implementation lanes.
scripts/lane-codex.shWatches repository lane execution while the manifest records actual model, effort, launch, and exit data.
scripts/lane-watch.mjsTechnical profile
Classification
Evidence: ModelDeck installs as a self-contained macOS menu bar app with a bundled localhost daemon and operates beside Claude Code and Codex. It reads usage and switches isolated profile homes for new sessions, but no Claude Code plugin, skill, hook, or context injection is documented.
Standalone · low setup effort · high confidence · automatedEvidence and risk
Routing context
ModelDeck monitors Codex CLI usage through codex app-server and activates isolated CODEX_HOME profiles for new Codex sessions.
high confidence