tokless

README

Save tokens on AI coding agents — no performance loss.

One tool, no config — works the moment it lands.

📅 Next week plan (22/6 - 28/6)
Fix Codex & AGY hooks for better MCP (codegraph + context-mode) compliance rate Add Pi support Add Cursor support

Introduction

Saving tokens shouldn't be complicated. Many great plugins exist to help coding agents save context and perform better — but setting them up and keeping them updated is hard, especially for non-technical users.

tokless is the lazy solution. One command, pick your agent, restart — IDE and CLI both wired. Cross-platform: macOS, Linux, Windows. No config, no manual edits, re-runnable.

Supported Agents

Claude Code Anthropic

OpenCode anomalyco

Codex OpenAI

Antigravity Google

Each agent wired per its own config spec. Pick one, some, or all:

tokless                              # interactive: pick agents
tokless --agents claude,opencode     # wire just these
tokless --agents claude,opencode,codex,antigravity  # all

Tools

Tool	What it does	Example
RTK	Trims noisy bash/tool output	ls -la 45 lines (~800 tok) → rtk ls 12 lines (~150 tok)
Caveman	Makes the agent answer in terse prose	69-tok explanation → 19-tok answer (useMemo)
CodeGraph	Query a code graph, skip whole-file reads	1 codegraph explore call = 0 file reads on 25,874-file repo
Context-Mode	Run heavy work in a sandbox, return only what matters	700KB log → 3KB summary, raw bytes never enter context

Each tool from official source. Each targets a different waste source — no overlap, no conflict.

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/HoangP8/tokless/main/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/HoangP8/tokless/main/scripts/install.ps1 | iex

Commands

tokless              Install + wire everything (default; safe to re-run)
tokless update       Show version diff, upgrade the four tools
tokless doctor       Show what's wired; warn about broken bits
tokless uninstall    Remove everything tokless touched
tokless self-update  Update the tokless CLI itself

Flags:

--agents <list>   Subset: claude,opencode,codex,antigravity
--dry-run         Preview, no writes
--verbose         Every step

Restart agents after install so they pick up new config.