coalesce-cli 0.1.0

Reduce Claude Code token consumption by batching file tool calls.

Coalesce CLI

Reduce Claude Code token consumption by batching tool calls into single primitives.

Install

pip install ./coalesce-cli
# or one-liner:
curl -sSL <YOUR_BACKEND>/api/cli/install.sh | bash

Configure

coalesce configure --api-key coa_xxxxx --endpoint https://your-coalesce.example.com

Commands

• coalesce configure — save API key + endpoint to ~/.coalesce/config.json
• coalesce status — show current config
• coalesce demo — run a synthetic optimization pass against a fake task and report savings to the dashboard
• coalesce report — manually report a Claude Code session's naive/batched counts
• coalesce version — print the version

How the batcher works

The coalesce.batcher.Batcher class collects individual read_file / edit_file / search requests and coalesces them into a small number of batched primitives:

• batch_read(files=[...])
• batch_edit(files=[...], plan="...")
• batch_search(queries=[...])

Each batch primitive counts as ONE tool call regardless of how many files it touches, avoiding one LLM roundtrip per file.

Model auto-detection

Coalesce auto-detects the Claude model in use (Sonnet 4.5/4.6, Opus 4.7/4.8, Haiku 4.5) via the CLAUDE_MODEL environment variable or the --model flag passed to coalesce demo / coalesce report. Pricing rates are pulled per-model from the Coalesce backend so $ savings are accurate.