// devtools · toon-format/toon

toon

TOON: a compact, human-readable serialization of JSON that saves tokens in LLM prompts

★ 25.5k stars⑂ 1.1k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

toon is an open-source dev tools project by toon-format (toon-format/toon on GitHub). It has 25,476 GitHub stars and 1,123 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
25,476
Forks
1,123
License
MIT
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want to achieve with toon and check the README on GitHub for requirements before installing.

  2. Get the code

    Clone the repository from GitHub (or take the packaged install route in step 3 if the README offers one).

  3. Install and configure

    Follow the project's documented install commands — the Run section below lists the exact ones — and add any required API keys or models.

  4. Run your first task

    Work through the README's quickstart example end to end, then adapt it to your own project or data.

// features

Why people love it

Token-efficient encoding

Benchmarks in the repo compare TOON against JSON on token efficiency across datasets.

Human-readable

Unlike binary formats, TOON stays readable and diffable in an editor.

Round-trip with JSON

Encode JSON to TOON for the prompt and decode model output back to JSON with the same tooling.

Library and CLI

Use the SDK in code, or the CLI for files and stdin/stdout pipelines (with a --stats flag showing token savings).

Retrieval-accuracy benchmarks

The project publishes retrieval accuracy results, not just size claims.

Clear guidance on limits

A 'When Not to Use TOON' section honestly covers cases where JSON is the better choice.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the TOON source, spec and benchmarks.

    git clone https://github.com/toon-format/toon.git
    cd toon
  2. Install the library or CLI

    Add the SDK to a project, or install the CLI globally.

    npm install @toon-format/toon
    npm install -g @toon-format/cli
  3. Encode your first file

    Convert a JSON file to TOON and check the token savings with --stats.

    npx @toon-format/cli data.json --stats
    npx @toon-format/cli input.json -o output.toon
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains toon?

toon is maintained by the toon-format organization/account on GitHub, together with open-source contributors, in the public repository toon-format/toon.

Is toon free to use?

Yes — the code is open source under the MIT license. You can use, modify and redistribute it under that license's terms.

Does toon need a paid API key?

No API key — TOON is a free, MIT-licensed format and toolset that runs locally.

How does toon compare to plain JSON / YAML in prompts?

JSON is universal but verbose; TOON trades a conversion step for materially fewer tokens on uniform structured data, while staying human-readable.

How do I get started with toon?

Clone the repository from GitHub, follow the install commands in the Run section (taken from the project's README), and complete the documented quickstart example before adapting it to your own use case.

// keep exploring

Similar tools

Dev Tools

headroom

Compress tool outputs, logs and RAG chunks before they reach the LLM — same answers, fewer tokens

★ 74.7k starsApache-2.0
View guide →
Dev Tools

no_human

From ticket to reviewed pull request — an autonomous coding pipeline on your machine.

★ 329 starsMIT
View guide →
Dev Tools

ray

An AI compute engine: a distributed runtime plus libraries for scaling ML and LLM workloads

★ 44.0k starsApache-2.0
View guide →
Dev Tools

skill-recorder

Skill Recorder: watch a human do a task once, then generate a reusable AI-agent skill from the recording

★ 4.2k starsMIT
View guide →
Dev Tools

agentacct

See what your coding agents did — and what each task cost in tokens.

★ 763 starsMIT
View guide →
Dev Tools

aicommit

Offline AI commit messages from your local LLM.

★ 47 starsMIT
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if toon is not the right fit.

Get toon

Free and open — grab the source, star the repo, and start creating.