nagisanzenin/effortmining — explained in plain English
Analysis updated 2026-05-18
Automatically reduce token spend by matching each Claude Code subagent's reasoning effort to its task difficulty.
Classify a multi-part task and dispatch each part to the cheapest effort tier proven sufficient for it.
Re-run the benchmark suite to measure token savings on your own account.
Refit the effort lookup table for a different Claude model.
| nagisanzenin/effortmining | autolearnmem/automem | billy-ellis/exr-imageio-poc | |
|---|---|---|---|
| Stars | 32 | 32 | 32 |
| Language | Python | Python | Python |
| Setup difficulty | easy | hard | moderate |
| Complexity | 2/5 | 5/5 | 3/5 |
| Audience | developer | researcher | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires Claude Code and Python 3 with only the standard library.
This project is a plugin for Claude Code, the AI coding assistant, that changes how hard the helper AI agents it spawns have to think. Normally, when Claude Code creates a helper agent to do a small job, that helper copies the same reasoning effort setting as the main session, even if the job is something simple like reading a file or reformatting a list. Thinking harder costs more in AI usage, called tokens, so this wastes resources on easy tasks. The tool works by first classifying each subtask into a category, such as mechanical extraction, simple transformation, moderate reasoning, or hard reasoning, and then looking up the cheapest effort level that has been shown through testing to still produce correct results for that category. It then dispatches the helper agent at that specific effort level instead of the default. Because Claude Code does not let a user set effort per individual helper directly, the project works around this by shipping five nearly identical helper agent definitions, one for each effort level, and picking which one to use based on the classification. A lookup table stores which task category maps to which effort level, and that table was built from measured benchmark runs rather than guesswork. The project reports that in its own testing, using this calibrated approach used about 65 percent fewer output tokens than letting every helper inherit the main session's effort level, while getting correct answers just as often. It also includes tools to re-run these benchmarks and refit the lookup table for different AI models. Installing it requires Python 3 with no extra libraries, and it is added to Claude Code as a plugin from a marketplace command. Once installed, it works automatically from a new session without further setup. This is aimed at developers already using Claude Code who want to reduce their AI usage costs.
A Claude Code plugin that gives each helper AI agent only as much reasoning effort as its task actually needs, cutting token usage.
Mainly Python. The stack also includes Python, Claude Code, Claude Code Plugin.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.