# CodexBar | Peter Steinberger | Knowledge Base | Instagit

Show usage stats for OpenAI Codex and Claude Code, without having to login.

GitHub Stars: 16.9k

Repository: https://github.com/steipete/CodexBar

---

## Articles

### [How to Get Decoded Barcode Data from CodexBar: A Complete Guide](/steipete/CodexBar/how-to-get-the-decoded-barcode-data-from-codexbar)

Access decoded barcode data from CodexBar using the BarcodeScanner.decode method. This guide shows how to extract raw string data from QR codes with Apple's Vision framework.

- Tags: how-to-guide
- Published: 2026-07-10

### [CodexBar Memory Requirements: How Much RAM Does the Menu Bar App Need?](/steipete/CodexBar/what-are-the-memory-requirements-for-running-codexbar)

Discover CodexBar memory requirements! This macOS menu bar app uses minimal RAM, typically under 100MB and often 30-50MB, thanks to efficient in-memory caching.

- Tags: deep-dive
- Published: 2026-07-10

### [Can CodexBar Scan Barcodes from Images Not Captured Live? A Complete Source Code Analysis](/steipete/CodexBar/can-codexbar-scan-barcodes-from-images-not-captured-live)

Discover if CodexBar scans barcodes from static images. Analyze source code to understand its limitations with image processing and barcode detection capabilities.

- Tags: deep-dive
- Published: 2026-07-10

### [How to Improve Barcode Scanning Accuracy with CodexBar: A Vision Framework Guide](/steipete/CodexBar/how-to-improve-barcode-scanning-accuracy-with-codexbar)

Boost barcode scanning accuracy with CodexBar by integrating Apple Vision VNDetectBarcodesRequest and image pre-processing. Learn how to enhance contrast and convert to grayscale for better results.

- Tags: how-to-guide
- Published: 2026-07-10

### [What Algorithms Does CodexBar Use for Barcode Recognition?](/steipete/CodexBar/what-are-the-underlying-algorithms-used-by-codexbar-for-barcode-recognition)

Discover CodexBar: a macOS utility for monitoring AI provider usage. Learn how it analyzes costs and quotas by parsing log files and scanning SQLite tables. No barcode recognition algorithms involved.

- Tags: internals
- Published: 2026-07-10

### [How to Use CodexBar for Batch Processing Provider Usage Data](/steipete/CodexBar/how-to-use-codexbar-for-batch-processing-barcodes)

Learn to batch process AI coding provider usage with CodexBar. Aggregate quota data via API calls and view it in a unified interface. Works with steipete/CodexBar.

- Tags: how-to-guide
- Published: 2026-07-10

### [How to Contribute to the CodexBar Project: A Complete Developer's Guide](/steipete/CodexBar/how-to-contribute-to-the-codexbar-project)

Learn how to contribute to the CodexBar project. Follow this developer's guide to fork the repo, implement changes, and submit your pull request.

- Tags: how-to-guide
- Published: 2026-07-10

### [CodexBar Performance Characteristics: A Deep Dive into the macOS Menu Bar Architecture](/steipete/CodexBar/what-are-the-performance-characteristics-of-codexbar)

Explore CodexBar's performance. Discover sub-10ms UI latency & adaptive background refresh via O(1) scheduling, GPU highlighting, JSONL scanning & zero-cost logging.

- Tags: performance
- Published: 2026-07-10

### [How to Test CodexBar Functionality: Unit and Integration Testing Guide](/steipete/CodexBar/how-to-test-codexbar-functionality)

Learn to test CodexBar functionality effectively with our guide on unit and integration testing. Discover strategies for logic validation and app verification for the steipete/CodexBar repository.

- Tags: testing
- Published: 2026-07-10

### [How to Handle Errors in CodexBar Scanning: A Type-Driven Approach](/steipete/CodexBar/how-to-handle-errors-in-codexbar-scanning)

Master CodexBar scanning error handling with localized enums and centralized orchestration via ProviderFetchPlan for robust AI data aggregation. Learn how to manage errors effectively.

- Tags: how-to-guide
- Published: 2026-07-10

