mpecan/tokf/codex-discover

tokf discover — Find Missed Token Savings

Use this skill to analyze past sessions and find commands that are running without tokf filtering, wasting tokens on verbose output.

Quick Start

Run tokf discover in the project directory to scan recent sessions:

tokf discover

Options

• --all — scan all projects, not just the current one
• --since 7d — only scan sessions from the last 7 days (also 24h, 30m)
• --limit 0 — show all results (default: top 20)
• --json — output as JSON for programmatic use
• --session <path> — scan a specific session file
• --project <path> — scan sessions for a specific project path

Workflow

1. Run tokf discover to identify top savings opportunities
2. For commands with existing filters: run tokf hook install --tool codex to set up automatic filtering
3. For commands without filters: create a custom filter with tokf eject
4. Re-run tokf discover after changes to verify improvement

JSON Output

Use --json for integration with other tools:

tokf discover --json