Agent skill

tokf-discover

Find missed token savings by scanning AI coding session files for commands that ran without tokf filtering.

Stars 147
Forks 14

Install this agent skill to your Project

npx add-skill https://github.com/mpecan/tokf/tree/main/crates/tokf-cli/skills/codex-discover

SKILL.md

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:

bash
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:

bash
tokf discover --json

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results