git404hub

what is token-lean fr?

hurttlocker/token-lean — explained in plain English

Analysis updated 2026-05-18

7ShellAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A markdown-based discipline that teaches AI orchestrators to delegate bulk reading to cheaper agents instead of burning their own context window.

vibe map

mindmap
  root((token-lean))
    What it does
      Decisions only orchestration
      Delegation ladder
      Eight practices
    Tech stack
      Markdown skill
      Claude Code plugin
      Codex CLI profiles
    Use cases
      Lean orchestrator sessions
      Multi agent delegation
      Prompt caching discipline
    Audience
      AI agent builders
      Orchestrator developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Install the skill in Claude Code so it delegates file reading and bulk work to scout agents instead of doing it inline.

VIBE 2

Add the discipline to a Codex CLI AGENTS.md file to keep a long agent session's context window lean.

VIBE 3

Use the Claude Code plugin version to get real scout, worker, and adjudicator agents with a tripwire hook against excessive file reads.

what's the stack?

MarkdownClaude CodeCodex CLIShell

how it stacks up fr

hurttlocker/token-leandavorpa/shell-utilsmeetshahco/fora
Stars777
LanguageShellShellShell
Last pushed2021-09-18
MaintenanceDormant
Setup difficultyeasyeasy
Complexity2/51/5
Audiencedeveloperops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Install is a file copy, the fuller Claude Code plugin adds dispatchable agents and a hook beyond the base skill file.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

token-lean is a set of written instructions, not a program or a server, that teaches an AI orchestrator how to run a team of AI agents without wasting its own context window on bulk work. It is a single markdown file that any model or tool capable of reading markdown can use, including Claude Code, Codex CLI, Cursor, Gemini CLI, and custom agent setups. The core idea is one rule: never generate bulk, and never absorb bulk. Instead of the main orchestrating agent reading every file itself, it should delegate that reading to cheaper, smaller agents that hand back compact summaries, while the orchestrator focuses on making decisions from those summaries. The README lays out a ladder of roles: a scout that does lookups and surveys and reports back briefly, a worker that handles well specified mechanical edits, a builder that handles harder multi file work and judgment calls, and a panel of independent agents used when a single model's answer cannot be trusted alone. It also lists eight specific practices, such as sending a scout instead of reading more than three files yourself, keeping a stable prompt prefix so caching stays cheap, and writing repeated explanations into a permanent rules file instead of repeating them. Installation is mostly copying the instructions into the right place for your tool. For Claude Code it can be installed as a simple skill file, or as a fuller plugin that adds real dispatchable scout, worker, and adjudicator agents plus a hook that nudges the orchestrator after too many consecutive file reads. For Codex CLI, the same content can be pasted into an AGENTS.md file or installed as native equipment with profile configs. For Cursor, the same text goes into a project rule file. The README states this discipline was originally written by an AI model documenting its own working style, then generalized to work across different model families. It is released under the MIT license.

prompts (copy fr)

prompt 1
Install the token-lean skill in my Claude Code setup and explain how to invoke it.
prompt 2
Explain the difference between the scout, worker, builder, and panel roles in token-lean's ladder.
prompt 3
Show me how to add token-lean's discipline to a Codex CLI AGENTS.md file.
prompt 4
Help me apply token-lean's eight practices to my current multi-agent workflow.

Frequently asked questions

what is token-lean fr?

A markdown-based discipline that teaches AI orchestrators to delegate bulk reading to cheaper agents instead of burning their own context window.

What language is token-lean written in?

Mainly Shell. The stack also includes Markdown, Claude Code, Codex CLI.

What license does token-lean use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is token-lean to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is token-lean for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.