Claude Code mod

token-optimizer

The Token Optimizer status bar on its own, for its tests. It ships inside the token-optimizer plugin.

2,826 starsContext & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/alexgreensh/token-optimizer.git
claude --plugin-dir ./token-optimizer/desktop/token-optimizer-desktop

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L2Writes or runs: runs processes, drives Claude, reads files, reads env vars, reads mod state, persists state, draws
Sees
classic hooks, every prompt, every tool call, subagent spawns, compaction
Draws in
AbovePrompt
Hooks
session.startclassic.SessionStartprompt.submitturn.startturn.steptool.callagent.spawnclassic.PermissionRequestsession.compactturn.completeui.render

From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.

How Claude Code mods work

  • A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
  • It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
  • Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
  • Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Claude Code docs

Details

Repository
alexgreensh/token-optimizer
Folder
desktop/token-optimizer-desktop
Author
Alex Greenshpun
Type
Context & usage mods
License
NOASSERTION
Last updated
1 November 2026
Listed in
awesome-claude-code-mods

FAQ

What is token-optimizer?

The Token Optimizer status bar on its own, for its tests. It ships inside the token-optimizer plugin. It is a mod for Claude Code, from alexgreensh/token-optimizer on GitHub.

What can the token-optimizer mod access?

Its widest reach is "writes or runs" (runs processes, drives Claude, reads files, reads env vars, reads mod state, persists state, draws). It sees classic hooks, every prompt, every tool call, subagent spawns, compaction. It draws in AbovePrompt. Like any mod, it runs with your permissions.

How do I install token-optimizer?

Clone alexgreensh/token-optimizer and start Claude Code with --plugin-dir pointing at the mod's folder (desktop/token-optimizer-desktop).

Is token-optimizer popular?

alexgreensh/token-optimizer has 2,826 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 1 November 2026.

More context & usage mods

telemetry

154k

anthropics/claude-code

Plugin analytics: hooks $.telemetry's two events, so a plugin logs an event or marks a feature's use as a first-party row, sent in batches with the session's own credential.

Context & usage mods

ruflo-metaharness

80k

ruvnet/ruflo

MetaHarness integration for ruflo — surfaces score/genome/mint/mcp-scan/threat-model via skills; pairs with @metaharness/router (ADR-148/149) for cost-optimal model routing; honors ADR-150's architectural constraint that MetaHarness remains an optional augmentation, never a required runtime dependency. As a mod (ADR-445): confirms flywheel promotion, keeps secrets out of inputs, /metaharness-mod, and a status file the console shows

Context & usage mods/plugin install

context-inspector

1.1k

YeonwooSung/my-claude-code-mods

Context waste analyzer for Claude Code: what fills the window, re-reads, near-duplicate outputs, what compaction kept, advice

Context & usage mods/plugin install

ruflo-loop-workers

80k

ruvnet/ruflo

Cache-aware /loop workers and CronCreate background automation — wraps 5 hooks_worker-* MCP tools (list/dispatch/status/detect/cancel) and exposes 12 background worker triggers (ultralearn, optimize, consolidate, predict, audit, map, preload, deepdive, document, refactor, benchmark, testgaps). As a mod (ADR-445): a per-session dispatch cap, no secrets in worker context, /loop-mod, and a status file the console shows

Context & usage mods/plugin install

ruflo-mods

80k

ruvnet/ruflo

ruflo as a Claude Code mod (function hooks, ADR-404): in-process prompt routing, edit learning signals, tighten-only tool checks from ruflo policy, the cost-tracker budget ladder, a mod trust gate for newly installed mods, and the $.ruflo noun other mods compose their status with. Opt-in and removable: the classic hook-handler hooks stay the default and take every event back whenever the mod is not loaded.

Context & usage mods/plugin install

jev-auto-compact

444

notque/vexjoy-agent

Jev-powered verbatim compaction: once context reaches 60%, prunes stale tool calls with zero generation. Skips (never falls back to the LLM summarizer) when nothing is prunable; records evidence for learning.db.

Context & usage mods/plugin install

Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.