Tokentap

Tokentap (formerly Sherlock)

    Token Tracker for LLM CLI Tools

    Installation •
    Quick Start •
    Features •
    Commands •
    Contributing

tokentap tracks token usage for LLM CLI tools with a live terminal dashboard. See exactly how many tokens you're using in real-time.

Why tokentap?

- Track Token Usage: See exactly how many tokens each request consumes
- Monitor Context Windows: Visual fuel gauge shows cumulative usage against your limit
- Debug Prompts: Automatically saves every prompt as markdown and JSON for review
- Zero Configuration: No certificates, no setup - just install and go

Installation

Or install from source:

Requirements

- Python 3.10+

Quick Start

Terminal 1: Start the Dashboard

You'll be prompted to choose where to save captured prompts, then the dashboard appears:

Terminal 2: Run Your LLM Tool

That's it! Watch the dashboard update in real-time as you work.

Features

Live Terminal Dashboard

Real-time token tracking with color-coded fuel gauge:
- Green:  80% of limit

Prompt Archive

Every intercepted request is saved to your chosen directory:
- Markdown - Human-readable format with metadata
- JSON - Raw API request body for debugging

Session Summary

When you exit, see your total usage:

Commands

Supported providers for --provider: anthropic, openai, gemini, minimax

Options

How It Works

For OpenAI-compatible providers like MiniMax, tokentap uses
path-prefix routing so requests are forwarded to the correct upstream API:

Supported Providers

Known Issues

Gemini CLI

Gemini CLI currently has a known issue where it ignores custom base URLs when using OAuth authentication. tokentap's Gemini support will work automatically once the Gemini CLI team fixes this issue.

Contributing

Contributions are welcome! Here's how you can…