TOON Context Compression
Pipe any command output through toon to compress JSON and save ~40% tokens.
Usage
# API responses
curl -s "https://api.example.com/data" | toon
# JSON files
cat data.json | toon
# Any command - safe on non-JSON (passes through unchanged)
some_command | toon
Install
# Copy script to PATH
cp scripts/toon ~/.local/bin/
chmod +x ~/.local/bin/toon
Requires: npx (Node.js)
Example
[{"id":1,"name":"Alice"},{"id":2,"name":"Bob"}]
→
[2]{id,name}:
1,Alice
2,Bob
When to Use
- Always when fetching JSON APIs
- Always when reading JSON files into context
- Safe to use on any output — non-JSON passes through
Reference
- Format spec: https://toonformat.dev
- CLI:
@toon-format/cli