{"id":"alexgreensh-token-optimizer","name":"token-optimizer","homepage":null,"repo_url":"https://github.com/alexgreensh/token-optimizer","category":"devtools","subcategories":[],"tags":["ai-ml","devtools","context-window","token-optimization","claude-code-plugin","openclaw-plugin"],"what_it_does":"Token Optimizer is a local (external Python) tool/plugin that audits and reduces “ghost tokens” in Claude Code / OpenClaw sessions by measuring context degradation, detecting wasted/duplicate content, tracking compaction loss, and providing checkpoint/restore and archival tooling for tool results.","use_cases":["Diagnose context/window overhead (“ghost tokens”) in Claude Code sessions","Improve prompt efficiency by blocking redundant file reads and ignoring files via .contextignore","Measure session quality drift over time (7-signal quality score and efficiency grading)","Recover from compaction by restoring checkpoints and expanding archived tool results","Analyze and trim large JSONL session artifacts and detect duplicates (tooling utilities)","Restructure CLAUDE.md to improve attention placement (attention-optimize)"],"not_for":["Producing a hosted, centrally-managed analytics service (it appears to run locally per platform)","Security-critical workflows where you must guarantee zero data retention on remote services (the README does not provide such guarantees)","Environments where you cannot execute the provided installer script (curl | bash)"],"best_when":"You frequently run long Claude Code / OpenClaw sessions with heavy custom skills/MCP/tooling overhead and you experience fast context degradation or frequent compactions.","avoid_when":"You cannot allow local filesystem access/read-cache/archival artifacts, or you need strict governance on code execution (e.g., disallowing bash installers).","alternatives":["Prompt/context optimization via manual auditing and prompt caching strategies in the client tool","Generic context management tools that manage file inclusion/exclusion without session-quality scoring","Custom scripts that trim/ignore files and deduplicate context artifacts"],"af_score":46.2,"security_score":29.0,"reliability_score":35.0,"package_type":"skill","discovery_source":["openclaw"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:43:30.202191+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"No authentication mechanism is described for Token Optimizer itself; it appears to operate as a plugin/script alongside Claude Code/OpenClaw and external Python tooling."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Pricing for the package is not provided in the provided content."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":46.2,"security_score":29.0,"reliability_score":35.0,"mcp_server_quality":0.0,"documentation_accuracy":55.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":90.0,"rate_limit_clarity":20.0,"tls_enforcement":50.0,"auth_strength":20.0,"scope_granularity":0.0,"dependency_hygiene":40.0,"secret_handling":40.0,"security_notes":"README claims execution as an external Python process and provides features like caching, reading, and archiving tool results to disk, but it does not describe threat model, data handling/retention, TLS usage specifics, or secret redaction practices. curl|bash installer increases supply-chain risk if not pinned/verified. Authentication/scoping for any network API is not applicable/unspecified.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":40.0,"error_recovery":55.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Installer uses a curl|bash approach; automated agents should prefer pinned, reviewed installation steps when possible.","Behavior depends on environment variables/config (e.g., read-cache modes); ensure correct settings per environment.","Local caching/archival implies filesystem artifacts; agents should clean up or manage storage if running many sessions."]}}