PROJECT · TOK0 / FIELD COMPRESSION UNIT
SERIAL NO. 0.4.2 · BUILT IN RUST · MIT
CONFIDENTIAL — TOKEN COMPRESSION FIELD UNIT TACTICAL CLI LABORATORY >>> ADAPTIVE PROMPT SURVEILLANCE
00 / 05 OPEN-SOURCE CLI COMPRESSION PROXY v0.4.2 · MIT · APR 2026

Strip the noise
from every shell command
before it hits the model.

01 / 05 FIELD TELEMETRY

Live numbers from the
field — not marketing.

Every tok0 instance reports anonymous compression metrics back to api.tok0.dev. The four numbers below are the real, current state of the deployed fleet — refreshed on every page load.

01 · Tokens compressed
9.96M
Cumulative · all tracked instances
02 · Avg. savings
82.1%
Across every wrapped command
03 · Active instances
12
Reporting in last 10 days
04 · Commands run · 30 d
9,608
14 day rolling window
Live · api.tok0.dev/statsGENERATED · 2026-05-02 17:54:14 UTC
[ 30-DAY SAVED TOKENS ] 14 POINTS · 8.92M TOTAL
2026-04-18 2026-05-01
Top commands · by tokens saved
  • npm install 13,395 runs
    17.25M
  • git log 12,688 runs
    16.70M
  • git diff 14,497 runs
    16.64M
  • cargo build 9,870 runs
    12.57M
  • docker build 8,817 runs
    10.99M
  • pnpm install 8,084 runs
    10.19M
SOURCE · D1 · command_stats ▶ /stats
[ FLEET BREAKDOWN ] 12 INSTANCES
By operating system
  • macos-aarch64 4 · 33%
  • linux-x86_64 4 · 33%
  • linux-aarch64 2 · 17%
  • windows-x86_64 1 · 8%
  • macos-x86_64 1 · 8%
By country
US 2AU 1BR 1DE 1FR 1GB 1
By version
v0.4.2 9 v0.4.1 2 v0.4.0 1
SOURCE · D1 · instances ● LIVE
02 / 05 SYSTEM SPECIFICATION

Built like a piece
of infrastructure.

Six non-negotiables. Each one is a CI gate, not a marketing claim.

01 FEATURE

Single static binary, no runtime.

Pure Rust, single-threaded by design. Zero tokio, zero async-std. Cold start under 5 ms — every shell call stays cheap.

RUST · 8 MB
02 FEATURE

Deterministic compression pipeline.

Strip ANSI · pattern replace · output match · line select · truncate · head/tail window · hard cap · empty fallback. Pure functions, fully testable.

8-STAGE PIPELINE
03 FEATURE

Declarative rules, embedded at build.

100+ built-in TOML compression rules across git, cargo, npm, docker, kubectl, terraform, pytest, and more — each with min-savings assertions baked into CI.

100+ TOML RULES
04 FEATURE

Auto-installs into your agent.

tok0 init detects Claude Code, Cursor, Gemini CLI, Windsurf, Cline, Amp, OpenCode, Codex, Kimi Code — drops the right hook or rule file in the right place.

9 AI TOOLS
05 FEATURE

Never blocks your terminal.

If a filter errors, tok0 passes through the raw command output unchanged. Exit codes propagate exactly. Your CI never breaks because of compression.

FALLBACK SAFE
06 FEATURE

Telemetry stays on your machine.

SQLite token meter at ~/.config/tok0. No account, no API key, no upload by default. Cloud feature is gated and opt-in only.

LOCAL-FIRST
03 / 05 COMPATIBLE SYSTEMS

Drops into the
agent you already use.

One tok0 init auto-detects every supported AI tool on your machine and installs the right hook, rule file, or AGENTS.md entry. Manual escape hatch for the GUI-only ones.

[ AI TOOLS ] 9 SUPPORTED · 7 AUTO-INSTALL
Tool Surface Status
Claude Code
PreToolUse hook
~/.claude/settings.json Auto-install
Cursor
rules file paste-in
Settings → Rules Paste-in
Gemini CLI
auto-loaded instructions
~/.gemini/GEMINI.md Auto-install
Windsurf
global rules file
~/.codeium/windsurf/memories/… Auto-install
Cline
Cline Rules toggle
~/Documents/Cline/Rules/tok0.md Auto-install
Amp
AGENTS.md auto-load
~/.config/amp/AGENTS.md Auto-install
OpenCode
AGENTS.md auto-load
~/.config/opencode/AGENTS.md Auto-install
Codex
AGENTS.md (manual)
~/.codex/AGENTS.md Manual
Kimi Code
manual paste-in
~/.kimi/tok0.md Paste-in
SOURCE · apps/cli/src/bridge/setup.rs ▶ tok0 init
[ COMMANDS COMPRESSED ] 250+ TOTAL · CI-VERIFIED FLOORS

tok0 ships 100+ TOML compression rules and 52 native Rust compressors covering git, package managers, build tools, container/cloud CLIs, linters, test runners, and database clients. Floor savings shown below are CI-asserted minimums — real-world numbers run higher.

git diff −83%git log −78%cargo build −72%cargo test −68%cargo clippy −74%npm install −80%pnpm install −81%bun install −79%tsc −66%vitest −71%next build −70%docker build −84%kubectl get −69%terraform plan −77%pytest −73%ruff check −65%go build −67%gradle build −76%aws s3 ls −72%gh pr list −68%brew install −85%apt install −82% + 228 MORE
SOURCE · apps/cli/src/rules/*.toml + compressors/ 100 TOML · 52 RUST
04 / 05 OPERATIONAL MANIFEST

Rules of engagement.

  • 01 Wraps any CLI Zero config
  • 02 Strips ANSI / banners Deterministic
  • 03 Preserves exit codes Always
  • 04 Falls back on filter error Never blocks
  • 05 Open source MIT
  • 06 No account required Local-first
[ SYSTEM LOG ] tok0 status
$ tok0 status # INIT.................OK # BRIDGE HOOK..........CONNECTED · claude-code # RULES CACHE..........WARM · 100 rules · 12 ms # METER................ACTIVE · 1,247 ops today # TELEMETRY............LOCAL · ~/.config/tok0/db # EXIT CODE PROPAGATION.VERIFIED # FALLBACK SAFETY......ARMED — ready —
FIELD SPEC · TOK0/0.4.2 ● ALL SYSTEMS NOMINAL
05 / 05 READY IN 12 SECONDS

Stop paying
for tokens
you never needed.

One install. tok0 auto-detects your AI tool, installs the right hook, and starts compressing every command your agent runs. No flags, no config, no account.

$ curl -fsSL https://tok0.dev/install.sh | sh
GET TOK0 → VIEW SOURCE ↗
ALL RESEARCH CONDUCTED UNDER FIELD SPEC. 240L-A0 / FWD OPS EXPERIMENTAL LABORATORY — BROOKLYN NAVY YARD