# Tokf Discover

> Find missed token savings by scanning AI coding session files for commands that ran without tokf filtering. Use when this capability is needed.

- Skill: `tomevault-io/tokf-discover` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/tokf-discover`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/tokf-discover/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/tokf-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:

```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
```

---
> Source: [mpecan/tokf](https://github.com/mpecan/tokf) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-29 -->