claude-code-usage 1.0.2__py3-none-any.whl → 2.0.0__py3-none-any.whl

{claude_code_usage-1.0.2.dist-info → claude_code_usage-2.0.0.dist-info}/METADATA

@@ -1,17 +1,22 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: claude-code-usage
-Version: 1.0.2
-Summary: System tray monitor for Claude Code token usage
+Version: 2.0.0
+Summary: Cross-platform system tray monitor for Claude Code token usage
 Author: Max
 License: MIT
 Project-URL: Homepage, https://github.com/Maex-z9/CC_Usage
 Project-URL: Repository, https://github.com/Maex-z9/CC_Usage
 Project-URL: Issues, https://github.com/Maex-z9/CC_Usage/issues
-Keywords: claude,anthropic,usage,monitor,tray,gnome
+Keywords: claude,anthropic,usage,monitor,tray,cross-platform
 Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: X11 Applications :: GTK
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
@@ -20,9 +25,14 @@ Classifier: Topic :: Utilities
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: requests>=2.28.0
-Requires-Dist: PyGObject>=3.42.0
-Dynamic: license-file
+Requires-Dist: requests >=2.28.0
+Requires-Dist: pystray >=0.19.0
+Requires-Dist: Pillow >=9.0.0
+Requires-Dist: desktop-notifier >=3.5.0
+Requires-Dist: platformdirs >=3.0.0
+Requires-Dist: humanize >=4.0.0
+Provides-Extra: linux
+Requires-Dist: PyGObject >=3.42.0 ; extra == 'linux'
 
 # Claude Code Usage Overlay
 

claude_code_usage-2.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+src/__init__.py,sha256=rzeXYIMbNbWPF6gpjv7luGXLZA67r_5GU5ZGUNb8pKA,27
+src/api.py,sha256=IymlJFR7_Ou5I_Asij8oyR2b7bx9WurBtREwcysbiJQ,6168
+src/autostart.py,sha256=DJ6r0P-fuanS9bc82I3pVF1mXaXbQC3rY_JKrDs5nEY,9239
+src/config.py,sha256=fOqNm6cDA3eLigTWbLjWPpneuS3PiZekL_mITRVvrT4,5972
+src/icon_generator.py,sha256=o9Wm7MAsScarRkrskHajgLQkmmAiBcZZ3AWgxA_95LE,3955
+src/main.py,sha256=A7Ej5kqbtOYWUGSuZxx6bM-7WNimjjAs--04_kvvta0,506
+src/notifier.py,sha256=cSGlZcx8eF7VNmRVWgF156PB8bJhxflu6hbUSVhuk94,10900
+src/tray.py,sha256=IG3uH2AYBMIUdSfavCR5lMSNB0IVe7nuIcTkvPg3JSk,8403
+src/utils.py,sha256=ZqGvw-oyzHompxRMUeYT5FdJFaQ6uvoAthhu-3bPGJk,893
+claude_code_usage-2.0.0.dist-info/LICENSE,sha256=alXcUJ2-k8eqG_Amt8y9Hhlb8fT1nABafZOqWDmdzUw,1060
+claude_code_usage-2.0.0.dist-info/METADATA,sha256=5IDglmOvUTFxnPkAX-6NAA9s-94QUmnSJmEGMEY_QH4,5995
+claude_code_usage-2.0.0.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
+claude_code_usage-2.0.0.dist-info/entry_points.txt,sha256=sRUb89gemjebLTvCQVv6TJWunjYrD-i_it3A3E9bJVc,95
+claude_code_usage-2.0.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+claude_code_usage-2.0.0.dist-info/RECORD,,

