gitwtfhub

wtf is token-diet?

kulaxyz/token-diet — explained in plain English

Analysis updated 2026-05-18

519ShellAudience · developerComplexity · 1/5Setup · easy

TL;DR

A skill that makes AI coding assistants like Claude Code and Cursor write less filler, cutting token costs by about 31% on average with no loss of correctness.

Mindmap

mindmap
  root((token-diet))
    What it does
      Trims AI reply filler
      Cuts docs and comments
      Preserves correctness
    Tech stack
      Shell install script
      Claude Code
      Cursor and Codex
    Use cases
      Lower AI coding bills
      Get terser chat replies
      Keep tests and code precise
    Audience
      Developers using AI agents
      Solo coders
      Teams on usage based billing
    Setup
      Run install one-liner
      Pick target agent
      Choose on lite ultra or off

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Lower your monthly AI coding assistant bill without changing how you work.

REASON 2

Cut filler language from AI chat replies while keeping code and tests precise.

REASON 3

Install a token-saving skill across Claude Code, Codex, Cursor, Windsurf, or Cline at once.

REASON 4

Switch between normal, lite, ultra, and off modes depending on the task.

What's in the stack?

ShellClaude CodeCodexCursor

How it stacks up

kulaxyz/token-dietkelseyhightower/consul-on-kuberneteskelseyhightower/serverless-vault-with-cloud-run
Stars519598408
LanguageShellShellShell
Last pushed2018-11-042022-04-28
MaintenanceDormantDormant
Setup difficultyeasyhardhard
Complexity1/54/54/5
Audiencedeveloperops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Installed with a single curl-to-bash one-liner, no separate configuration required.

Wtf does this do

token-diet is a small tool that makes AI coding assistants like Claude Code, Codex, Cursor, Windsurf, and Cline write less while still doing the same job correctly. AI coding tools are billed by the number of words, or tokens, they read and write, so cutting unnecessary text directly lowers the cost of using them, and the author reports an average bill reduction of around 31 percent across real test sessions, with no drop in correctness. It works by installing an always-on instruction set that tells the AI assistant to skip filler language, such as opening with Sure, here's the answer, or closing with let me know if you need anything else, and instead lead straight with the answer. The same philosophy applies across the whole session: documentation and comments get trimmed to only what is needed, tests focus on the important and risky cases instead of an exhaustive list, code is written to match exactly what was asked without extra unused pieces, and the assistant is encouraged to read only the specific lines it needs from a file rather than the whole thing. Correctness, full error messages, and exact commands are explicitly protected from being trimmed, so the assistant should never sacrifice accuracy just to save words. There are a few levels you can choose from: the full default behavior, a lighter mode that only trims conversational replies, a very terse mode for chat and progress updates while keeping code and tests precise, or turning it off entirely. Installing it is a single command that downloads and runs a script, which detects which coding assistant you have installed and sets things up automatically, either for your whole system or for a single project. Because these tools normally only load extra instructions when asked, the installer works around that by placing its instructions somewhere each supported tool always reads at the start of a session.

Yoink these prompts

Prompt 1
Install token-diet for Claude Code and set it to the default always-on mode.
Prompt 2
Explain the difference between token-diet's lite and ultra modes.
Prompt 3
How does token-diet make its instructions load automatically every session?
Prompt 4
Show me the before-and-after token savings example from the token-diet README.

Frequently asked questions

wtf is token-diet?

A skill that makes AI coding assistants like Claude Code and Cursor write less filler, cutting token costs by about 31% on average with no loss of correctness.

What language is token-diet written in?

Mainly Shell. The stack also includes Shell, Claude Code, Codex.

How hard is token-diet to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is token-diet for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.