ccusage.nvim

⌖  ccusage.nvim  ⌖

  Track Claude Code usage in Neovim

💡 Motivation

As a Claude Code user with an Anthropic Pro subscription ($20/month), I frequently encounter usage limits during intensive development sessions (particularly when leveraging SuperClaude enhancements). This requires careful management of API requests to maximize productivity within rate limits.

Anthropic currently implements usage limits based on a 5-hour rolling window [^1]. Once this window expires, usage limits reset automatically. The ccusage CLI tool provides an excellent solution for tracking Claude Code consumption patterns.

This plugin brings ccusage statistics directly into your Neovim workflow. It seamlessly integrates usage data into your statusline via lualine components and provides on-demand notifications through the :CCUsage command.

⚡️ Requirements

- Neovim ≥ 0.11
- ccusage CLI tool installed (npm install -g ccusage)
- lualine.nvim (optional)

📦 Installation

Install ccusage.nvim using your preferred plugin manager. Here's a complete configuration example for lazy.nvim:

🚀 Usage

Get started by reading the comprehensive documentation with :help ccusage, which covers all plugin features and configuration options.

Mastering Vim/Neovim Documentation: Most Vim/Neovim plugins include built-in :help documentation. Learning to navigate this system effectively is an invaluable skill for any Vim user. If you're new to this, start with :help and explore the first 20 lines to understand the navigation basics.

🙏 Acknowledgments

- S1M0N38/base.nvim for the plugin template foundation
- ryoppippi/ccusage for the excellent ccusage CLI tool