### [How to Customize the Appearance of CodexBar's UI: A SwiftUI Guide](/steipete/CodexBar/how-to-customize-the-appearance-of-codexbars-ui)

Customize CodexBar's UI appearance effortlessly. Modify BurnTheme for colors, adapt to dark mode with colorScheme, and adjust settings layouts in PreferencesView and PreferencesSidebar.

- Tags: tutorial
- Published: 2026-07-10

### [CodexBar Configuration Options: Complete Guide to JSON Settings and CLI Commands](/steipete/CodexBar/what-are-the-configuration-options-for-codexbar)

Explore CodexBar configuration options with our guide to JSON settings and CLI commands. Manage API keys, hosts, auth, and tokens for seamless Codium and GitHub integration.

- Tags: complete-guide
- Published: 2026-07-10

### [How to Integrate CodexBar into an Android Application: A Complete Guide](/steipete/CodexBar/how-to-integrate-codexbar-into-an-android-application)

Integrate CodexBar into your Android app by running its macOS CLI HTTP server. This guide shows you how to query the JSON endpoint from Android using OkHttp for seamless barcode scanning.

- Tags: how-to-guide
- Published: 2026-07-10

### [Does CodexBar Support Barcode Scanning? Understanding Usage Data Scanning](/steipete/CodexBar/how-does-codexbar-handle-barcode-scanning)

CodexBar usage data scanning reads log files and databases, not visual barcodes. Learn how CodexBar processes AI provider records for analysis.

- Tags: how-to-guide
- Published: 2026-07-10

### [CodexBar Architecture: A Deep Dive into the Swift 6 Modular Design](/steipete/CodexBar/what-is-the-architecture-of-codexbar)

Explore the CodexBar architecture, a modular Swift 6 design using Core UI and CLI packages. Discover its layered approach, concurrency, and dependency injection for separated data and presentation.

- Tags: architecture
- Published: 2026-07-10

### [CodexBar Dependencies: Complete Guide to Third-Party Libraries and Frameworks](/steipete/CodexBar/what-are-the-main-dependencies-for-codexbar)

Explore essential CodexBar dependencies, including Sparkle, swift-argument-parser, and Swift Crypto. Understand the third-party libraries powering this project's CLI and update features.

- Tags: tutorial
- Published: 2026-07-10

### [What Programming Language Is CodexBar Written In? Swift 6 Architecture Explained](/steipete/CodexBar/what-programming-language-is-codexbar-written-in)

Discover CodexBar! This Swift 6 application leverages the swift-tools-version 6.2 package and strict concurrency for robust performance. Learn about its architecture.

- Tags: architecture
- Published: 2026-07-10

### [CodexBar Refresh Loop Timing and Error Recovery: A Deep Dive into AdaptiveRefreshPolicy](/steipete/CodexBar/codexbar-refresh-loop-timing-error-recovery)

Understand CodexBar refresh loop timing with AdaptiveRefreshPolicy and error recovery using exponential back-off. Learn how CodexBar optimizes performance based on usage patterns.

- Tags: deep-dive
- Published: 2026-07-08

### [OpenAI Dashboard Web Scraping Architecture in CodexBar: A 4-Layer Approach](/steipete/CodexBar/codexbar-openai-dashboard-web-scraping-architecture)

Discover CodexBar's 4-layer architecture for OpenAI dashboard web scraping. Learn how it isolates cookies, reuses WebViews, runs JS, and parses results into Swift models.

- Tags: architecture
- Published: 2026-07-08

### [Security Implications of Storing API Keys in CodexBar: Risks and Mitigations](/steipete/CodexBar/codexbar-security-api-key-storage)

Discover the security risks of storing API keys in CodexBar. Learn how plaintext storage in memory exposes keys and explore essential mitigation strategies to protect your sensitive data.

- Tags: deep-dive
- Published: 2026-07-08

### [How CodexBar's Settings Persistence System Works with Configuration Files](/steipete/CodexBar/codexbar-settings-persistence-config-files)

Discover how CodexBar's settings persistence uses UserDefaults and JSON files. Learn about its dual-layer architecture for storing preferences and configurations.

- Tags: internals
- Published: 2026-07-08