{claude_code_usage-1.0.2.dist-info → claude_code_usage-2.0.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.2)
+Generator: setuptools (73.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

claude_code_usage-2.0.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+claude-usage = src.main:main
+
+[gui_scripts]
+claude-usage-gui = src.main:main

src/autostart.py

@@ -1,13 +1,24 @@
-"""Autostart management for Claude Usage Overlay."""
+"""Autostart management for Claude Usage Overlay.
+
+Cross-platform: supports Linux (.desktop), Windows (Registry), and macOS (LaunchAgent).
+"""
 
 import os
 import shutil
+import sys
 from configparser import ConfigParser
 from pathlib import Path
 
+# Detect platform
+IS_WINDOWS = sys.platform == 'win32'
+IS_MACOS = sys.platform == 'darwin'
+IS_LINUX = sys.platform.startswith('linux')
 
-def get_autostart_path() -> Path:
-    """Get XDG-compliant autostart directory path.
+
+# --- Linux .desktop file support ---
+
+def _get_linux_autostart_path() -> Path:
+    """Get XDG-compliant autostart directory path for Linux.
 
     Returns:
         Path: Path to autostart directory
@@ -24,49 +35,52 @@ def get_autostart_path() -> Path:
     return autostart_dir
 
 
-def get_desktop_file_path() -> Path:
-    """Get path to the .desktop file.
+def _get_linux_desktop_file_path() -> Path:
+    """Get path to the Linux .desktop file.
 
     Returns:
         Path: Path to claude-usage-overlay.desktop
     """
-    return get_autostart_path() / 'claude-usage-overlay.desktop'
+    return _get_linux_autostart_path() / 'claude-usage-overlay.desktop'
 
 
 def _get_exec_command() -> str:
-    """Determine the best Exec command for the .desktop file.
+    """Determine the best Exec command for autostart.
 
     Returns:
-        Command string for Exec= line, preferring installed entry point
+        Command string, preferring installed entry point.
+        On Windows, paths are quoted to handle spaces.
     """
     # Prefer the installed 'claude-usage' command if available
     claude_usage_path = shutil.which("claude-usage")
     if claude_usage_path:
+        # Quote path on Windows in case of spaces
+        if IS_WINDOWS and ' ' in claude_usage_path:
+            return f'"{claude_usage_path}"'
         return claude_usage_path
 
-    # Fallback to running module directly with python
-    project_root = Path(__file__).parent.parent.absolute()
-    main_py = project_root / "src" / "main.py"
-    if main_py.exists():
-        # Use sys.executable equivalent for current python
-        return f"python3 -m src.main"
+    # For PyInstaller frozen executable
+    if getattr(sys, 'frozen', False):
+        if IS_WINDOWS and ' ' in sys.executable:
+            return f'"{sys.executable}"'
+        return sys.executable
 
-    # Last resort: assume it's installed as module
-    return "python3 -m src.main"
+    # Fallback to running module directly with python
+    if IS_WINDOWS:
+        # Quote Python path on Windows (often in "Program Files")
+        return f'"{sys.executable}" -m src.main'
+    return f"{sys.executable} -m src.main"
 
 
-def create_autostart_entry(enable: bool = True):
-    """Create or update autostart .desktop file.
+def _create_linux_autostart(enable: bool = True):
+    """Create or update autostart .desktop file on Linux.
 
     Args:
         enable: If True, enable autostart. If False, disable (set Hidden=true).
     """
-    desktop_file = get_desktop_file_path()
-
-    # Get best exec command (prefer installed entry point)
+    desktop_file = _get_linux_desktop_file_path()
     exec_cmd = _get_exec_command()
 
-    # Desktop entry content
     hidden_value = "false" if enable else "true"
     content = f"""[Desktop Entry]
 Type=Application
@@ -82,38 +96,258 @@ X-GNOME-Autostart-enabled=true
 Hidden={hidden_value}
 """
 
-    # Write .desktop file with secure permissions (rw-r--r--)
-    # .desktop files don't need execute bit - they're parsed by desktop environment
     desktop_file.write_text(content)
     desktop_file.chmod(0o644)
 
 
-def remove_autostart_entry():
-    """Remove autostart .desktop file."""
-    desktop_file = get_desktop_file_path()
+def _remove_linux_autostart():
+    """Remove autostart .desktop file on Linux."""
+    desktop_file = _get_linux_desktop_file_path()
     if desktop_file.exists():
         desktop_file.unlink()
 
 
-def is_autostart_enabled() -> bool:
-    """Check if autostart is enabled.
+def _is_linux_autostart_enabled() -> bool:
+    """Check if autostart is enabled on Linux.
 
     Returns:
         bool: True if autostart is enabled (file exists and Hidden!=true)
     """
-    desktop_file = get_desktop_file_path()
+    desktop_file = _get_linux_desktop_file_path()
 
     if not desktop_file.exists():
         return False
 
-    # Use configparser for proper INI parsing
     parser = ConfigParser(interpolation=None)
     try:
         parser.read(desktop_file)
-        # Desktop files use 'Desktop Entry' section
-        # Hidden=true means disabled; absent or false means enabled
         hidden = parser.get('Desktop Entry', 'Hidden', fallback='false')
         return hidden.lower() != 'true'
     except Exception:
-        # If parsing fails, assume enabled if file exists
         return True
+
+
+# --- Windows Registry support ---
+
+WINDOWS_RUN_KEY = r"Software\Microsoft\Windows\CurrentVersion\Run"
+WINDOWS_APP_NAME = "ClaudeUsageOverlay"
+
+
+def _create_windows_autostart(enable: bool = True):
+    """Create or remove autostart Registry entry on Windows.
+
+    Args:
+        enable: If True, enable autostart. If False, remove entry.
+    """
+    if not IS_WINDOWS:
+        return
+
+    import winreg
+
+    exec_cmd = _get_exec_command()
+
+    try:
+        key = winreg.OpenKey(
+            winreg.HKEY_CURRENT_USER,
+            WINDOWS_RUN_KEY,
+            0,
+            winreg.KEY_SET_VALUE
+        )
+        try:
+            if enable:
+                winreg.SetValueEx(key, WINDOWS_APP_NAME, 0, winreg.REG_SZ, exec_cmd)
+            else:
+                try:
+                    winreg.DeleteValue(key, WINDOWS_APP_NAME)
+                except FileNotFoundError:
+                    pass  # Already removed
+        finally:
+            winreg.CloseKey(key)
+    except OSError as e:
+        print(f"Failed to modify Windows autostart: {e}", file=sys.stderr)
+
+
+def _remove_windows_autostart():
+    """Remove autostart Registry entry on Windows."""
+    _create_windows_autostart(enable=False)
+
+
+def _is_windows_autostart_enabled() -> bool:
+    """Check if autostart is enabled on Windows.
+
+    Returns:
+        bool: True if Registry entry exists
+    """
+    if not IS_WINDOWS:
+        return False
+
+    import winreg
+
+    try:
+        key = winreg.OpenKey(
+            winreg.HKEY_CURRENT_USER,
+            WINDOWS_RUN_KEY,
+            0,
+            winreg.KEY_READ
+        )
+        try:
+            winreg.QueryValueEx(key, WINDOWS_APP_NAME)
+            return True
+        except FileNotFoundError:
+            return False
+        finally:
+            winreg.CloseKey(key)
+    except OSError:
+        return False
+
+
+# --- macOS LaunchAgent support ---
+
+def _get_macos_launch_agent_path() -> Path:
+    """Get path to macOS LaunchAgent plist file.
+
+    Returns:
+        Path: Path to com.claude-usage.overlay.plist
+    """
+    launch_agents_dir = Path.home() / "Library" / "LaunchAgents"
+    launch_agents_dir.mkdir(parents=True, exist_ok=True)
+    return launch_agents_dir / "com.claude-usage.overlay.plist"
+
+
+def _create_macos_autostart(enable: bool = True):
+    """Create or update LaunchAgent plist on macOS.
+
+    Args:
+        enable: If True, enable autostart. If False, remove plist.
+    """
+    if not IS_MACOS:
+        return
+
+    plist_path = _get_macos_launch_agent_path()
+
+    if not enable:
+        if plist_path.exists():
+            plist_path.unlink()
+        return
+
+    exec_cmd = _get_exec_command()
+
+    # For module execution, split into program and arguments
+    if " -m " in exec_cmd:
+        parts = exec_cmd.split()
+        program = parts[0]
+        args = parts[1:]
+        args_xml = "\n".join(f"        <string>{arg}</string>" for arg in args)
+        program_args = f"""    <key>ProgramArguments</key>
+    <array>
+        <string>{program}</string>
+{args_xml}
+    </array>"""
+    else:
+        program_args = f"""    <key>ProgramArguments</key>
+    <array>
+        <string>{exec_cmd}</string>
+    </array>"""
+
+    plist_content = f"""<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.claude-usage.overlay</string>
+{program_args}
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <false/>
+</dict>
+</plist>
+"""
+
+    plist_path.write_text(plist_content)
+
+
+def _remove_macos_autostart():
+    """Remove LaunchAgent plist on macOS."""
+    _create_macos_autostart(enable=False)
+
+
+def _is_macos_autostart_enabled() -> bool:
+    """Check if autostart is enabled on macOS.
+
+    Returns:
+        bool: True if LaunchAgent plist exists
+    """
+    if not IS_MACOS:
+        return False
+
+    return _get_macos_launch_agent_path().exists()
+
+
+# --- Cross-platform public API ---
+
+def get_autostart_path() -> Path:
+    """Get platform-specific autostart path.
+
+    Returns:
+        Path: Path to autostart configuration location
+    """
+    if IS_WINDOWS:
+        # Return a conceptual path for documentation purposes
+        return Path("HKCU") / WINDOWS_RUN_KEY / WINDOWS_APP_NAME
+    elif IS_MACOS:
+        return _get_macos_launch_agent_path()
+    else:
+        return _get_linux_autostart_path()
+
+
+def get_desktop_file_path() -> Path:
+    """Get path to the autostart configuration file.
+
+    Returns:
+        Path: Platform-specific autostart file path
+    """
+    if IS_WINDOWS:
+        return Path("HKCU") / WINDOWS_RUN_KEY / WINDOWS_APP_NAME
+    elif IS_MACOS:
+        return _get_macos_launch_agent_path()
+    else:
+        return _get_linux_desktop_file_path()
+
+
+def create_autostart_entry(enable: bool = True):
+    """Create or update autostart entry for current platform.
+
+    Args:
+        enable: If True, enable autostart. If False, disable.
+    """
+    if IS_WINDOWS:
+        _create_windows_autostart(enable)
+    elif IS_MACOS:
+        _create_macos_autostart(enable)
+    else:
+        _create_linux_autostart(enable)
+
+
+def remove_autostart_entry():
+    """Remove autostart entry for current platform."""
+    if IS_WINDOWS:
+        _remove_windows_autostart()
+    elif IS_MACOS:
+        _remove_macos_autostart()
+    else:
+        _remove_linux_autostart()
+
+
+def is_autostart_enabled() -> bool:
+    """Check if autostart is enabled for current platform.
+
+    Returns:
+        bool: True if autostart is enabled
+    """
+    if IS_WINDOWS:
+        return _is_windows_autostart_enabled()
+    elif IS_MACOS:
+        return _is_macos_autostart_enabled()
+    else:
+        return _is_linux_autostart_enabled()

src/config.py

@@ -1,4 +1,7 @@
-"""Configuration module for loading Claude OAuth credentials."""
+"""Configuration module for loading Claude OAuth credentials.
+
+Cross-platform: uses platformdirs for config directory resolution.
+"""
 
 import json
 import os
@@ -6,9 +9,15 @@ import time
 from dataclasses import asdict, dataclass
 from pathlib import Path
 
+import platformdirs
+
 
 CREDENTIALS_PATH = Path.home() / ".claude" / ".credentials.json"
 
+# Application info for platformdirs
+APP_NAME = "claude-usage-overlay"
+APP_AUTHOR = "claude-usage"  # Used on Windows
+
 
 def load_credentials() -> dict:
     """Load Claude OAuth credentials from ~/.claude/.credentials.json.
@@ -74,22 +83,27 @@ def get_access_token() -> str:
     return credentials["accessToken"]
 
 
-def get_config_path() -> Path:
-    """Get XDG-compliant config file path.
+def get_config_dir() -> Path:
+    """Get cross-platform config directory.
 
     Returns:
-        Path: Path to config.json in XDG config directory
+        Path: Config directory path
+        - Linux: ~/.config/claude-usage-overlay/
+        - Windows: %APPDATA%/claude-usage/claude-usage-overlay/
+        - macOS: ~/Library/Application Support/claude-usage-overlay/
     """
-    config_home = os.environ.get('XDG_CONFIG_HOME')
-    if config_home:
-        base = Path(config_home)
-    else:
-        base = Path.home() / '.config'
-
-    config_dir = base / 'claude-usage-overlay'
+    config_dir = Path(platformdirs.user_config_dir(APP_NAME, APP_AUTHOR))
     config_dir.mkdir(parents=True, exist_ok=True)
+    return config_dir
+
 
-    return config_dir / 'config.json'
+def get_config_path() -> Path:
+    """Get cross-platform config file path.
+
+    Returns:
+        Path: Path to config.json in platform-specific config directory
+    """
+    return get_config_dir() / 'config.json'
 
 
 @dataclass
@@ -140,7 +154,7 @@ class UserConfig:
 
     @classmethod
     def load(cls) -> 'UserConfig':
-        """Load configuration from XDG config file.
+        """Load configuration from config file.
 
         Returns:
             UserConfig: Configuration object with values from file or defaults
@@ -165,9 +179,16 @@ class UserConfig:
             raise ValueError(f"Invalid config file structure: {e}")
 
     def save(self):
-        """Save configuration to XDG config file."""
+        """Save configuration to config file."""
         config_path = get_config_path()
         config_path.parent.mkdir(parents=True, exist_ok=True)
 
         with open(config_path, 'w') as f:
             json.dump(asdict(self), f, indent=2)
+
+        # Set secure permissions (owner read/write only) on Unix
+        try:
+            os.chmod(config_path, 0o600)
+        except (OSError, AttributeError):
+            # Windows doesn't support chmod the same way, skip
+            pass