How to Show Current Session Usage in Claude Code Statusline

Introduction

I developed a CLI tool called ccstatus that displays actual session usage directly in the Claude Code status line. This enhancement allows users to view their session metrics without needing to manually type "/status", providing a more seamless and efficient experience.

Setting Up the Environment

Installation

1. Ensure Homebrew is Installed: Before proceeding, make sure you have Homebrew installed on your system. Homebrew is a package manager for macOS that simplifies the installation of software.

2. Add the Repository: Use the following command to add the tharuxpert/ccstatus repository to Homebrew:

    brew tap tharuxpert/ccstatus
   

3. Install the ccstatus Tool: Once the repository is added, install the ccstatus tool by running:

    brew install ccstatus
   

4. Verify Installation: After installation, you can verify that ccstatus is installed correctly by checking its version:

    ccstatus version
   

These steps provide a clear and structured approach to installing the necessary software using Homebrew.

Configuration for Accessing ccstatus in Claude Code

To set up the ccstatus tool, use the following command:

ccstatus install

This command safely updates the ~/.claude/settings.json file to include the status line configuration. Rest assured, no configuration changes will be made without your consent—you will be prompted to approve any modifications before they are applied.

Why ccstatus?

The ccstatus tool in Claude Code offers a seamless and efficient way to keep track of your usage metrics directly within the status line. This continuous monitoring feature means you no longer need to manually type "/status" to check your session and weekly usage. By having real-time visibility of your usage data, you can manage your resources more effectively, avoid unexpected costs, and optimize your workflow. This tool enhances user experience by providing instant access to critical information, allowing for better decision-making and improved efficiency in managing your usage patterns.

Feedback welcome

If you use Claude Code, I’d love feedback on:

• Is the statusline information actually useful?

• Is anything confusing during setup (ccstatus install)?

• What else would you want to see in the statusline?

👉 Open an issue:
https://github.com/tharuxpert/ccstatus/issues

💬 Feedback & ideas: https://github.com/tharuxpert/ccstatus/discussions

References

https://github.com/tharuxpert/ccstatus

https://github.com/tharuxpert/homebrew-ccstatus