Help Center
Installation
Prerequisites
- Python 3.10 or higher
- Claude Code installed and configured
Install
pip install tokslash --extra-index-url https://tokslash.stratsapien.com/pypi/ --trusted-host tokslash.stratsapien.comActivate Pro License
tokslash activate --key YOUR-LICENSE-KEYIf you haven't purchased yet, buy a Pro license here.
How It Works
TokSlash registers as an MCP server when you run tokslash serve (or auto-registers in Claude Code). It intercepts file operations and serves content block-by-block instead of file-by-file.
Supported File Types
- Block editing: Markdown files (.md) only
- Full-file with cache: All text files (.py, .js, .json, .yaml, .txt, .css, .html, .toml, .mdx, etc.) — 38 extensions supported
- Excluded from cache: Binary files and files larger than 5MB
Benchmark Results
See our automated benchmark results on the landing page: 46% average token savings across 9 real-world scenarios.
Frequently Asked Questions
How does block editing save tokens?
Claude Code normally reads entire files. For a 1,000-line file, that's 1,000 lines of input tokens every time. TokSlash serves only the relevant block (e.g., 60 lines), saving ~94% of input tokens for that read.
What happens when free quota (50/day) is used up?
Nothing breaks. TokSlash falls back to full-file reads/writes automatically. Your files remain fully editable. The quota resets at midnight UTC.
Where are backups stored?
In the .tokslash/backups/ directory in your project root. Each modification creates a timestamped backup before the change is applied.
How do I uninstall TokSlash?
Run pip uninstall tokslash. Your project files and backups are untouched. To remove cached data, delete the .tokslash/ directory from your project.
What happens if I request a refund?
Your license key will be revoked. TokSlash will fall back to free tier limits on your next use.
Troubleshooting
"Module not found" error
Ensure Python 3.10+ is installed and on your PATH. Run python3 --version to verify.
Cache not working
Check that the file is a supported text format and under 5MB. Run tokslash status to see remaining quota.
Activation fails
Verify your license key is correct. Check network connectivity (activation requires one online check). Run tokslash activate --key YOUR-KEY --email your@email.com with your email.