goccc

A fast, zero-dependency CLI cost calculator, tool analytics, and customizable statusline for Claude Code. Breakdowns by model, day, project, and branch. Single binary, no runtime needed.

Table of Contents

- Installation
- Usage
- Claude Code Statusline
- Session Exit Hook
- Tool & Skill Analytics
- Configuration
- Flags
- Preserving Log History

Installation

Homebrew (macOS / Linux)

Go install

Pre-built binaries

Available on the releases page for macOS, Linux, and Windows (amd64 / arm64).

From source

Usage

Claude Code Statusline

goccc can serve as a Claude Code statusline — a fully customizable, live cost dashboard right in your terminal prompt.

- 💸 Session cost — parsed from the current session's JSONL files using goccc's pricing table
- 💰 Today's total — aggregated across all sessions today (shown only when higher than session cost)
- 💭 Context % — context window usage percentage
- 🔋 5h / 7d window — remaining percentage of the usage window with elapsed time (subscription users only; hidden for API billing). Emoji switches to 🪫 below 25%
- 🤖 Model — current model

The mcp segment (active MCP servers) is available but off by default — add it to segments to enable it.

Values are color-coded: cost and context turn yellow → red as they increase; rate limit windows are inverted — yellow below 50%, red below 25% remaining.

Setup

Add to ~/.claude/settings.json:

Works with any install method. To run without installing: go run github.com/backstabslash/goccc@latest -statusline.

Customization

The statusline is fully customizable via ~/.goccc.json. With no config, you get the default layout shown above.

segments — ordered list of segments to display. Only listed segments are shown; segments with no data auto-hide. "|" forces a line break.

The config…