supymem 0.1.0

Local-first token and context savings for Claude Code

Supymem CLI

Local-first token and context savings for Claude Code.

Supymem wraps Claude Code through a local optimization proxy that compresses large tool outputs, stores originals locally, and lets Claude retrieve them on demand.

pip install supymem
supymem wrap claude
supymem stats
supymem unwrap claude
supymem doctor

Quick start

1. Install the CLI:

pip install supymem

2. Launch Claude Code through Supymem:

supymem wrap claude

This starts or reuses a local proxy on http://127.0.0.1:8787, routes Claude through it, sets ENABLE_TOOL_SEARCH=true, and registers the Supymem MCP retrieval server.

3. Check savings:

supymem stats

4. Restore Claude settings when done:

supymem unwrap claude

Commands

Command	Description
supymem wrap claude	Launch Claude Code through the Supymem proxy
supymem unwrap claude	Remove Supymem-managed Claude/MCP settings
supymem proxy --port 8787	Start the local optimization proxy
supymem doctor	Check local installation and proxy health
supymem stats	Show local compression/token savings
supymem mcp install	Register the Supymem MCP server with Claude
supymem update	Check for and install CLI updates

State and privacy

• Runtime state is stored under ~/.supymem.
• Compressed originals are stored locally and retrievable via supymem_retrieve.
• Supymem collects anonymous, content-free usage telemetry by default when a telemetry endpoint is configured. We never send prompts, code, file paths, API keys, or Claude messages.
• Disable telemetry with SUPYMEM_TELEMETRY=0, DO_NOT_TRACK=1, or supymem telemetry off.

Attribution

Supymem CLI includes software derived from Headroom, licensed under Apache 2.0. Headroom attribution notices are preserved in NOTICE. Supymem is not affiliated with or endorsed by Headroom.

License

Apache License 2.0. See LICENSE and NOTICE.