tokless

A unified pipeline for efficient and effective coding agents.

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

Introduction

Many great packages make coding agents more effective and efficient — but discovering, installing, updating, and unifying them is painful, especially for non-technical users. The best tools exist; the wiring is the real cost.

tokless — the lazy one-command solution.

Installation (Manual)

Supported platforms: macOS/Linux x64 or arm64; Windows x64.

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

Installation (Agent)

Let your coding agent install tokless, choose what to configure, and verify the result:

https://raw.githubusercontent.com/HoangP8/tokless/main/docs/installation.md

Agents

Interactive install detects installed supported agents; choose one, some, or all:

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

Included Tools

tokless combines focused agent rules with installed tools, exposing only the core MCP surface by default.

Package	⭐	Purpose
karpathy-skills		Coding principles: think first, simplify, edit surgically, verify.
caveman		Terse response rules that preserve technical accuracy.
ponytail		Minimal-code rules: reuse first, avoid speculative work.
rtk		Filters command output before it reaches the agent.
codegraph		Indexed code graph for source, call paths, and impact.
context-mode		Sandboxed context tools with session memory and focused analysis.

Callable MCP surface

Tools
├── CodeGraph · 1/1 tool
│   └── codegraph_explore
└── Context-Mode · 6/11 upstream tools
    ├── ctx_execute
    ├── ctx_batch_execute
    ├── ctx_execute_file
    ├── ctx_index
    ├── ctx_search
    └── ctx_fetch_and_index

Configuration

tokless manages agent config and instruction blocks; not every item uses native config.

Instruction means tokless-owned static rules. tokless update refreshes them.

Usage

tokless              Install tools, then pick detected agents (safe to re-run)
tokless update       Update the tokless CLI, then show version diff and upgrade tools
tokless doctor       Show what's wired; warn about broken bits
tokless info         Show how tokless was installed, plus paths and config locations
tokless index        Build per-project codegraph indexes
tokless disable      Disable one or more agents
tokless uninstall    Remove everything tokless touched
tokless self-update  Update the tokless CLI itself
tokless --version    Print tokless version
tokless --help       Show all commands and flags

Flags:

--agents <list>   Subset: claude,opencode,codex,antigravity,copilot,droid,pi
--tools <list>    Subset: rtk,caveman,ponytail,codegraph,context-mode
--dry-run         Preview, no writes
--verbose         Every step
--yes             Skip confirmations

Restart agents after install so they pick up new config.