Fullstop000/toll
skills/toll/SKILL.md
Use this skill when the user asks about token usage, API costs, spending, or session statistics for Claude Code, Codex CLI, Kimi Code, or Gemini CLI. This skill runs the `toll` CLI to aggregate token counts and estimated USD costs from local session logs stored in ~/.claude, ~/.codex, ~/.kimi, and ~/.gemini. Activate when the user says things like "how many tokens have I used", "how much have I spent on Claude", "show my usage", "token stats", "daily usage breakdown", or "export my usage as CSV".
$ install --global
skillsauthnpx skillsauth add Fullstop000/toll tollInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
4 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
4
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 21, 2026, 8:59 PM81.0s1 file scanned
SKILL.md
- name:
- toll
- description:
- |
- license:
- MIT
- compatibility:
- Requires the `toll` binary to be installed. Supports Linux and macOS (x86_64 and ARM64). Reads logs from ~/.claude/projects/**/*.jsonl (Claude Code), ~/.codex/sessions/ (Codex CLI), ~/.kimi/sessions/ (Kimi Code), and ~/.gemini/tmp/ (Gemini CLI). No network access required at runtime.
- author:
- Fullstop000
- version:
- 1.0.7
- repository:
- https://github.com/Fullstop000/toll
- homepage:
- https://github.com/Fullstop000/toll
toll — Token Usage Tracker
Track token consumption and estimated USD costs from Claude Code, Codex CLI, Kimi Code, and Gemini CLI sessions.
Installation
Check if toll is installed:
toll --version
If not found, install it:
# Quick install (Linux/macOS)
curl -fsSL https://raw.githubusercontent.com/Fullstop000/toll/refs/heads/master/install.sh | sh
# Or via cargo
cargo install toll
Commands
Map the user's intent to the appropriate toll invocation:
| User Intent | Command |
|---|---|
| All-time summary | toll |
| Today only | toll --today |
| Last N days | toll --days <N> |
| Daily breakdown | toll --by-day |
| Daily breakdown for N days | toll --by-day --days <N> |
| Claude Code only | toll --claude |
| Codex CLI only | toll --codex |
| Kimi Code only | toll --kimi |
| Gemini CLI only | toll --gemini |
| Combined filters | toll --days <N> --by-day --detail --json |
| Full token counts (no abbreviation) | toll --detail |
| JSON output | toll --json |
| CSV export | toll --csv |
| List model prices | toll --list-prices |
Flags can be combined freely, e.g. toll --by-day --days 7 --claude --detail.
Output Metrics
Explain these columns if the user is unfamiliar:
- Sessions — number of AI coding sessions tracked
- Input — total tokens sent to the model (prompt)
- Cached — tokens served from prompt cache (cheaper rate)
- Hit Rate — percentage of input tokens that were cached
- Net Input — non-cached input tokens billed at full rate
- Output — tokens generated by the model
- Cost — estimated USD cost based on per-model pricing (marked
*when approximate)
Token counts use compact notation: 1.2m = 1,200,000 tokens, 45.6k = 45,600 tokens.
Related Skills
openclaw/taskflow
tools
VerifiedTrustedCommunity
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
357,764SKILL.mdUpdated Apr 10, 2026
openclaw/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,764SKILL.mdUpdated Apr 10, 2026
steipete/extensions/lobster
tools
VerifiedTrustedCommunity
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
357,588SKILL.mdUpdated Apr 13, 2026
steipete/xurl
tools
VerifiedTrustedCommunity
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
356,423SKILL.mdUpdated Apr 13, 2026