Install

Reference

CLI Commands Index

Comprehensive guide to the CacheLane command line interface utility.

Command Line Suite

The global cachelane CLI command exposes several utilities to manage, verify, and tune CacheLane's behavior locally.

Lifecycle and Setup

cachelane install

Registers the CacheLane stdio MCP server in Claude's configuration and writes hook configurations.

cachelane install [--force]

cachelane doctor

Runs runtime health checks. Verifies Node compatibility, database accessibility, and configurations.

cachelane doctor [--json]

cachelane uninstall

Removes the CacheLane integrations. Use --purge to completely wipe config files and SQLite database logs.

cachelane uninstall [--purge]

Performance Tuning

cachelane stats

Prints cache ratios, turn counters, and estimated API savings.

cachelane stats [--scope session|workspace|all] [--since <duration>]

cachelane explain

Explains context classification and pruning choices made during turn N.

cachelane explain [--turn <number>]

cachelane prune

Configures pruning threshold variables. Default is K=3; aggressive is K=2; conservative is K=5.

cachelane prune --default | --aggressive | --conservative

cachelane keepalive

Configures adaptive prompt TTL keepalive worker behaviors.

cachelane keepalive off | static | adaptive | auto

Pinning and Exclusions

cachelane pin

Pins a target file or glob pattern, locking it inside the stable caching region to prevent it from ever being pruned.

cachelane pin <file|glob>

cachelane exclude

Excludes files matching a glob pattern from cache-aware categorization.

cachelane exclude <file|glob>