### [How to Use the CodexBar Serve HTTP API for External Integrations](/steipete/CodexBar/use-codexbar-serve-http-api-external-integrations)

Integrate externally with CodexBar using its serve HTTP API. Query usage data and trigger refreshes via local JSON endpoints bound to localhost. Streamline your workflows today.

- Tags: how-to-guide
- Published: 2026-07-08

### [Menu Bar Icon Rendering System Architecture in CodexBar: A Deep Dive](/steipete/CodexBar/codexbar-menubar-icon-rendering-architecture)

Explore the three-layer architecture of CodexBar's menu bar icon rendering system. Discover state management, observation coordination, and template-based image composition.

- Tags: architecture
- Published: 2026-07-08

### [How CodexBar's Status Polling System Detects Provider Incidents](/steipete/CodexBar/codexbar-status-polling-provider-incidents)

Learn how CodexBar's status polling system detects provider incidents using a hierarchical fallback strategy across Incident.io Statuspage.io and Google Workspace to display the most severe outage.

- Tags: internals
- Published: 2026-07-08

### [How CodexBar's Keychain Access System Retrieves Browser Cookies on macOS](/steipete/CodexBar/codexbar-keychain-browser-cookies)

Learn how CodexBar retrieves browser cookies on macOS. It accesses Keychain, decrypts your AES-256-GCM protected database, and caches HTTP headers for quick reuse.

- Tags: internals
- Published: 2026-07-08

### [How the Cost Usage Scanner Enables Local Token Tracking in CodexBar](/steipete/CodexBar/codexbar-cost-usage-scanner-local-tokens)

Learn how the CodexBar cost usage scanner transforms logs into daily cost snapshots for real-time local token tracking without external network calls. Optimize your API spending.

- Tags: internals
- Published: 2026-07-08

### [How to Troubleshoot and Debug Provider Fetch Failures in CodexBar](/steipete/CodexBar/debug-codexbar-provider-fetch-failures)

Troubleshoot provider fetch failures in CodexBar by enabling debug logging, running diagnose, and inspecting provider implementations. Fix credential issues and network problems fast.

- Tags: how-to-guide
- Published: 2026-07-08

### [How UsageStore Manages State and Refresh Cycles in CodexBar](/steipete/CodexBar/codexbar-usagestore-state-refresh)

Discover how UsageStore in CodexBar manages state and refresh cycles. Explore its adaptive timers and coalesced network requests for efficient data aggregation.

- Tags: internals
- Published: 2026-07-08

### [How to Add a Custom Provider to CodexBar: A 3-Step Integration Guide](/steipete/CodexBar/add-custom-provider-codexbar)

Integrate a custom provider into CodexBar easily. Follow our 3-step guide to define JSON, register your ID, and implement a secure CustomHTTPJSONFetcher for seamless integration.

- Tags: how-to-guide
- Published: 2026-07-08

### [CodexBar Provider System Architecture: A Deep Dive into the Multi-Layer Design](/steipete/CodexBar/codexbar-provider-architecture-internal)

Explore the five-layer CodexBar provider architecture. Understand how UsageProvider, ProviderDescriptor, ProviderImplementation, ProviderFetchPlan, and ProviderRuntime unify AI services like OpenAI, Claude, and Gemini.

- Tags: architecture
- Published: 2026-07-08

### [CodexBar Dependencies: Complete Guide to Swift Packages and Frameworks](/steipete/CodexBar/codexbar-dependencies)

Discover CodexBar dependencies and explore its Swift packages & frameworks. Learn about Sparkle, swift-argument-parser, swift-crypto, swift-log, AppKit, and SwiftUI integration.

- Tags: getting-started
- Published: 2026-07-07

### [How to Get Support for CodexBar: A Privacy-Preserving Troubleshooting Guide](/steipete/CodexBar/how-to-get-support-for-codexbar)

Get expert support for CodexBar by gathering app details, checking processes, and documenting Keychain prompts. Submit a privacy-preserving GitHub issue quickly.

- Tags: how-to-guide
- Published: 2026-07-07

### [CodexBar Development Goals: Real-Time AI Monitoring Through Privacy-First macOS Architecture](/steipete/CodexBar/codexbar-development-goals)

