@deepclamp/clamp

clamp is a CLI wrapper for AI coding agents that filters dev-command output before it reaches the model, so the same work costs fewer tokens. This package installs the platform clamp binary and delegates every command to it.

Estimate your savings

Run a local estimate of the tokens clamp would have saved on your recent agent sessions:

npx @deepclamp/clamp savings --estimate

The estimate runs entirely on your machine, reads only your local agent history, and installs no hooks. Sample more deeply with clamp savings --estimate --full.

Install

For day-to-day use, install globally:

npm install -g @deepclamp/clamp
clamp --version

Then set up your agent integration:

# Codex CLI (Windows/Linux)
clamp init --global --agent codex
# Restart Codex, review/trust Clamp hooks with /hooks, then verify:
clamp doctor --json --require codex-instructions,codex-hook,codex-trust

# Claude Code
clamp init --global --agent claude-code --auto-patch
clamp doctor --json --require hook

# Hermes
clamp init --agent hermes
clamp doctor --json

Prompt-level clamping for Hermes uses the clamp-engine sidecar, which ships with the evaluation bundle rather than this package; command filtering works without it.

Check savings as you work with clamp s (compact) or clamp savings --report (full report).

Uninstall

Reverses hook/settings changes for the agent you initialized, then removes the managed binary:

# Codex CLI
clamp uninstall --global --agent codex

# Claude Code
clamp uninstall --global --agent claude-code

# Hermes
clamp uninstall --agent hermes

Supported platforms

This package ships the clamp binary for:

• Linux x64 (static musl build)
• Windows x64
• macOS arm64 (Apple Silicon)
• macOS x64 (Intel)

On first run the wrapper stages the bundled binary into the managed clamp directory (~/.local/share/clamp/bin, override with CLAMP_NPM_INSTALL_DIR) and executes your command in the same invocation.

Licensing

Personal and noncommercial use is free. Business use requires a paid FileLasso license — evaluation starts at deepclamp.com. Enroll a license with clamp license <key> or npx @deepclamp/clamp --license <key>.

clamp is source-available. It includes components derived from rtk-ai/rtk under the Apache License 2.0; see NOTICE and licenses/APACHE-2.0.txt in this package.

Security, privacy, and data usage

The savings estimate and reports are generated locally; clamp does not upload your prompts, transcripts, source code, or command output to FileLasso. For the security, privacy, and data-usage reference, see deepclamp.com.