---
name: Tokf Run
slug: tokf-run
category: Automation
description: Tokf Run compresses verbose CLI output from supported commands into concise results before returning them. Use it for git, cargo, npm, docker, kubectl, and similar commands when terminal output is too long.
github: "https://github.com/mpecan/tokf/tree/main/crates/tokf-cli/skills/codex-run"
language: Rust
stars: 196
forks: 19
install: "npx degit https://github.com/mpecan/tokf/tree/main/crates/tokf-cli/skills/codex-run ~/.claude/skills/codex-run"
installs_to: ~/.claude/skills/codex-run
source_path: crates/tokf-cli/skills/codex-run/SKILL.md
collection_size: 4
category_size: 1956
collection_url: "https://dirskills.com/collections/mpecan/tokf"
added: 2026-09-05T05:31:10.847Z
last_synced: 2026-09-05T05:31:10.847Z
canonical_url: "https://dirskills.com/skills/tokf-run"
---

# Tokf Run

Tokf Run compresses verbose CLI output from supported commands into concise results before returning them. Use it for git, cargo, npm, docker, kubectl, and similar commands when terminal output is too long.

**Install:**

```bash
npx degit https://github.com/mpecan/tokf/tree/main/crates/tokf-cli/skills/codex-run ~/.claude/skills/codex-run
```

## README

# tokf — Token Output Filter

tokf compresses verbose command output so you receive concise, structured results instead of raw terminal dumps. It saves context tokens and makes output easier to reason about.

## Rule

When the tokf Codex hook is installed, run supported commands normally. The hook rewrites matching commands to `tokf run <command>` before execution.

If the hook is unavailable, blocked, or not rewriting a supported command, use the manual fallback:

```
tokf run <command>
```

**Examples:**

```sh
tokf run git status
tokf run cargo test
tokf run npm test
tokf run docker ps
```

## Supported commands

The following commands have built-in filters. The hook can rewrite them automatically; use `tokf run` manually only as fallback:

- `git status`, `git diff`, `git log`, `git push`, `git add`, `git commit`, `git show`
- `cargo build`, `cargo test`, `cargo check`, `cargo clippy`, `cargo install`
- `npm test`, `npm run`, `yarn test`, `pnpm test`
- `docker build`, `docker compose`, `docker ps`, `docker images`
- `go build`, `go vet`
- `gradle build`, `gradle test`, `gradle dependencies`
- `gh pr view`, `gh pr list`, `gh pr checks`, `gh issue view`, `gh issue list`
- `kubectl get pods`
- `next build`
- `pnpm add`, `pnpm install`
- `prisma generate`
- `pytest`
- `tsc`
- `ls`

Commands not in this list pass through unchanged when prefixed with `tokf run`.

## Important rules

1. **Never double-prefix.** If a command already starts with `tokf run`, do not add it again.
2. **Arguments pass through.** In manual fallback mode, include all flags and arguments after the base command: `tokf run cargo test --release -- my_test`.
3. **Fail-safe.** If `tokf` is not installed or not on PATH, run the command without the prefix.
4. **Environment variables.** Place env vars before `tokf run`: `RUST_LOG=debug tokf run cargo test`.
5. **Pipes.** Do not add redundant filtering pipes (e.g. `| grep`, `| tail`, `| head`) after `tokf run` commands — tokf already compresses the output. Piping tokf's output for other purposes (e.g. `tokf run cargo test | wc -l`) is fine.