How do I install the Token Saver Config skill?

Run npx skillmds@latest add tomevault-io/token-saver-config in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Token Saver Config safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Token Saver Config?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Token Saver Config free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Token Saver Config?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Token Saver Config by tomevault-io — Agent Skill

Name: Token Saver Config
Author: tomevault-io

Token Saver Config

Configure and diagnose token-saver compression settings. Use when the user asks about adjusting compression levels, checking processor status, debugging hook issues, or reviewing savings statistics. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Token-Saver Configuration & Diagnostics

Check Status

Run token-saver stats to see compression statistics for the current and all sessions.

Configuration

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

Debug Mode

Set TOKEN_SAVER_DEBUG=true environment variable to enable debug logging to ~/.token-saver/hook.log.

Supported Processors

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).

Troubleshooting

If compression isn't working:

Check that python3 is available in your PATH
Run TOKEN_SAVER_DEBUG=true then trigger a compressible command
Check ~/.token-saver/hook.log for errors
Verify with: echo "test" | python3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_pretool.py"

Source: ppgranger/token-saver — distributed by TomeVault.

Frequently asked questions