Explore CodexBar development goals: gain real-time AI monitoring with a privacy-first macOS app. Understand rate limits and automate tasks effortlessly.

- Tags: architecture
- Published: 2026-07-07

### [CodexBar API: How to Programmatically Access Usage Data via Swift and CLI](/steipete/CodexBar/is-there-an-api-for-codexbar)

Access CodexBar usage data programmatically using Swift and the CLI. Integrate this powerful API into your macOS apps and automation scripts for seamless data insights.

- Tags: api-reference
- Published: 2026-07-07

### [How to Troubleshoot Common CodexBar Issues: Swift Menu-Bar Debugging Guide](/steipete/CodexBar/how-to-troubleshoot-codexbar-issues)

Troubleshoot common CodexBar issues with this Swift menu-bar debugging guide. Verify processes, inspect logs, and check UsageStore for errors. Get your CodexBar working smoothly.

- Tags: how-to-guide
- Published: 2026-07-07

### [What Kind of Output Does CodexBar Generate?](/steipete/CodexBar/what-output-does-codexbar-generate)

Discover the real-time AI data CodexBar displays. Get insights into usage metrics, credit balances, cost estimates, and dynamic status icons in a native macOS menu-bar interface.

- Tags: getting-started
- Published: 2026-07-07

### [How to Use CodexBar with Specific IDEs: JetBrains Configuration Guide](/steipete/CodexBar/how-to-use-codexbar-with-ides)

Learn how to use CodexBar with JetBrains IDEs. This guide details configuration to display AI Assistant quota usage in your macOS menu bar.

- Tags: how-to-guide
- Published: 2026-07-07

### [Does CodexBar Have a GUI or Is It CLI Only? Complete Interface Guide](/steipete/CodexBar/codexbar-gui-or-cli-only)

CodexBar offers both a macOS GUI and a CLI for monitoring AI coding usage. Access features via a visual menu bar or terminal commands for ultimate flexibility.

- Tags: how-to-guide
- Published: 2026-07-07

### [What Is the License for CodexBar? MIT License Explained](/steipete/CodexBar/what-is-the-license-for-codexbar)

Discover what the MIT License for CodexBar means. Use, modify, and distribute CodexBar freely for commercial or non-commercial projects with this permissive open-source license.

- Tags: getting-started
- Published: 2026-07-07

### [How to Contribute to CodexBar: A Complete Guide for macOS Developers](/steipete/CodexBar/how-to-contribute-to-codexbar-project)

macOS developers learn how to contribute to CodexBar. Fork the repo, add features, run validations, and submit a clean pull request. Follow Swift 6 standards.

- Tags: how-to-guide
- Published: 2026-07-07

### [Where to Report Bugs for CodexBar: The Complete GitHub Issues Guide](/steipete/CodexBar/where-to-report-bugs-for-codexbar)

Report CodexBar bugs effectively using the GitHub Issues tracker. Learn how to submit bug reports and get faster resolutions by following our comprehensive guide.

- Tags: how-to-guide
- Published: 2026-07-07

### [How to Update steipete/CodexBar: Build, Sign, and Release Workflow](/steipete/CodexBar/how-to-update-steipete-codexbar)

Learn how to update steipete/CodexBar by pulling the latest SwiftPM source, updating version strings, and running the release script to build, sign, and notarize. Publish your GitHub release.

- Tags: how-to-guide
- Published: 2026-07-07

### [CodexBar Command-Line Arguments: Complete CLI Reference for the codexbar Tool](/steipete/CodexBar/codexbar-command-line-arguments)

Explore the CodexBar command-line arguments for the codexbar tool. This complete CLI reference details flags for logging, provider selection, JSON output, and more.

- Tags: api-reference
- Published: 2026-07-07

### [How to Integrate CodexBar into Your Workflow: A Complete Guide](/steipete/CodexBar/how-to-integrate-codexbar-into-workflow)

Integrate CodexBar into your workflow with our guide. Install the macOS app or CLI, configure AI providers, and access usage data easily. Streamline your coding now.

- Tags: how-to-guide
- Published: 2026-07-07

