Claude Code Usage (ccusage)

v2.1.2 - February 2, 2026

Fixed

• Monthly cost projection now uses current month data instead of all-time totals

v2.1.1 - January 30, 2026

Added

• Custom npx path now supports tilde (~) expansion for home directory paths

v2.1.0 - January 27, 2026

Added

• Real-time Claude API usage limits monitoring with 5-hour and 7-day utilization tracking
• AI tool (get-usage-limits) for querying usage limits programmatically
• Secure macOS Keychain integration for Claude Code access token retrieval
• Stale data handling with visual warnings when API calls fail
• Usage Limits component in main view with detailed metadata display
• Menu bar integration showing usage limit percentages and reset times
• Manual refresh action for usage limits data
• Usage Limits option in default view preferences

Changed

• Updated menu bar to include dedicated Usage Limits section
• Enhanced error handling for credential management and API failures
• Improved visual consistency with black/white gauge icons

v2.0.3 - November 7, 2025

Added

• Direct ccusage command execution option for network environments with npx connectivity issues
• Node.js version sorting in PATH resolution to prioritize latest versions
• Enhanced PATH resolution for improved npx binary discovery across Node.js installations

Changed

• Simplified project dependencies by removing usehooks-ts package
• Improved CLI execution flexibility with configurable command options

Fixed

• Enhanced compatibility with various Node.js version managers (nvm, fnm, volta)

v2.0.2 - July 7, 2025

Fixed

• https://github.com/raycast/extensions/issues/20056
• Fixed an issue where an unexpected node execution environment was selected depending on the user's environment when the customNpx preference was set, causing commands to not run properly.

v2.0.1 - June 25, 2025

Fixed

• Fixed extension crashes on initial load when no cached data is available
• Resolved runtime errors that occurred after clearing Raycast cache
• Improved loading state indicators to show "Loading..." instead of "No data" during data fetch

v2.0.0 - June 24, 2025

Added

• AI Extension Support: Comprehensive integration with Raycast AI Extensions for Claude models

Changed

• Major architecture refactor: redesigned extension with layered hook architecture
• Improved type safety and data validation throughout the codebase
• Enhanced error handling and user guidance for system configuration

v1.0.2 - June 20, 2025

• Cleaned up unused dependencies and exports detection
• Improved development workflow efficiency

v1.0.1 - June 18, 2025

• Housekeep Knip config

Initial Release - June 18, 2025

• Real-time Claude Code usage monitoring
• Daily usage tracking with token and cost breakdown
• Session history with model-specific indicators (Opus, Sonnet, Haiku)
• Cost analysis and projections
• Model-wise usage statistics
• Menu bar integration for quick access
• npx-based execution with custom path configuration support
• Integration with ccusage CLI tool for data fetching