Skip
All open source

2026 · open source · MIT

tikr

Local AI coding token tracker

Watches Claude Code, Codex, and Copilot CLI session files. Append-only encrypted ledger. Live TUI dashboard. Nothing leaves your machine.

Screenshots

tikr live TUI dashboard
Live dashboard — tools, share, burn, local only
tikr stats CLI output
tikr stats from real local session files

Overview

tikr is an append-only ledger of AI coding tool usage. It tails local session files, folds tokens into daily and project buckets, and refuses writes that would shrink your totals when Claude Code prunes transcripts.

Counting is the hard part: one API message becomes several JSONL entries. Naive summing inflates output ~2.2×. Deduping by message id is load-bearing. Cost is an offline estimate at published list rates — not a bill.

Highlights

  • Claude Code, Codex, Copilot CLI providers
  • Encrypted, machine-bound, hash-chained ledger
  • Live TUI dashboard + stats CLI + statusline
  • Five-hour block burn rates for Claude Code limits

Install

curl -fsSL https://raw.githubusercontent.com/mubashirjamali101/tikr/main/install.sh | bash

Stack

TypeScriptTypeScriptNodeNode

Elsewhere

Find me online

I share work and notes here, on GitHub, and on LinkedIn. For project or security mail: hello@mubashirjamali.com and security@mubashirjamali.com below.