From token-saver
Configures token-saver compression thresholds, checks session stats, enables debug logging, and troubleshoots processors for git, docker, terraform, npm, pytest, and more.
npx claudepluginhub ppgranger/token-saver --plugin token-saverThis skill uses the workspace's default tool permissions.
Run `token-saver stats` to see compression statistics for the current and all sessions.
Monitors Headroom proxy for Claude Code sessions, reports compression stats, token savings, and context window usage. Troubleshoots proxy health and connection issues.
Optimizes responses for token efficiency using compression levels, concise techniques, code-only outputs, and diff formats in high-volume sessions, repetitive tasks, and cost-sensitive projects.
Optimizes Claude Code sessions for Max-plan token limits through response compression, tool output filtering, drift protection, and planning for broad tasks. Useful for quota management and efficiency.
Share bugs, ideas, or general feedback.
Run token-saver stats to see compression statistics for the current and all sessions.
Token-saver config is stored in ~/.token-saver/config.json. Available settings:
min_lines: minimum output lines to trigger compression (default: 5)min_chars: minimum output chars to trigger compression (default: 200)chars_per_token: ratio for token estimation (default: 3.5)wrap_timeout: max seconds for command execution (default: 30)To modify: token-saver config set min_lines 10
Set TOKEN_SAVER_DEBUG=true environment variable to enable debug logging to ~/.token-saver/hook.log.
Token-saver includes processors for: git, gh (GitHub CLI), docker, kubectl, terraform, npm/pip/cargo, test runners (pytest, jest, go test), linters (eslint, ruff, pylint), build tools, cloud CLIs (aws, gcloud, az), database queries, file listings, file content, environment/system info, network tools (curl, wget), and search (grep, find, ripgrep).
If compression isn't working:
python3 is available in your PATHTOKEN_SAVER_DEBUG=true then trigger a compressible command~/.token-saver/hook.log for errorsecho "test" | python3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_pretool.py"