### [CodexBar Performance: How the macOS Menu Bar Utility Achieves Sub-10ms UI Response and Adaptive Refresh](/steipete/CodexBar/codexbar-performance)

Discover CodexBar performance: achieve sub-10ms UI response with GPU acceleration and efficient JSONL scanning. Optimize your macOS menu bar.

- Tags: performance
- Published: 2026-07-07

### [What Programming Languages Does CodexBar Support?](/steipete/CodexBar/codexbar-supported-programming-languages)

Discover the extensive programming language support in CodexBar. It works with any language your LLM provider supports, like Python, JavaScript, Java, C++, and more. Learn about its flexible capabilities.

- Tags: api-reference
- Published: 2026-07-07

### [How to Customize CodexBar: Complete Settings and Configuration Guide](/steipete/CodexBar/can-codexbar-be-customized)

Customize CodexBar fully using SettingsStore App Group UserDefaults and SwiftUI. Our guide explains all settings and configurations for this menu-bar app.

- Tags: how-to-guide
- Published: 2026-07-07

### [How to Enable or Disable Features in CodexBar: Provider Flags and User Preferences](/steipete/CodexBar/how-to-enable-disable-codexbar-features)

Learn how to enable or disable features in CodexBar. Explore provider flags and user preferences for seamless control over your extension's functionality.

- Tags: how-to-guide
- Published: 2026-07-07

### [CodexBar Configuration Options: Complete JSON Schema and CLI Reference](/steipete/CodexBar/codexbar-configuration-options)

Explore CodexBar configuration options with our complete JSON schema and CLI reference. Manage settings easily with environment variables and API credentials.

- Tags: api-reference
- Published: 2026-07-07

### [How to Configure CodexBar Settings: A Complete Guide to SettingsStore and Config Persistence](/steipete/CodexBar/how-to-configure-codexbar-settings)

Configure CodexBar settings effectively using SettingsStore. Learn how to manage UI preferences and provider configurations with automatic persistence for the steipete/CodexBar repository.

- Tags: how-to-guide
- Published: 2026-07-07

### [CodexBar System Requirements: macOS Compatibility and Build Prerequisites](/steipete/CodexBar/codexbar-system-requirements)

Discover CodexBar system requirements including macOS 13 Ventura compatibility Xcode 15 Swift 6 support and native performance on Apple Silicon and Intel Macs.

- Tags: getting-started
- Published: 2026-07-07

### [How to Install steipete/CodexBar on macOS and Linux](/steipete/CodexBar/how-to-install-steipete-codexbar)

Install steipete CodexBar on macOS and Linux using Homebrew Cask, GitHub releases, or the CLI helper. Get started with CodexBar quickly and easily.

- Tags: how-to-guide
- Published: 2026-07-07

### [How the Claude Web Probe Captures Usage Data from claude.ai](/steipete/CodexBar/how-claude-web-probe-capture-usage-claude-ai)

Discover how the Claude Web Probe captures claude.ai usage data by extracting session keys, calling the API for usage stats, and parsing JSON responses into structured rate-limit information.

- Tags: how-to-guide
- Published: 2026-07-07

### [Cross-Platform Differences for CodexBar CLI Builds: macOS vs Linux Guide](/steipete/CodexBar/what-cross-platform-differences-codexbar-cli-builds)

Discover cross-platform differences for CodexBar CLI builds between macOS and Linux. Learn about packaging, installation, and feature variations. Essential guide from steipete/CodexBar.

- Tags: how-to-guide
- Published: 2026-07-07

### [How to Integrate SwiftUI with CodexBar's Menu Bar: A Complete Guide](/steipete/CodexBar/how-integrate-swiftui-codexbar-menu-bar)

Learn to integrate SwiftUI with CodexBar's menu bar using NSHostingView and StatusItemController. This guide simplifies bridging AppKit and SwiftUI for a seamless menu bar experience.

- Tags: how-to-guide
- Published: 2026-07-07

### [How CodexBar Handles Credentials On-Device for Privacy: Secure Keychain Architecture](/steipete/CodexBar/how-codexbar-handle-credentials-on-device-privacy)

Discover how CodexBar secures API keys and tokens on-device using macOS Keychain. Learn about its restricted access controls and automatic storage disabling for enhanced privacy.

