Home

tokenwright helps an AI coding agent spend fewer tokens on the same result. It is a plugin with four skills and two small command-line tools, tw.py and tidy.py.

Every token in an agent's context is sent again on each later turn. A file read early in a long session is paid for many times as cache reads, so the cheapest token is the one never loaded.

What it ships

• Four skills. tokenwright holds the habits, the levers and a waste vocabulary. tokenwright-script turns a repeating or solved job into a script. tokenwright-skills reviews a skill or plugin for token cost. tokenwright-catalog (formerly skill-tidy) lints and de-conflicts the whole skill catalog and parks rarely used skills. See Skills.
• tw.py. One standard-library Python file with seven commands: changed, score, repeats, skill, estimate, catalog and hook. catalog forwards to tidy.py. See Commands.
• Two hooks, off by default. They warn about, or block, whole reads of large files and very large tool output. See Hooks.

Where to start

• Getting started: install it and run your first command.
• Commands: every tw.py command, with real output.
• FAQ: what the numbers mean and what they do not.