feat(codex): add multi-account support via Hermes and smart tray averaging

docs/providers/codex.md

@@ -29,3 +29,9 @@ Codex usage recorded by pi can also be included. OpenQuota does not upload these
 - **Subscription usage unavailable** — replace an API-key-only login with a ChatGPT login.
 - **Session expired or revoked** — sign in again with `codex`.
 - **No local history** — check the active Codex data directory and the value of `CODEX_HOME`.
+
+## Multi-Account Support
+
+OpenQuota supports multiple Codex accounts through the Hermes credentials pool (`~/.hermes/auth.json`). When using the Hermes file format, OpenQuota detects and monitors all available accounts. 
+
+By default, the `Weekly` metric is pinned to the system tray for all active Codex accounts. The tray icon automatically calculates and displays the average health (remaining limit) across all pinned metrics across all your configured accounts.

scripts/verify/verify-provider-registry-contract.js

@@ -77,6 +77,7 @@ if (!runtimeBlock) {
 }
 const runtimeOrder = [
   'ClaudeProvider',
+  'CodexProvider',
   ...[...runtimeBlock.matchAll(/Arc::new\((\w+Provider)::new\b/g)].map(([, provider]) => provider),
 ];
 const expectedRuntimeOrder = [

src-tauri/src/commands/usage.rs

@@ -24,7 +24,7 @@ pub async fn claim_codex_reset_credit(
     if !settings
         .enabled_provider_ids()
         .iter()
-        .any(|id| id == "codex")
+        .any(|id| crate::providers::provider_family(id) == "codex")
     {
         return Err("Codex is not enabled.".to_owned());
     }
@@ -36,7 +36,14 @@ pub async fn claim_codex_reset_credit(
 
     if outcome != ResetClaimOutcome::Failed {
         let observed_account_revision = AtomicU64::new(settings.account_revision());
-        service.refresh("codex", true).await;
+        let codex_ids: Vec<_> = settings
+            .enabled_provider_ids()
+            .into_iter()
+            .filter(|id| crate::providers::provider_family(id) == "codex")
+            .collect();
+        for codex_id in &codex_ids {
+            service.refresh(codex_id, true).await;
+        }
         let state = service.state();
         emit_settings_if_account_changed(&app, &settings, &observed_account_revision);
         let _ = app.emit("usage-state", &state);

src-tauri/src/lib.rs

@@ -47,11 +47,11 @@ use crate::{
     pacing::NotificationEvaluator,
     pricing::PricingStore,
     providers::{
-        antigravity::AntigravityProvider, claude, codex::reset_claim::CodexResetClaimService,
-        codex::CodexProvider, copilot::CopilotProvider, cursor::CursorProvider,
-        detect_local_credentials, devin::DevinProvider, grok::GrokProvider, kimi::KimiProvider,
-        minimax::MiniMaxProvider, opencode::OpenCodeProvider, openrouter::OpenRouterProvider,
-        zai::ZaiProvider, ProviderRegistry, UsageProvider,
+        antigravity::AntigravityProvider, claude, codex,
+        codex::reset_claim::CodexResetClaimService, copilot::CopilotProvider,
+        cursor::CursorProvider, detect_local_credentials, devin::DevinProvider, grok::GrokProvider,
+        kimi::KimiProvider, minimax::MiniMaxProvider, opencode::OpenCodeProvider,
+        openrouter::OpenRouterProvider, zai::ZaiProvider, ProviderRegistry, UsageProvider,
     },
     storage::Storage,
     window::{
@@ -71,13 +71,27 @@ fn install_tray(app: &mut App) -> Result<(), Box<dyn std::error::Error>> {
     };
     #[cfg(not(target_os = "macos"))]
     let menu = {
-        let open = MenuItem::with_id(app, "open", "Open OpenQuota", true, None::<&str>)?;
+        let summary = MenuItem::with_id(app, "summary", "Average Limit: ...", false, None::<&str>)?;
+        let separator_top = PredefinedMenuItem::separator(app)?;
+        let open = MenuItem::with_id(app, "open", "Open Dashboard", true, None::<&str>)?;
         let customize = MenuItem::with_id(app, "customize", "Customize…", true, None::<&str>)?;
         let settings_item = MenuItem::with_id(app, "settings", "Settings…", true, None::<&str>)?;
         let separator = PredefinedMenuItem::separator(app)?;
         let quit = MenuItem::with_id(app, "quit", "Quit OpenQuota", true, None::<&str>)?;
-        Menu::with_items(app, &[&open, &customize, &settings_item, &separator, &quit])?
+        Menu::with_items(
+            app,
+            &[
+                &summary,
+                &separator_top,
+                &open,
+                &customize,
+                &settings_item,
+                &separator,
+                &quit,
+            ],
+        )?
     };
+    app.manage(menu.clone());
 
     let icon = app
         .default_window_icon()
@@ -367,9 +381,13 @@ pub fn run() {
             app_debug!("cache", "application database opened");
             let pricing = Arc::new(PricingStore::new(app_data_dir.join("pricing"))?);
             let mut providers = claude::runtimes(storage.clone(), pricing.clone())?;
+            providers.extend(
+                codex::runtimes(storage.clone(), pricing.clone()).unwrap_or_else(|error| {
+                    crate::app_error!("startup", "failed to launch codex runtimes ({error})");
+                    Vec::new()
+                }),
+            );
             providers.extend(vec![
-                Arc::new(CodexProvider::new(storage.clone(), pricing.clone())?)
-                    as Arc<dyn UsageProvider>,
                 Arc::new(CursorProvider::new(pricing.clone())?) as Arc<dyn UsageProvider>,
                 Arc::new(AntigravityProvider::new(
                     app_data_dir.join("antigravity").join("auth.json"),