- Tags: architecture
- Published: 2026-07-07

### [How CodexBar Imports Browser Cookies for Authentication](/steipete/CodexBar/how-codexbar-import-browser-cookies-authentication)

Learn how CodexBar seamlessly imports authentication cookies from popular browsers like Chrome and Edge via SQLite. Securely stores them in the macOS keychain for effortless LLM provider requests.

- Tags: how-to-guide
- Published: 2026-07-07

### [How the CodexBar Provider Switcher UI Works: Architecture and Implementation](/steipete/CodexBar/how-codexbar-provider-switcher-ui-work)

Explore the CodexBar provider switcher UI architecture and implementation. Learn how it handles input and avoids re-entrancy bugs for a seamless user experience.

- Tags: architecture
- Published: 2026-07-07

### [What Is Merge Icons Mode in CodexBar? A Deep Dive into Menu Bar Consolidation](/steipete/CodexBar/what-merge-icons-mode-codexbar)

Discover Merge Icons Mode in CodexBar to simplify your menu bar. Consolidate AI provider statuses with this deep dive into efficient menu bar consolidation.

- Tags: deep-dive
- Published: 2026-07-07

### [How CodexBar Detects and Displays Provider Incidents: Architecture and Implementation](/steipete/CodexBar/how-codexbar-detect-display-provider-incidents)

Discover how CodexBar detects LLM provider incidents by polling status pages, normalizing data, and displaying real-time health in your macOS menu bar. Learn the architecture.

- Tags: architecture
- Published: 2026-07-07

### [How to Set Up OAuth for AI Providers in CodexBar: A Complete Configuration Guide](/steipete/CodexBar/how-setup-oauth-ai-providers-codexbar)

Configure OAuth for AI providers like Codex, Claude, Gemini, and Vertex AI in CodexBar. This guide details credential management and token refreshing for seamless AI integration.

- Tags: how-to-guide
- Published: 2026-07-07

### [How CodexBar Scans for Codex and Claude Cost Usage: A Technical Deep Dive](/steipete/CodexBar/how-codexbar-scan-codex-claude-cost-usage)

Learn how CodexBar scans Codex and Claude cost usage with its layered pipeline. Discover data aggregation and unified token snapshots to manage your AI expenses effectively.

- Tags: deep-dive
- Published: 2026-07-07

### [How to Configure API Keys for CodexBar Using the CLI](/steipete/CodexBar/how-configure-api-keys-codexbar-cli)

Securely set CodexBar API keys with the CLI. Learn to use the set-api-key command with provider and API key flags or stdin for enhanced security.

- Tags: how-to-guide
- Published: 2026-07-07

### [How KeychainAccessGate Prevents macOS Keychain Prompts in CodexBar](/steipete/CodexBar/how-keychainaccessgate-prevent-macos-keychain-prompts)

Learn how CodexBar's KeychainAccessGate prevents macOS keychain prompts by performing safety checks before any dialog appears. Streamline your workflow with enhanced security and control.

- Tags: internals
- Published: 2026-07-07

### [How to Add a New AI Provider to CodexBar: A Complete Implementation Guide](/steipete/CodexBar/how-add-new-ai-provider-codexbar)

Learn how to add a new AI provider to CodexBar. This guide covers enum declaration, provider registration, and implementation for runtime logic and UI.

- Tags: how-to-guide
- Published: 2026-07-07

### [ProviderEnvironmentResolver in CodexBar: Environment Variable Resolution for LLM Providers](/steipete/CodexBar/what-providerenvironmentresolver-codexbar)

Discover the ProviderEnvironmentResolver in CodexBar. This Swift utility efficiently merges system environment, provider settings, and account tokens for LLM provider requests.

- Tags: internals
- Published: 2026-07-07

### [How CodexBar Manages Multi-Provider Account Authentication](/steipete/CodexBar/how-codexbar-manage-multi-provider-authentication)

Discover how CodexBar handles multi-provider account authentication by storing credentials in a single JSON file using FileTokenAccountStore and TokenAccountSupport for efficient management.

- Tags: how-to-guide
- Published: 2026-07-07