T

token-optimizer

Cut token usage 60-90% with caching, compression, and smart file tools — diff-only re-reads, paths-only search, out-of-context stashing, and a per-tool savings report for Codex and Claude Code.

ooples/token-optimizer · v7.4.2 · Development & Workflow

ooplesreview
InstallSourceClaim this plugin
71Follow0

Trust Score

71

Security

71

Surfaces

2

What is token-optimizer?

token-optimizer is a published development & workflow plugin for AI coding agents in the claude-code ecosystem, developed by ooples and distributed through the HOL AI plugin registry. Cut token usage 60-90% with caching, compression, and smart file tools — diff-only re-reads, paths-only search, out-of-context stashing, and a per-tool savings report for Codex and Claude Code.

Canonical slug
ooples/token-optimizer
Version
v7.4.2 · updated Oct 9, 2026

Trust & Reputation

HOL Trust Score
71

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
76pts
Maintenance
0pts
MCP Posture
100pts
Plugin Security
71pts
Provenance
70pts
Publisher Quality
75pts

Registry Snapshot

Publisher verification
No
Marketplace source
Unknown
Scanner
Broker fallback
Safety label
review
Digest verified
Yes
1 bundled skill — copy or download SKILL.mdOpen skills

Trust & reputation

Trust & Reputation

HOL Trust Score
71

Factor Analysis

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
76pts
Maintenance
0pts
MCP Posture
100pts
Plugin Security
71pts
Provenance
70pts
Publisher Quality
75pts

Provenance

Plugin root
integrations/codex/plugin
Source repo
https://github.com/ooples/token-optimizer-mcp
Source commit
07362fe02a6e…
Publisher verified
No
Owner verified
Not owner verified

Continuous scanner CI detected

No action is required. This plugin receives the full trust score.

Verified badge not detected

Add the HOL verified badge to the repository README to score +2% trust. Plugin owners can open that pull request from Guard Plugins.

Security Posture

review
Safety label
71
Security score
0
High findings
Provider
registry-broker-fallback
Grade
C · review
Version
Unknown
cisco-skill-scanner: unknown

Findings

mediumpublishabilitypublishability.link.missing.privacyPolicyURL

privacyPolicyURL should be present for marketplace readiness.

mediumpublishabilitypublishability.link.missing.termsOfServiceURL

termsOfServiceURL should be present for marketplace readiness.

lowoperational-securitysupply-chain.lockfile-missing

Repository snapshot does not include a lockfile.

infoskill-securityskill-scan.unavailable

Cisco skill scanner timed out after 60000 ms

token-optimizer — Frequently asked questions

What is token-optimizer?
token-optimizer is an AI plugin in the HOL registry. Cut token usage 60-90% with caching, compression, and smart file tools — diff-only re-reads, paths-only search, out-of-context stashing, and a per-tool savings report for Codex and Claude Code.
How do I install token-optimizer?
Install token-optimizer in your harness: Codex — codex plugin marketplace add ooples/token-optimizer-mcp; Claude Code — /plugin marketplace add ooples/token-optimizer-mcp; Any agent — npx skills add ooples/token-optimizer-mcp. Full step-by-step guidance is on the HOL plugin page.
How do I install token-optimizer in Codex?
To install token-optimizer in Codex, start with codex plugin marketplace add ooples/token-optimizer-mcp. The complete step-by-step install guide for Codex is on the HOL plugin page.
How do I install token-optimizer in Claude Code?
To install token-optimizer in Claude Code, start with /plugin marketplace add ooples/token-optimizer-mcp. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
Is token-optimizer free?
Pricing for token-optimizer is published on its HOL plugin page when the maker schedules a launch.
Who publishes token-optimizer?
token-optimizer is published by ooples and listed on HOL.
Is token-optimizer available now?
token-optimizer availability is listed on its HOL plugin page.

Install Guidance

Install in Claude Code

Install through the Claude Code plugin marketplace.

Claude Code plugin docs
  1. 1

    Add the marketplace

    Run this inside a Claude Code session.

    claude code
  2. 2

    Install the plugin

    Use the plugin name and the marketplace name shown by the previous command.

    claude code
  3. 3

    Scripted alternative

    Non-interactive equivalent for scripts and CI pipelines. Add --scope project to pin the install to one repository.

    shell

