Skip to content

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 packages help coding agents work more effectively and efficiently. The best tools already exist; wiring them well is the real work. Tokless brings together specialized tools, each with a distinct purpose, and manages them with minimal setup.

Clear purpose — best tool for each job, wired without conflict
No overload — minimal MCP tools with clear, unified instructions
Zero config — works as soon as installed, in under 30 seconds
One place — install, update, and manage all tools across every configured agent

AGENTS

Claude Code
Claude Code
✓ CLI + IDE + Desktop
OpenCode
OpenCode
✓ CLI + Desktop
Codex
Codex
✓ CLI + IDE + Desktop
Antigravity
Antigravity
✓ CLI + IDE
GitHub Copilot
GitHub Copilot
✓ CLI + IDE
Factory Droid
Factory Droid
✓ CLI + Desktop
Pi
Pi
✓ CLI
Cursor
Cursor
✓ CLI + IDE
Grok Build
Grok Build
✓ CLI
Kilo Code
Kilo Code
✓ CLI + IDE
Oh My Pi
Oh My Pi
✓ CLI
Cline
Cline
✓ CLI
     

Installation

Manual

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

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

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

Copy this for your agent

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

Tools

Popular packages with distinct roles, wired without conflicts.

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.
MCP Tools
├── CodeGraph · 1/1
│   └── codegraph_explore
└── Context Mode · 6/11
    ├── ctx_execute
    ├── ctx_batch_execute
    ├── ctx_execute_file
    ├── ctx_index
    ├── ctx_search
    └── ctx_fetch_and_index

Configuration

How each tool connects to each agent:

Instruction means static markdown instructions.

Tool Claude OpenCode Codex Antigravity Copilot Droid Pi Oh My Pi Grok Kilo Code Cline Cursor
rtkHook + AllowPluginHookHook + AllowHook + AllowHookExtensionExtensionGlobal PluginHookHook
cavemanInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstruction
ponytailInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstructionInstruction
codegraphMCP + Allow + InstructionMCP + InstructionMCP + InstructionHook + MCP + InstructionHook + MCP + InstructionHook + MCP + InstructionMCP + Extension + InstructionMCP + InstructionMCP + InstructionMCP + InstructionMCP + InstructionHook + MCP + Instruction
context-modeMCP + Allow + InstructionMCP + InstructionHook + MCP + InstructionMCP + InstructionMCP + Hook + InstructionMCP + InstructionMCP + Extension + InstructionMCP + InstructionMCP + InstructionMCP + InstructionMCP + InstructionMCP + Instruction

Note: ❌ Grok Build does not support RTK command rewriting yet.

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,grok,omp,cline,cursor
--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

An effective and efficient coding-agent setup in under 30 seconds: best tools, unified instructions, any OS.

Topics

Resources

Contributing

Stars

250 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages