Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

272 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tokless

A unified pipeline for efficient and effective coding agents.

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

version platform license


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.

✔️Best packages, unified — picks the most effective, efficient tools and wires them without conflicts
✔️One command, done — pick your agent, restart, go
✔️All platforms — macOS, Linux, Windows
✔️Zero config — everything wired, no manual edits
✔️Simple updatestokless update upgrades everything in one shot
✔️Non-tech friendly — under 30 seconds, anyone can do it

Installation (Manual)

install

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

Claude Code
Claude Code
✓ Supported
OpenCode
OpenCode
✓ Supported
Codex
Codex
✓ Supported
Antigravity
Antigravity
✓ Supported
GitHub Copilot
GitHub Copilot
✓ Supported
Factory Droid
Factory Droid
✓ Supported
Pi
Pi
✓ Supported
Cursor
Cursor
In progress
Grok Build
Grok Build
In progress
Kilo Code
Kilo Code
In progress
Oh My Pi
Oh My Pi (OMP)
In progress
Cline
Cline
In progress
     

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.

Tool Claude OpenCode Codex Antigravity Copilot Droid Pi
rtk Hook + Allow Plugin Hook Hook + Allow Hook + Allow Hook Extension
caveman Instruction Instruction Instruction Instruction Instruction Instruction Instruction
ponytail Instruction Instruction Instruction Instruction Instruction Instruction Instruction
codegraph MCP + Allow + Instruction MCP + Instruction MCP + Instruction Hook + MCP + Instruction Hook + MCP + Instruction Hook + MCP + Instruction MCP + Extension + Instruction
context-mode MCP + Allow + Instruction MCP + Instruction Hook + MCP + Instruction MCP + Instruction MCP + Hook + Instruction MCP + Instruction MCP + Extension + Instruction

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.

About

A unified toolkit for efficient and effective coding agents (Karpathy principles, Caveman, Ponytail, RTK, CodeGraph, Context-Mode). Minimal setup under 30 seconds. Any OS.

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages