cline-usage 1.0.0

dotnet tool install --global cline-usage --version 1.0.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local cline-usage --version 1.0.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=cline-usage&version=1.0.0
                    
nuke :add-package cline-usage --version 1.0.0
                    

cline-usage

A CLI tool to analyze Cline (VS Code AI assistant) token usage and costs. Similar to ccusage for Claude Code.

Installation

dotnet tool install --global cline-usage

Usage

# Show daily usage report (default)
cline-usage

# Show daily usage report
cline-usage daily

# Show monthly usage report
cline-usage monthly

# Show session-based usage report
cline-usage session

# Specify custom data path
cline-usage daily -d /path/to/cline/tasks

# Show help
cline-usage --help

Reports

Daily Report

Shows token usage and costs aggregated by day.

Monthly Report

Shows token usage and costs aggregated by month.

Session Report

Shows usage per Cline session with request counts.

Data Path

The tool automatically looks for Cline extension data in standard VS Code paths:

  • ~/.vscode/extensions/saoudrizwan.claude-dev-*/tasks/
  • ~/.vscode/extensions/cline.*/tasks/

You can specify a custom path with -d or --data.

Output

The tool displays colorful tables showing:

  • Input/Output tokens
  • Cache writes/reads
  • Total tokens
  • Cost (USD)

Building from Source

git clone https://github.com/user/cline-usage.git
cd cline-usage
dotnet build src
dotnet run --project src

Contributing

This project uses Conventional Commits and semantic-release for automated versioning.

Commit Message Format

<type>(<scope>): <description>

[optional body]

Types:

  • feat: New feature (triggers minor version bump)
  • fix: Bug fix (triggers patch version bump)
  • docs: Documentation changes
  • chore: Maintenance tasks
  • refactor: Code refactoring
  • test: Adding tests

Breaking Changes: Add BREAKING CHANGE: in the commit body or ! after type (triggers major version bump)

Examples:

feat: add weekly report command
fix: correct date parsing for sessions
feat!: change default data path location

License

MIT

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.0.0 198 12/13/2025