Add Neuralwatt provider

README.md

@@ -9,7 +9,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-6e5aff?style=flat-square)](LICENSE)
 [![Site](https://img.shields.io/badge/site-codexbar.app-16d3b4?style=flat-square)](https://codexbar.app)
 
-<a href="https://codexbar.app"><img src="docs/social.png" alt="CodexBar — every AI coding limit in your menu bar. 60 providers." width="100%" /></a>
+<a href="https://codexbar.app"><img src="docs/social.png" alt="CodexBar — every AI coding limit in your menu bar. 61 providers." width="100%" /></a>
 
 Tiny macOS 14+ menu bar app that keeps **AI coding-provider limits visible** and shows when each window resets. Codex, OpenAI, Claude, Cursor, Gemini, Copilot, Grok, GroqCloud, ElevenLabs, Deepgram, z.ai, MiniMax, Kiro, Zed, Vertex AI, Augment, OpenRouter, LiteLLM, LLM Proxy, Codebuff, Command Code, ClinePass, AWS Bedrock, and many newer coding providers. One status item per provider, or Merge Icons mode with a provider switcher. No Dock icon, minimal UI, dynamic bar icons.
 
@@ -133,6 +133,7 @@ See [CLI configuration](docs/cli-configuration.md) for the full flow.
 - [Deepgram](docs/deepgram.md) — API key usage summaries across speech, agent, token, and TTS metrics.
 - [Poe](docs/poe.md) — API key for current point balance and recent points history.
 - [Chutes](docs/chutes.md) — API key for subscription usage, rolling and monthly quota windows, and pay-as-you-go quotas.
+- [Neuralwatt](docs/neuralwatt.md) — API key for subscription kWh usage and prepaid credit balance.
 - [ZenMux](docs/zenmux.md) — Management API key for rolling five-hour and seven-day quota windows plus PAYG balance.
 - Open to new providers: [provider authoring guide](docs/provider.md).
 

Sources/CodexBar/MenuCardView+Costs.swift

@@ -333,7 +333,7 @@ extension UsageMenuCardView.Model {
                 percentLine: nil)
         }
 
-        if provider == .zenmux {
+        if provider == .zenmux || provider == .neuralwatt {
             let balance = UsageFormatter.currencyString(cost.used, currencyCode: cost.currencyCode)
             return ProviderCostSection(
                 title: L("metric_mistral_payg"),

Sources/CodexBar/MenuCardView.swift

@@ -1280,7 +1280,7 @@ extension UsageMenuCardView.Model {
         {
             primaryDetailLeft = detail
         }
-        if [.warp, .kilo, .mimo, .deepseek, .qoder, .mistral, .litellm].contains(input.provider),
+        if [.warp, .kilo, .mimo, .deepseek, .qoder, .mistral, .neuralwatt, .litellm].contains(input.provider),
            let detail = primary.resetDescription,
            !detail.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty
         {
@@ -1309,7 +1309,7 @@ extension UsageMenuCardView.Model {
                 primaryResetText = nil
             }
         }
-        if [.warp, .kilo, .mimo, .deepseek, .qoder, .mistral, .litellm, .zenmux].contains(input.provider),
+        if [.warp, .kilo, .mimo, .deepseek, .qoder, .mistral, .neuralwatt, .litellm, .zenmux].contains(input.provider),
            primary.resetsAt == nil
         {
             primaryResetText = nil

Sources/CodexBar/MenuDescriptor.swift

@@ -228,8 +228,8 @@ struct MenuDescriptor {
             if let primary = snap.primary {
                 let primaryDetail = primary.resetDescription?.trimmingCharacters(in: .whitespacesAndNewlines)
                 let primaryDescriptionIsDetail = provider == .warp || provider == .kilo || provider == .abacus ||
-                    provider == .deepseek || provider == .azureopenai || provider == .mimo || provider == .qoder ||
-                    provider == .sub2api
+                    provider == .deepseek || provider == .neuralwatt || provider == .azureopenai || provider == .mimo ||
+                    provider == .qoder || provider == .sub2api
                 let primaryWindow = if primaryDescriptionIsDetail {
                     // Some providers use resetDescription for non-reset detail
                     // (e.g., "Unlimited", "X/Y credits"). Avoid rendering it as a "Resets ..." line.

Sources/CodexBar/Providers/NeuralWatt/NeuralWattProviderImplementation.swift

@@ -0,0 +1,44 @@
+import CodexBarCore
+import Foundation
+
+struct NeuralWattProviderImplementation: ProviderImplementation {
+    let id: UsageProvider = .neuralwatt
+
+    @MainActor
+    func presentation(context _: ProviderPresentationContext) -> ProviderPresentation {
+        ProviderPresentation { _ in "api" }
+    }
+
+    @MainActor
+    func observeSettings(_ settings: SettingsStore) {
+        _ = settings.neuralWattAPIKey
+        _ = settings.tokenAccountsData(for: .neuralwatt)
+    }
+
+    @MainActor
+    func isAvailable(context: ProviderAvailabilityContext) -> Bool {
+        if NeuralWattSettingsReader.apiKey(environment: context.environment) != nil {
+            return true
+        }
+        if !context.settings.neuralWattAPIKey.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty {
+            return true
+        }
+        return !context.settings.tokenAccounts(for: .neuralwatt).isEmpty
+    }
+
+    @MainActor
+    func settingsFields(context: ProviderSettingsContext) -> [ProviderSettingsFieldDescriptor] {
+        [
+            ProviderSettingsFieldDescriptor(
+                id: "neuralwatt-api-key",
+                title: "API key",
+                subtitle: "Stored in the CodexBar config file. Manage keys from the Neuralwatt dashboard.",
+                kind: .secure,
+                placeholder: "sk-...",
+                binding: context.stringBinding(\.neuralWattAPIKey),
+                actions: [],
+                isVisible: nil,
+                onActivate: nil),
+        ]
+    }
+}

Sources/CodexBar/Providers/NeuralWatt/NeuralWattSettingsStore.swift

@@ -0,0 +1,14 @@
+import CodexBarCore
+import Foundation
+
+extension SettingsStore {
+    var neuralWattAPIKey: String {
+        get { self.configSnapshot.providerConfig(for: .neuralwatt)?.sanitizedAPIKey ?? "" }
+        set {
+            self.updateProviderConfig(provider: .neuralwatt) { entry in
+                entry.apiKey = self.normalizedConfigValue(newValue)
+            }
+            self.logSecretUpdate(provider: .neuralwatt, field: "apiKey", value: newValue)
+        }
+    }
+}

Sources/CodexBar/Providers/Shared/ProviderImplementationRegistry.swift

@@ -68,6 +68,7 @@ enum ProviderImplementationRegistry {
         case .deepgram: DeepgramProviderImplementation()
         case .poe: PoeProviderImplementation()
         case .chutes: ChutesProviderImplementation()
+        case .neuralwatt: NeuralWattProviderImplementation()
         case .clawrouter: ClawRouterProviderImplementation()
         case .longcat: LongCatProviderImplementation()
         case .sub2api: Sub2APIProviderImplementation()

Sources/CodexBar/UsageStore+TokenAccountLabels.swift

@@ -0,0 +1,35 @@
+import CodexBarCore
+import Foundation
+
+extension UsageStore {
+    func applyAccountLabel(
+        _ snapshot: UsageSnapshot,
+        provider: UsageProvider,
+        account: ProviderTokenAccount) -> UsageSnapshot
+    {
+        let label = account.label.trimmingCharacters(in: .whitespacesAndNewlines)
+        guard !label.isEmpty else { return snapshot }
+        let existing = snapshot.identity(for: provider)
+        let email = existing?.accountEmail?.trimmingCharacters(in: .whitespacesAndNewlines)
+        let resolvedEmail = (email?.isEmpty ?? true) ? label : email
+        let identity = ProviderIdentitySnapshot(
+            providerID: provider,
+            accountEmail: resolvedEmail,
+            accountOrganization: existing?.accountOrganization,
+            loginMethod: existing?.loginMethod)
+        return snapshot.withIdentity(identity)
+    }
+
+    func applyCodexVisibleAccountLabel(_ snapshot: UsageSnapshot, account: CodexVisibleAccount) -> UsageSnapshot {
+        let existing = snapshot.identity(for: .codex)
+        let email = existing?.accountEmail?.trimmingCharacters(in: .whitespacesAndNewlines)
+        let resolvedEmail = (email?.isEmpty ?? true) ? account.email : email
+        let loginMethod = existing?.loginMethod ?? account.workspaceLabel
+        let identity = ProviderIdentitySnapshot(
+            providerID: .codex,
+            accountEmail: resolvedEmail,
+            accountOrganization: existing?.accountOrganization,
+            loginMethod: loginMethod)
+        return snapshot.withIdentity(identity)
+    }
+}

Sources/CodexBar/UsageStore+TokenAccounts.swift

@@ -771,6 +771,34 @@ extension UsageStore {
                 return (index, account, descriptor, context)
             }
 
+        if let delay = TokenAccountSupportCatalog.support(for: provider)?.minimumDelayBetweenAccountRefreshes {
+            var results: [TokenAccountFetchResult] = []
+            results.reserveCapacity(requests.count)
+            for request in requests {
+                if !results.isEmpty {
+                    do {
+                        try await Task.sleep(for: delay)
+                    } catch {
+                        for pending in requests.dropFirst(results.count) {
+                            results.append(TokenAccountFetchResult(
+                                index: pending.index,
+                                account: pending.account,
+                                outcome: ProviderFetchOutcome(
+                                    result: .failure(CancellationError()),
+                                    attempts: [])))
+                        }
+                        return results
+                    }
+                }
+                let outcome = await request.descriptor.fetchOutcome(context: request.context)
+                results.append(TokenAccountFetchResult(
+                    index: request.index,
+                    account: request.account,
+                    outcome: outcome))
+            }
+            return results
+        }
+
         return await withTaskGroup(
             of: TokenAccountFetchResult.self,
             returning: [TokenAccountFetchResult].self)
@@ -1588,35 +1616,4 @@ extension UsageStore {
             }
         }
     }
-
-    func applyAccountLabel(
-        _ snapshot: UsageSnapshot,
-        provider: UsageProvider,
-        account: ProviderTokenAccount) -> UsageSnapshot
-    {
-        let label = account.label.trimmingCharacters(in: .whitespacesAndNewlines)
-        guard !label.isEmpty else { return snapshot }
-        let existing = snapshot.identity(for: provider)
-        let email = existing?.accountEmail?.trimmingCharacters(in: .whitespacesAndNewlines)
-        let resolvedEmail = (email?.isEmpty ?? true) ? label : email
-        let identity = ProviderIdentitySnapshot(
-            providerID: provider,
-            accountEmail: resolvedEmail,
-            accountOrganization: existing?.accountOrganization,
-            loginMethod: existing?.loginMethod)
-        return snapshot.withIdentity(identity)
-    }
-
-    func applyCodexVisibleAccountLabel(_ snapshot: UsageSnapshot, account: CodexVisibleAccount) -> UsageSnapshot {
-        let existing = snapshot.identity(for: .codex)
-        let email = existing?.accountEmail?.trimmingCharacters(in: .whitespacesAndNewlines)
-        let resolvedEmail = (email?.isEmpty ?? true) ? account.email : email
-        let loginMethod = existing?.loginMethod ?? account.workspaceLabel
-        let identity = ProviderIdentitySnapshot(
-            providerID: .codex,
-            accountEmail: resolvedEmail,
-            accountOrganization: existing?.accountOrganization,
-            loginMethod: loginMethod)
-        return snapshot.withIdentity(identity)
-    }
 }

Sources/CodexBar/UsageStore.swift

@@ -1046,7 +1046,7 @@ extension UsageStore {
                      .copilot, .devin, .vertexai, .kilo, .kiro, .kimi, .moonshot, .jetbrains, .perplexity,
                      .mimo, .doubao, .sakana, .abacus, .mistral, .codebuff, .crof, .windsurf, .venice, .manus,
                      .commandcode, .qoder, .stepfun, .bedrock, .grok, .groq, .t3chat, .llmproxy, .litellm, .zed,
-                     .deepgram, .poe, .chutes, .clawrouter, .longcat, .wayfinder, .sub2api, .zenmux:
+                     .deepgram, .poe, .chutes, .neuralwatt, .clawrouter, .longcat, .wayfinder, .sub2api, .zenmux:
                     return unimplementedDebugLogMessages[provider] ?? "Debug log not yet implemented"
                 }
             }

Sources/CodexBarCLI/CLIDiagnoseCommand.swift

@@ -243,6 +243,8 @@ extension CodexBarCLI {
             KiloSettingsReader.apiKey(environment: environment) != nil
         case .factory:
             FactorySettingsReader.apiKey(environment: environment) != nil
+        case .neuralwatt:
+            NeuralWattSettingsReader.apiKey(environment: environment) != nil
         default:
             false
         }

Sources/CodexBarCLI/CLIUsageCommand.swift

@@ -232,7 +232,16 @@ extension CodexBarCLI {
 
         let selections = Self.accountSelections(from: accounts)
         var output = UsageCommandOutput()
-        for account in selections {
+        let accountRefreshDelay = TokenAccountSupportCatalog
+            .support(for: provider)?.minimumDelayBetweenAccountRefreshes
+        for (index, account) in selections.enumerated() {
+            if index > 0, let accountRefreshDelay {
+                do {
+                    try await Task.sleep(for: accountRefreshDelay)
+                } catch {
+                    return output
+                }
+            }
             let result = await Self.fetchUsageOutput(
                 provider: provider,
                 account: account,

Sources/CodexBarCore/Config/ProviderConfigEnvironment.swift

@@ -185,7 +185,7 @@ public enum ProviderConfigEnvironment {
             GroqSettingsReader.apiKeyEnvironmentKey
         case .llmproxy:
             LLMProxySettingsReader.apiKeyEnvironmentKey
-        case .chutes, .poe, .litellm, .clawrouter, .factory, .sub2api, .zenmux:
+        case .chutes, .poe, .litellm, .clawrouter, .factory, .sub2api, .neuralwatt, .zenmux:
             self.additionalAPIKeyEnvironmentKey(for: provider)
         default:
             nil
@@ -204,6 +204,8 @@ public enum ProviderConfigEnvironment {
             ClawRouterSettingsReader.apiKeyEnvironmentKey
         case .sub2api:
             Sub2APISettingsReader.apiKeyEnvironmentKey
+        case .neuralwatt:
+            NeuralWattSettingsReader.apiKeyEnvironmentKey
         case .factory:
             FactorySettingsReader.apiTokenKey
         case .zenmux:

Sources/CodexBarCore/Generated/CodexParserHash.generated.swift

@@ -1,5 +1,5 @@
 // Generated by Scripts/regenerate-codex-parser-hash.sh. Do not edit by hand.
 
 enum CodexParserHash {
-    static let value = "8be945d1c2519e9b"
+    static let value = "168d4b6df03755cb"
 }

Sources/CodexBarCore/Logging/LogCategories.swift

@@ -59,6 +59,7 @@ public enum LogCategories {
     public static let minimaxWeb = "minimax-web"
     public static let mimoCookie = "mimo-cookie"
     public static let moonshotUsage = "moonshot-usage"
+    public static let neuralWattUsage = "neuralwatt-usage"
     public static let notifications = "notifications"
     public static let openAIWeb = "openai-web"
     public static let openAIWebview = "openai-webview"

Sources/CodexBarCore/Providers/NeuralWatt/NeuralWattProviderDescriptor.swift

@@ -0,0 +1,50 @@
+import Foundation
+
+public enum NeuralWattProviderDescriptor {
+    public static let descriptor: ProviderDescriptor = Self.makeDescriptor()
+
+    static func makeDescriptor() -> ProviderDescriptor {
+        ProviderDescriptor(
+            id: .neuralwatt,
+            metadata: ProviderMetadata(
+                id: .neuralwatt,
+                displayName: "Neuralwatt",
+                sessionLabel: "Subscription",
+                weeklyLabel: "Key allowance",
+                opusLabel: nil,
+                supportsOpus: false,
+                supportsCredits: false,
+                creditsHint: "Subscription kWh and prepaid USD balance.",
+                toggleTitle: "Show Neuralwatt usage",
+                cliName: "neuralwatt",
+                defaultEnabled: false,
+                isPrimaryProvider: false,
+                usesAccountFallback: false,
+                browserCookieOrder: nil,
+                dashboardURL: "https://portal.neuralwatt.com/dashboard",
+                subscriptionDashboardURL: "https://portal.neuralwatt.com/dashboard",
+                changelogURL: nil,
+                statusPageURL: nil,
+                statusLinkURL: nil),
+            branding: ProviderBranding(
+                iconStyle: .neuralwatt,
+                iconResourceName: "ProviderIcon-neuralwatt",
+                color: ProviderColor(red: 0.22, green: 0.85, blue: 0.55)),
+            tokenCost: ProviderTokenCostConfig(
+                supportsTokenCost: false,
+                noDataMessage: { "Neuralwatt token cost history is not available via the quota API." }),
+            fetchPlan: .apiToken(
+                strategyID: "neuralwatt.api",
+                resolveToken: { ProviderTokenResolver.neuralWattToken(environment: $0) },
+                missingCredentialsError: { NeuralWattUsageError.missingCredentials },
+                loadUsage: { apiKey, context in
+                    try await NeuralWattUsageFetcher.fetchUsage(
+                        apiKey: apiKey,
+                        environment: context.env).toUsageSnapshot()
+                }),
+            cli: ProviderCLIConfig(
+                name: "neuralwatt",
+                aliases: ["nw", "neural"],
+                versionDetector: nil))
+    }
+}