Skip to content

HoangP8/tokless

Repository files navigation

tokless

Save tokens on AI coding agents — no performance loss.

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

version platform license

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
Claude Code
Anthropic
OpenCode
OpenCode
anomalyco
Codex
Codex
OpenAI
Antigravity
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

4 tools, each kills a different token waste source

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

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.

About

A unified CLI to install and update token-saving plugins — RTK, Caveman, CodeGraph, and Context-Mode — for Claude Code, OpenCode, Codex, and Antigravity. Minimal setup. Any OS.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages