whatisgithub

What is claude-code-eco?

sup3x/claude-code-eco — explained in plain English

Analysis updated 2026-05-18

25JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A Claude Code add-on that cuts wasted output tokens by 31-75 percent using frugality rules and optional lower reasoning effort, while keeping critical findings intact.

Mindmap

mindmap
  root((claude-code-eco))
    What it does
      Cuts wasted tokens
      Measures savings
      Publishes raw benchmarks
    Tech stack
      JavaScript
      Claude Code skills
      Shell scripts
    Use cases
      Long coding sessions
      Routine chores
      Cost control
    Audience
      Claude Code users
      Developers
      Cost conscious teams

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 build with it?

USE CASE 1

Install as a Claude Code plugin to reduce token usage on long coding sessions.

USE CASE 2

Use /eco-max on routine chores like renames and small fixes to save the most tokens.

USE CASE 3

Run the included benchmark script to measure token savings on your own tasks.

What is it built with?

JavaScriptClaude CodeShell

How does it compare?

sup3x/claude-code-eco0xpira/sskillsarulsebastin71/smartqueue
Stars252525
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

claude-code-eco is a tool that helps you spend less on Claude Code, the AI coding assistant, by cutting down on wasted output tokens. Its creator noticed that Claude Code often re-reads files it just edited, repeats diffs it already applied, and writes long explanations for small fixes. This project measures that waste and removes it, with 82 published benchmark runs showing the results, including cases where the approach did not help. The tool adds two commands you can use inside Claude Code: /eco and /eco-max. /eco applies a set of frugality rules that keep full reasoning depth but cut unnecessary padding from responses, typically reducing output tokens by 31 to 73 percent depending on the task. /eco-max goes further by also lowering the reasoning effort level for routine chores, cutting tokens by up to 75 percent, though this is an opt in tradeoff since it can reduce how many extra issues get caught. Testing showed that important warnings, like a bug that could crash code, were still reported reliably at low effort, while minor extra suggestions were the main thing left out. You can install it as a Claude Code plugin, as a personal skill available across all your projects, or by copying its skills folder into a single project. It works in any language you write in, since the underlying rules are in English but the replies follow your language. You activate it once per session by typing /eco or /eco-max, or just saying something like activate eco mode if slash commands are not available, such as in the mobile app. The project is written mainly in JavaScript and is aimed at developers who use Claude Code regularly and want to make their usage limits or API costs last longer. It is released under the MIT license and includes a benchmarks folder where anyone can rerun the same tests on their own tasks to check the claimed savings.

Copy-paste prompts

Prompt 1
Activate eco mode for this Claude Code session using claude-code-eco.
Prompt 2
Install the claude-code-eco plugin and explain how /eco differs from /eco-max.
Prompt 3
Run ./benchmarks/run.sh on my current task to compare token usage with and without eco mode.
Prompt 4
Set up permanent eco settings in my Claude Code settings.json using /eco setup.

Frequently asked questions

What is claude-code-eco?

A Claude Code add-on that cuts wasted output tokens by 31-75 percent using frugality rules and optional lower reasoning effort, while keeping critical findings intact.

What language is claude-code-eco written in?

Mainly JavaScript. The stack also includes JavaScript, Claude Code, Shell.

What license does claude-code-eco use?

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

How hard is claude-code-eco to set up?

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

Who is claude-code-eco for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.