unclog 0.2.1

Audit your Claude Code installation and clear context-window bloat. Local-only.

unclog

Every agent, skill, and MCP server you've installed occupies your Claude Code context window on every turn. unclog scans your install, shows you what's costing tokens, and lets you handpick what to delete — locally, with no telemetry, no accounts, and no network calls.

# install
uv tool install unclog

# run
unclog

What it shows

• Every agent in ~/.claude/agents/, with its token cost.
• Every skill in ~/.claude/skills/, with its token cost.
• Every slash command in ~/.claude/commands/, with its token cost.
• Every MCP server declared in ~/.claude.json (global and per-project), with its measured session-token cost when available.
• A baseline — the total tokens loaded before you type a single message.

Remove what's costing you

After the scan, one sectioned picker opens. Tick the agents / skills / commands / MCPs you want to remove, hit enter, confirm once, done. A post-apply line shows how many tokens you saved and the new baseline.

Picker keys: ↑↓ move · space toggle · a / A check section / all · n / N clear section / all · enter apply · q quit.

Actions are destructive. Deleted files are removed from disk — there is no undo command. MCP servers are a softer case: they're renamed to __unclog_disabled__<name> in your config, so you can revive one by hand-editing ~/.claude.json and removing the prefix.

Requirements

Python 3.11+, Claude Code ≥ 2.1.90, macOS or Linux.

Development

uv sync --all-extras --dev
uv run pytest
uv run ruff check src tests
uv run mypy src/unclog

License

MIT. See LICENSE.