Alle KI-Quoten
im Blick. Immer. All AI Quotas
at a Glance.

⚙️ Konfiguration⚙️ Configuration

Clawbar liest eine einzige JSON-Konfigurationsdatei für App und CLI. Secrets werden mit Dateiberechtigung 0600 geschützt.Clawbar reads a single JSON config file for both app and CLI. Secrets are protected with 0600 file permissions.

• Pfad: ~/.clawbar/config.json (Legacy-Fallback: ~/.codexbar/config.json)Path: ~/.clawbar/config.json (legacy fallback: ~/.codexbar/config.json)
• id – Provider-Identifier (z.B. claude, copilot, gemini)id – Provider identifier (e.g. claude, copilot, gemini)
• source – auto | web | cli | oauth | apisource – auto | web | cli | oauth | api
• apiKey – API-Token für direkte API-NutzungapiKey – API token for direct API usage
• enabled – Provider aktivieren/deaktivierenenabled – Enable/disable a provider
• cookieSource – auto (Browser-Import) | manual | offcookieSource – auto (browser import) | manual | off
• tokenAccounts – Multi-Account-Konfiguration mit label, token, activeIndextokenAccounts – Multi-account config with label, token, activeIndex
• Die Reihenfolge der providers-Array bestimmt die Anzeigereihenfolge in App und CLI.The order of the providers array controls display order in the app and CLI.

{
  "version": 1,
  "providers": [
    { "id": "claude", "source": "oauth" },
    { "id": "copilot", "source": "api" },
    { "id": "openrouter", "apiKey": "sk-or-..." }
  ]
}

💻 CLI Referenz💻 CLI Reference

Der clawbar CLI spiegelt alle App-Daten für Skripte, CI und Dashboards. Unterstützt JSON-Ausgabe, Multi-Account und alle Provider.The clawbar CLI mirrors all app data for scripts, CI, and dashboards. Supports JSON output, multi-account, and all providers.

• clawbar usage [--provider <id>] – Quota-Nutzung abfragenQuery quota usage
• clawbar cost [--provider <id>] – Lokale Token-Kosten (30 Tage)Local token costs (30 days)
• clawbar models --provider theclawbay – Verfügbare ModelleAvailable models
• clawbar config validate – Config-Datei validierenValidate config file
• clawbar config dump – Normalisierte Config ausgebenOutput normalized config
• --format json --pretty – JSON-Ausgabe für SkripteJSON output for scripts
• --source auto|web|cli|oauth|api – Authentifizierungsmethode wählenChoose authentication method
• --account <label> / --all-accounts – Multi-Account-SelektionMulti-account selection
• --no-color, --verbose, --status – Globale FlagsGlobal flags

Exit Codes: 0 = Erfolg · 2 = Provider fehlt · 3 = Parse-Fehler · 4 = CLI-Timeout · 1 = Unerwarteter FehlerExit codes: 0 = success · 2 = provider missing · 3 = parse error · 4 = CLI timeout · 1 = unexpected failure

🔌 Provider-Dokumentation🔌 Provider Documentation

Clawbar unterstützt 24 KI-Provider mit verschiedenen Authentifizierungsstrategien. Jeder Provider hat eine eigene Dokumentationsdatei im docs/ Verzeichnis.Clawbar supports 24 AI providers with different authentication strategies. Each provider has its own documentation file in the docs/ directory.

• API: GitHub Copilot, OpenRouter, Kilo, Kimi, Kimi K2, z.ai, Perplexity, Warp, Gemini, TheClawBayGitHub Copilot, OpenRouter, Kilo, Kimi, Kimi K2, z.ai, Perplexity, Warp, Gemini, TheClawBay
• OAuth: Claude (Anthropic), Vertex AIClaude (Anthropic), Vertex AI
• Web / Cookies: Codex, Cursor, Factory/Droid, MiniMax, Augment, Amp, Alibaba Cloud, OllamaCodex, Cursor, Factory/Droid, MiniMax, Augment, Amp, Alibaba Cloud, Ollama
• CLI: Kiro
• Local: Antigravity, JetBrains AI, SyntheticAntigravity, JetBrains AI, Synthetic

Cookie-basierte Provider (Codex, Cursor, etc.) unterstützen automatischen Browser-Cookie-Import (Safari, Chrome, Firefox) oder manuellen Cookie-Header. Cookies werden im Keychain gecacht.Cookie-based providers (Codex, Cursor, etc.) support automatic browser cookie import (Safari, Chrome, Firefox) or manual cookie header. Cookies are cached in Keychain.

🏗️ Architektur🏗️ Architecture

Clawbar ist in mehrere Swift Package Manager Module aufgeteilt. Swift 6 mit strikter Concurrency, macOS 14+ als Target.Clawbar is split into multiple Swift Package Manager modules. Swift 6 with strict concurrency, macOS 14+ as target.

• Core: Fetch + Parse (Provider-Probes, RPC, PTY, Web-Scraping, Status-Polling)Fetch + parse (provider probes, RPC, PTY, web scraping, status polling)
• App: State + UI (UsageStore, SettingsStore, StatusItemController, Menüs, Icon-Rendering)State + UI (UsageStore, SettingsStore, StatusItemController, menus, icon rendering)
• Widget: WidgetKit Extension für Notification CenterWidgetKit extension for Notification Center
• CLI: Commander-basierter CLI-Helper, gebündelt in Clawbar.app/Contents/Helpers/Commander-based CLI helper, bundled in Clawbar.app/Contents/Helpers/
• Macros: SwiftSyntax Macros für Provider-RegistrierungSwiftSyntax macros for provider registration

Datenfluss: Background Refresh → UsageFetcher/Provider-Probes → UsageStore → Menü/Icon/Widgets. Settings-Toggles beeinflussen Refresh-Kadenz und Feature-Flags.Data flow: Background refresh → UsageFetcher/provider probes → UsageStore → menu/icon/widgets. Settings toggles affect refresh cadence and feature flags.