# An xbar plugin that displays your current Claude Code usage on your Mac's toolbar

> Source: <https://gist.github.com/preslavrachev/61aa5ea90d28bcb489f65d072f9f2d94>
> Published: 2025-07-18 07:38:49+00:00

claude_tokens.5m.py

      This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
      
Learn more about bidirectional Unicode characters

 
    Show hidden characters

#!/usr/bin/env python3

# <xbar.title>Claude Token Usage</xbar.title>

# <xbar.version>v1.0</xbar.version>

# <xbar.author>Preslav Rachev</xbar.author>

# <xbar.desc>Shows today's Claude Code token usage in the Mac toolbar</xbar.desc>

import json

import subprocess

import os

import glob

from datetime import datetime

from typing import Any

def format_number(num):

    """Formats a number into a human-readable string with K/M suffixes."""

    if num >= 1000000:

        return f"{num / 1000000:.1f}M"

    if num >= 1000:

        return f"{num / 1000:.1f}K"

    return str(num)

def get_ccusage_data() -> dict[str, Any]:

    """Fetches Claude Code usage statistics using the `npx ccusage@latest -j` command."""

    try:

        # Set up environment with common paths for xbar

        env = os.environ.copy()

        # Add common Node.js paths to ensure npx is found

        common_paths = [

            "/usr/local/bin",

            "/usr/bin",

            "/bin",

            "/opt/homebrew/bin",  # Homebrew on Apple Silicon

            os.path.expanduser("~/.nvm/versions/node/*/bin"),  # NVM paths

            os.path.expanduser("~/node_modules/.bin"),  # Local node modules

        ]

        # Expand glob patterns and filter existing paths

        expanded_paths = []

        for path in common_paths:

            if "*" in path:

                expanded_paths.extend(glob.glob(path))

            elif os.path.exists(path):

                expanded_paths.append(path)

        # Add to PATH if not already present

        current_path = env.get("PATH", "")

        for path in expanded_paths:

            if path not in current_path:

                current_path = f"{path}:{current_path}"

        env["PATH"] = current_path

        # Try running npx from PATH

        result = subprocess.run(

            ["npx", "ccusage@latest", "-j"],

            capture_output=True,

            text=True,

            timeout=30,

            check=False,

            env=env,

        )

        if result.returncode == 0:

            return json.loads(result.stdout)

        return {

            "error": f"Command failed with code {result.returncode}",

            "stderr": result.stderr,

            "stdout": result.stdout,

        }

    except subprocess.TimeoutExpired:

        return {"error": "Command timed out after 30 seconds"}

    except json.JSONDecodeError as e:

        return {"error": f"JSON decode error: {e}", "stdout": result.stdout}

    except FileNotFoundError:

        return {"error": "npx command not found - Node.js may not be installed"}

def main():

    """Main function to fetch and display Claude Code usage statistics."""

    # Get today's date in YYYY-MM-DD format

    today = datetime.now().strftime("%Y-%m-%d")

    # Get usage data

    data = get_ccusage_data()

    if not data or (isinstance(data, dict) and "error" in data):

        print("⚠️ Error")

        print("---")

        if isinstance(data, dict) and "error" in data:

            print(f"Error: {data['error']}")

            if "stderr" in data:

                print(f"Stderr: {data['stderr']}")

            if "stdout" in data:

                print(f"Stdout: {data['stdout']}")

        else:

            print("Failed to fetch usage data")

        return

    # Find today's usage

    today_usage = None

    for day in data.get("daily", []):

        if day.get("date") == today:

            today_usage = day

            break

    if not today_usage:

        print("📊 0 tokens")

        print("---")

        print("No usage today")

        return

    # Display today's token count in toolbar

    total_tokens = today_usage.get("totalTokens", 0)

    total_cost = today_usage.get("totalCost", 0)

    print(f"📊 {format_number(total_tokens)}")

    print("---")

    print(f"Today's Usage ({today})")

    print(f"Total Tokens: {format_number(total_tokens)}")

    print(f"Input: {format_number(today_usage.get('inputTokens', 0))}")

    print(f"Output: {format_number(today_usage.get('outputTokens', 0))}")

    print(f"Cache Creation: {format_number(today_usage.get('cacheCreationTokens', 0))}")

    print(f"Cache Read: {format_number(today_usage.get('cacheReadTokens', 0))}")

    print(f"Cost: ${total_cost:.2f}")

    print("---")

    # Show total usage

    totals = data.get("totals", {})

    print("Total Usage (All Time)")

    print(f"Total Tokens: {format_number(totals.get('totalTokens', 0))}")

    print(f"Total Cost: ${totals.get('totalCost', 0):.2f}")

if __name__ == "__main__":

    main()