Plugin

token-optimizer

Name: token-optimizer
Author: alexgreensh

Audit token waste and ghost tokens in Claude Code sessions and multi-agent systems like OpenClaw, fixing issues for 5-38% savings. Monitor context health with quick checks, dashboards, and process cleanups. Get coaching on efficient architectures and skill setups with dollar-cost estimates.

Component Overview

/health, /quick

Commands

Agents

fleet-auditor, token-coach +2

Skills

Stop, CwdChanged +17

Hooks

MCP Servers

LSP Servers

Output Styles

Install

npx claudepluginhub alexgreensh/token-optimizer --plugin token-optimizer

Component Details

Commands (2)

Session Health Check

/health

Check running Claude Code sessions, find zombies, offer to clean up safely

Quick Context Check

/quick

Quick 10-second context health check with quality score and top issues

Skills (4)

fleet-auditor

/fleet-auditor

Audit token waste across agent systems (Claude Code, OpenClaw, Hermes, OpenCode). Detect idle burns, model misrouting, and config bloat with dollar savings.

token-coach

/token-coach

Context window coach. Proactive guidance for token-efficient Claude Code projects, multi-agent systems, and skill architecture.

token-dashboard

/token-dashboard

Open the Token Optimizer dashboard. Collects latest session data, regenerates the dashboard, and opens it in your browser.

token-optimizer

/token-optimizer

Find the ghost tokens. Audit Claude Code setup, see where 25-38% of your context goes, fix it. Use when context feels tight.

Hooks (1)

Review workflow modifications before installing

Event Hooks

Bash

File writes

19 hooks across 10 events

README

Your AI is getting dumber and you can't see it.

Save tokens. Survive compaction. Measure the proof.

Most token tools only touch one slice of the problem.

They compress command output, which covers 15-25% of your context on a good day. The other 75-85% (bloated configs, unused skills, duplicate system prompts, stale memory, plus the 60-70% you lose on every compaction) goes untouched.

Token Optimizer covers all of it, keeps your work alive across compactions, measures whether the optimization actually helped, and gives you a live dashboard that shows every token, every dollar, and every turn, auto-updated after every session. Runs fully local. Zero context tokens used. Zero runtime dependencies.

Works on Claude Code and OpenClaw today. Windsurf, Cursor, and more on the way.

Token Optimizer Quick Scan

Install

Recommended on every platform (macOS, Linux, Windows):

/plugin marketplace add alexgreensh/token-optimizer
/plugin install token-optimizer@alexgreensh-token-optimizer

Then in Claude Code: /token-optimizer

Please enable auto-update after installing. Claude Code ships third-party marketplaces with auto-update off by default, and plugin authors cannot change that default. So you won't get bug fixes automatically unless you turn it on. In Claude Code: /plugin → Marketplaces tab → select alexgreensh-token-optimizer → Enable auto-update. One-time, 10 seconds, and you'll never miss a fix again. Token Optimizer also prints a one-time reminder on your first SessionStart so you don't forget.

Windows users: read this first

The plugin install above is the only path you should use on Windows. Do not also run the install.sh script described below — that's a bash installer for macOS/Linux/WSL, and combining the two creates an EBUSY: resource busy or locked error because Git Bash holds Windows file handles open while the plugin system is trying to clone.

Repo size note: our repo is ~3 MB (218 files, ~2,700 git objects). If your /plugin marketplace add attempt seems to be downloading gigabytes, it's not us — cancel and check whether Claude Code is cloning a different URL or network state. You can verify by cloning manually: git clone --bare https://github.com/alexgreensh/token-optimizer.git should finish in under a second and produce a ~2.6 MB directory.

If you've already hit the EBUSY error:

View full README on GitHub

Similar Plugins

qiushi-skill

2.8k

Qiushi Skill: methodology skills for AI agents guided by seeking truth from facts, with Claude Code, Cursor, OpenClaw, Codex, OpenCode, and Hermes guidance.

Stats

Version5.5.1

Stars567

Forks50

Installs5

MaintenanceExcellent

LicensePolyForm-Noncommercial-1.0.0

Last CommitApr 21, 2026

AddedMar 22, 2026

Actions

View on GitHub View README Plugin Marketplace JSON

Available In

alexgreensh-token-optimizer573

Safety Signals

Caution

Executes bash commands

Hook triggers when Bash tool is used

Modifies files

Hook triggers on file write and edit operations

Your AI is getting dumber and you can't see it.

Save tokens. Survive compaction. Measure the proof.

Most token tools only touch one slice of the problem.

Works on Claude Code and OpenClaw today. Windsurf, Cursor, and more on the way.

Token Optimizer Quick Scan

Install

Recommended on every platform (macOS, Linux, Windows):

/plugin marketplace add alexgreensh/token-optimizer
/plugin install token-optimizer@alexgreensh-token-optimizer

Then in Claude Code: /token-optimizer

Please enable auto-update after installing. Claude Code ships third-party marketplaces with auto-update off by default, and plugin authors cannot change that default. So you won't get bug fixes automatically unless you turn it on. In Claude Code: /plugin → Marketplaces tab → select alexgreensh-token-optimizer → Enable auto-update. One-time, 10 seconds, and you'll never miss a fix again. Token Optimizer also prints a one-time reminder on your first SessionStart so you don't forget.

Windows users: read this first

If you've already hit the EBUSY error:

token-optimizer

Component Overview

Install

Component Details

Commands (2)

Skills (4)

Hooks (1)

README

Your AI is getting dumber and you can't see it.

Install

Windows users: read this first

Similar Plugins

qiushi-skill

token-optimizer

Component Overview

Install

Component Details

Commands (2)

Skills (4)

Hooks (1)

README

Your AI is getting dumber and you can't see it.

Install

Windows users: read this first

Similar Plugins

qiushi-skill

claude-mem

caveman

ui-design

prompt-improver

nanobanana