Home› Tools› scorpiox-usage

scorpiox-usage🐛 debug

linux-x64 linux-arm64 macos-arm64 windows-x64

Track token consumption and costs across AI provider sessions. Records input/output tokens per model, provider, and project for budgeting and analysis.

⚙️ Flags & Options (8)

Flag Short Description Takes Value
--session -s Session ID (required) Yes
--provider -p Provider: claude, gemini, openai (required) Yes
--model -m Model name (sonnet-4, opus-4, etc.) Yes
--input -i Input tokens Yes
--output -o Output tokens Yes
--tier -t Service tier (standard, priority) Yes
--project — Project name (default: basename of cwd) Yes
--branch — Git branch (default: auto-detect) Yes

💡 Usage Examples

Record token usage for a Claude session
$ scorpiox-usage --session abc-123-def     --provider claude     --model sonnet-4     --input 15420     --output 3280 # Records 15,420 input + 3,280 output tokens for sonnet-4
Track Opus usage with priority tier
$ scorpiox-usage -s sess-789     -p claude     -m opus-4     -i 82000     -o 12500     -t priority # Priority tier pricing — useful for cost tracking at scale
Log OpenAI usage with project and branch context
$ scorpiox-usage --session oai-456     --provider openai     --model gpt-4.1     --input 24000     --output 6100     --project scorpiox-code     --branch feature/new-parser # Tags usage with project name and git branch for filtering
Gemini usage — minimal required flags
$ scorpiox-usage -s gem-001 -p gemini # Only session and provider are required; tokens default to 0
Auto-detect project and branch from working directory
$ cd /home/dev/my-project $ scorpiox-usage -s auto-sess -p claude     -m sonnet-4     -i 5000 -o 1200 # --project defaults to "my-project" (basename of cwd) # --branch defaults to current git branch (auto-detected)

📦 Source & Build Info

Source File
scorpiox/scorpiox-usage.c
Lines of Code
517
Dependencies
libcurl · libsxhttp · libsxutil