Plugin Manifest

{
  "name": "token-optimizer",
  "version": "7.4.2",
  "description": "Context-window optimization: caching, compression, and smart file tooling that cut token usage 60-90%.",
  "author": {
    "name": "ooples",
    "url": "https://github.com/ooples"
  },
  "homepage": "https://github.com/ooples/token-optimizer-mcp#readme",
  "repository": "https://github.com/ooples/token-optimizer-mcp",
  "license": "MIT",
  "keywords": [
    "token-optimization",
    "context-window",
    "caching",
    "compression",
    "mcp"
  ],
  "skills": "./",
  "mcpServers": "./.registry/mcp.json",
  "interface": {
    "displayName": "Token Optimizer",
    "developerName": "ooples",
    "shortDescription": "Cut token usage 60-90% with caching, compression, and smart file tools.",
    "longDescription": "Bundles the token-optimizer MCP server plus a usage skill. smart_read returns diffs on re-reads, smart_glob returns paths only, optimize_session stashes bulky output out-of-context, and get_optimization_report shows total tokens saved.",
    "category": "Productivity",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://github.com/ooples/token-optimizer-mcp",
    "defaultPrompt": [
      "Use token-optimizer smart_read to re-read this large file as a diff.",
      "Show my token savings with get_optimization_report."
    ]
  },
  "holManifestOrigin": "repository",
  "registryIndexVersion": 5
}

Marketplace Source

Repo URL
https://github.com/ooples/token-optimizer-mcp
Marketplace path
Unknown
Source path
plugins/ooples/token-optimizer-mcp
Install policy
AVAILABLE

Skills

1 SKILL.md file ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

Share
skills-cli

  • token-optimization

    skills/token-optimization/SKILL.md

    Use the token-optimizer MCP tools to reduce context/token usage when reading, searching, or editing files, or when the context window is filling up. Trigger when reading large files, re-reading files already seen, searching a big/unknown tree, making edits to large files, or when you need to store bulky output out-of-context.

    Raw SKILL.md

File Inventory

.codex-plugin/plugin.json

plugin-manifest

1,238 bytes

fa64bc7440067c1e…

.mcp.json

file

228 bytes

dd5b38d3f8952375…

.registry/mcp.json

mcp-config

167 bytes

78964276531e3fe1…

hooks/hooks.json

file

2,027 bytes

2a77b7a8669469f7…

hooks/lib/adapter.mjs

file

71,679 bytes

db7014ade06f4631…

hooks/lib/advise.mjs

file

22,111 bytes

4af77505552db8ec…

hooks/lib/audit.mjs

file

22,045 bytes

5184adef0f12669b…

hooks/lib/authored.mjs

file

6,191 bytes

b02c7f3e59d8e57c…

hooks/lib/cache.mjs

file

16,747 bytes

4ee7915b49a1e1d4…

hooks/lib/calibration.mjs

file

12,166 bytes

fda9ef590c813c7d…

hooks/lib/capabilities.mjs

file

42,054 bytes

0bb44ed1d211f5e2…

hooks/lib/compact-stage.mjs

file

6,069 bytes

a3cd3ba52f538e21…

hooks/lib/compact.mjs

file

6,070 bytes

1179d329755bc3b6…

hooks/lib/consolidate.mjs

file

10,366 bytes

97abfe912447a475…

hooks/lib/crosslayer.mjs

file

17,915 bytes

7099b24c0758959e…

hooks/lib/curate.mjs

file

23,934 bytes

5c35ea83bd6d4e3a…

hooks/lib/decide.mjs

file

44,708 bytes

d6b4590d4e188a3c…

hooks/lib/derive.mjs

file

58,915 bytes

f0f54e6ae9303abb…

hooks/lib/disclose.mjs

file

41,818 bytes

54eca37136075fb4…

hooks/lib/doctor.mjs

file

88,935 bytes

da2e14196665874b…

hooks/lib/expand.mjs

file

20,243 bytes

16fe08c49a91914a…

hooks/lib/experiment.mjs

file

6,013 bytes

6afe2637d0e8e592…

hooks/lib/flags.mjs

file

2,002 bytes

a68d0e7337347329…

hooks/lib/fleet.mjs

file

22,765 bytes

