How alexgreensh/token-optimizer works
Token Optimizer is a cross-platform assistant plugin that reduces context waste, preserves session work, and reports usage and savings. The main workflow is: an assistant session triggers hooks; measurement and optimization features act on tool/context events; compaction checkpoints and restores continuity; and audits or dashboards summarize results. Platform-specific integrations extend that workflow, while OpenCode and OpenClaw provide substantial native plugin implementations. Evidence is limited to the README and supplied excerpts/SOURCE INDEX; some subsystem links are therefore omitted rather than inferred.
Main entry points: posttooluse_runner.py Tool Hooks · measure.py Measure & Audit · sessionstart_runner.py Session Hooks · index.ts OpenCode Plugin
Components 22
Hook Runtime
- Session Hooks
hooks/sessionstart_runner.py - Tool Hooks
hooks/posttooluse_runner.py
Optimization Features
- Read Cache
skills/token-optimizer/scripts/read_cache.py - Output Compression
skills/token-optimizer/scripts/bash_compress_hook.py - Checkpoint & Restore
skills/token-optimizer/scripts/measure.py - Session Continuity
skills/token-optimizer/scripts/lean_resume_carry.py - Context Intelligence
skills/token-optimizer/scripts/context_intel.py - Model Routing
skills/token-optimizer/scripts/routing_advisor.py - Waste Detectors
skills/token-optimizer/scripts/detectors/registry.py
Measurement & Insights
- Measure & Audit
skills/token-optimizer/scripts/measure.py - Session State
skills/token-optimizer/scripts/session_store.py - Dashboard & Reports
skills/token-optimizer/scripts/_measure/dashboard.py
Platform Integrations
- OpenCode Plugin
opencode/src/index.ts - OpenCode Session Store
opencode/src/storage/session-store.ts - Fresh Session Nudge
opencode/src/nudges/fresh-session-nudge.ts - OpenClaw Plugin
openclaw/src/index.ts - Session Parser
openclaw/src/session-parser.ts - Model Pricing
openclaw/src/pricing.ts - OpenClaw Dashboard
openclaw/src/dashboard.ts - Pi Extension
pi/extensions/token-optimizer.ts
Other components
- Assistant User
- Coding Assistant
Connections 22
- Assistant User → Coding Assistant: uses
README.md - Coding Assistant → Session Hooks: fires session events
README.md - Coding Assistant → Tool Hooks: fires tool events
README.md - Session Hooks → Measure & Audit: dispatches
hooks/sessionstart_runner.py - Session Hooks → Read Cache: initializes cache
hooks/sessionstart_runner.py - Tool Hooks → Read Cache: invokes
hooks/posttooluse_runner.py - Tool Hooks → Measure & Audit: invokes
hooks/posttooluse_runner.py - Tool Hooks → Output Compression: invokes
hooks/posttooluse_runner.py - Tool Hooks → Context Intelligence: invokes
hooks/posttooluse_runner.py - Tool Hooks → Session State: uses
- Measure & Audit → Session State: records session state
- Measure & Audit → Dashboard & Reports: produces reports
- Coding Assistant → Checkpoint & Restore: compacts context
README.md - Checkpoint & Restore → Session Continuity: restores work
README.md - Coding Assistant → Model Routing: receives nudges
README.md - Coding Assistant → Waste Detectors: analyzes behavior
README.md - OpenCode Plugin → OpenCode Session Store: creates session store
opencode/src/index.ts - OpenCode Plugin → Fresh Session Nudge: registers nudge
opencode/src/index.ts - OpenClaw Plugin → Session Parser: parses sessions
openclaw/src/index.ts - Session Parser → Model Pricing: calculates cost
openclaw/src/session-parser.ts - OpenClaw Plugin → OpenClaw Dashboard: builds dashboard
openclaw/src/index.ts - Coding Assistant → Pi Extension: runs extension
README.md