# How to Show Current Session Usage in Claude Code Statusline

%%[bmc-wdiget] 

## 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:
    
    ```bash
    brew tap tharuxpert/ccstatus
    ```
    
3. **Install the ccstatus Tool**: Once the repository is added, install the `ccstatus` tool by running:
    
    ```bash
    brew install ccstatus
    ```
    
4. **Verify Installation**: After installation, you can verify that `ccstatus` is installed correctly by checking its version:
    
    ```bash
    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:

```bash
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](https://github.com/tharuxpert/ccstatus/issues)

💬 Feedback & ideas: [https://github.com/tharuxpert/ccstatus/discussions](https://github.com/tharuxpert/ccstatus/discussions)

## References

### https://github.com/tharuxpert/ccstat[us](https://github.com/tharuxpert/ccstatus/issues)

### [https://github.com/tharuxpert/homebrew-ccstatus](https://github.com/tharuxpert/ccstatus/issues)