cb10ada2514e7642…

hooks/lib/forecast.mjs

file

21,444 bytes

e737051fb9f358fd…

hooks/lib/harvest-worker.mjs

file

11,935 bytes

0c49a4f6482d542d…

hooks/lib/harvest-write.mjs

file

39,871 bytes

78975bcdccc75e20…

hooks/lib/harvest.mjs

file

45,853 bytes

57bb78fd0b5840b8…

hooks/lib/inject.mjs

file

68,381 bytes

da9cbee8f61561ba…

hooks/lib/keepwarm.mjs

file

25,306 bytes

2206641afb29aec8…

hooks/lib/lessons.mjs

file

13,248 bytes

8146856b9184259d…

hooks/lib/lexical.mjs

file

7,952 bytes

99a053e6484a5ba0…

hooks/lib/loo.mjs

file

34,052 bytes

5b6f7e7533c146f6…

hooks/lib/manifest.mjs

file

7,717 bytes

e9c47828313ac767…

hooks/lib/metrics.mjs

file

82,086 bytes

1e178282e57f31d6…

hooks/lib/observability.mjs

file

20,995 bytes

fae5af373c9341c2…

hooks/lib/paths.mjs

file

9,484 bytes

4527ed4e5e05c785…

hooks/lib/pending.mjs

file

23,770 bytes

44104d8816dd6072…

hooks/lib/policy.mjs

file

44,266 bytes

0d67937d9cab1f79…

hooks/lib/pricing.mjs

file

2,703 bytes

b6217f4e6291233f…

hooks/lib/projects.mjs

file

8,955 bytes

6c57369f3175e0d9…

hooks/lib/recall.mjs

file

16,774 bytes

57e82b84bccfe585…

hooks/lib/recording.mjs

file

8,927 bytes

a1f6b961622d2d36…

hooks/lib/redact.mjs

file

2,419 bytes

fb32e9beb413e32d…

hooks/lib/remedy.mjs

file

11,662 bytes

286eab0226c8712c…

hooks/lib/restore.mjs

file

8,455 bytes

ca336e578f9189c2…

hooks/lib/rewrite.mjs

file

30,068 bytes

af5c4c28cd3802a2…

hooks/lib/routing.mjs

file

17,111 bytes

2a8049942a2b3908…

hooks/lib/safe-text.mjs

file

6,793 bytes

df331940f2fa8b75…

hooks/lib/seed.mjs

file

11,758 bytes

990f00f58b1cce29…

hooks/lib/skeleton.mjs

file

8,479 bytes

f5dcb73b4740284f…

hooks/lib/staleness.mjs

file

72,238 bytes

0f9166bcab63bb9c…

hooks/lib/standing.mjs

file

15,055 bytes

b85f77f22875ea3a…

hooks/lib/stop-harvest.mjs

file

15,224 bytes

ba546121e06ed673…

hooks/lib/substitute.mjs

file

8,112 bytes

a28f6abb075cef0d…

hooks/lib/surface.mjs

file

10,297 bytes

55f00f86e2ab3629…

hooks/lib/symbols.mjs

file

11,289 bytes

6bf009edd0eb8ede…

hooks/lib/transcript.mjs

file

21,987 bytes

eb76cac92a2740c2…

hooks/lib/ucr-guard.mjs

file

4,382 bytes

1471f27e0c56df64…

hooks/lib/usage.mjs

file

16,835 bytes

3106f35af7f05d3b…

hooks/lib/utility.mjs

file

5,004 bytes

1910ac63acebcb44…

hooks/lib/waste.mjs

file

14,429 bytes

1c62b0bf8f7d643c…

hooks/lib/wiki.mjs

file

58,314 bytes

503db1b12b8369e2…

hooks/lib/wire.mjs

file

12,710 bytes

76d34ea8899d549c…

hooks/post-tool.mjs

file

3,251 bytes

a8776b2de9610b15…

hooks/pre-tool.mjs

file

3,249 bytes

c33330b619b7ec9d…

hooks/session-start.mjs

file

3,259 bytes

41e2e6ef5b9fb1cb…

hooks/stop.mjs

file

3,241 bytes

4d53a5f27cf562c4…

skills/token-optimization/SKILL.md

skill

4,493 bytes

ac4b52e7029efbce…