Commands

expand all collapse all show raw

-h/--help work on every command; -v/--version at the tool root.

tuAI coding assistant cost tracking CLI copy

Usage: tu [source] [period] [display] Sources: cc (Claude Code), codex/co (Codex), oc (OpenCode), all (default) Periods: d/daily (default), m/monthly Display: (bare) = snapshot, h/history = history Combined: dh (daily history), mh (monthly history) Examples: tu Today's cost, all tools (snapshot) tu cc Today's cost, Claude Code tu h Daily cost history, all tools (pivot) tu cc mh Monthly cost history, Claude Code tu m This month's cost, all tools Setup: tu init-conf Scaffold ~/.tu.conf tu init-metrics Clone metrics repo tu sync Push/pull metrics manually tu status Show config and sync state tu update Update tu to latest version tu shell-init <sh> Emit shell init script (bash/zsh/fish) Help: tu help | tu -h | tu --help

flags

flag	type	description	copy
--json		Output data as JSON (data commands only)	copy
--csv		Output data as CSV (data commands only)	copy
--md		Output data as Markdown (data commands only)	copy
--sync		Sync metrics before fetching (multi mode)	copy
--fresh/ -f		Bypass cache, fetch fresh data (data commands only)	copy
--watch/ -w		Persistent polling mode with live display (data commands only)	copy
--interval/ -i <s>		Poll interval in seconds (default: 10, range: 5-3600)	copy
--user/ -u <user>		Show usage for a specific user (multi mode only)	copy
--by-machine		Show per-machine cost breakdown (data commands only)	copy
--skip-brew-update		Skip 'brew update' tap refresh during 'tu update'	copy
--no-color		Disable ANSI color output	copy
--no-rain		Disable matrix rain animation in watch mode	copy

show raw -h output

Usage: tu [source] [period] [display]

Sources: cc (Claude Code), codex/co (Codex), oc (OpenCode), all (default)
Periods: d/daily (default), m/monthly
Display: (bare) = snapshot, h/history = history
Combined: dh (daily history), mh (monthly history)

Examples:
  tu                   Today's cost, all tools (snapshot)
  tu cc                Today's cost, Claude Code
  tu h                 Daily cost history, all tools (pivot)
  tu cc mh             Monthly cost history, Claude Code
  tu m                 This month's cost, all tools

Setup:
  tu init-conf         Scaffold ~/.tu.conf
  tu init-metrics      Clone metrics repo
  tu sync              Push/pull metrics manually
  tu status            Show config and sync state
  tu update            Update tu to latest version
  tu shell-init <sh>   Emit shell init script (bash/zsh/fish)

Help: tu help | tu -h | tu --help

Flags:
  --json               Output data as JSON (data commands only)
  --csv                Output data as CSV (data commands only)
  --md                 Output data as Markdown (data commands only)
  --sync               Sync metrics before fetching (multi mode)
  --fresh / -f         Bypass cache, fetch fresh data (data commands only)
  --watch / -w         Persistent polling mode with live display (data commands only)
  --interval / -i <s>  Poll interval in seconds (default: 10, range: 5-3600)
  --user / -u <user>   Show usage for a specific user (multi mode only)
  --by-machine         Show per-machine cost breakdown (data commands only)
  --skip-brew-update   Skip 'brew update' tap refresh during 'tu update'
  --no-color           Disable ANSI color output
  --no-rain            Disable matrix rain animation in watch mode