@caliber-ai/cli

CLI for configuring coding agent environments. Caliber analyzes your project and generates optimized configuration files for AI coding agents like Claude Code and Cursor.

Installation

npm install -g @caliber-ai/cli

Quick Start

# Authenticate with Caliber
caliber login

# Initialize your project
caliber init

# Check what's configured
caliber status

Commands

| Command | Description | Options | |---------|-------------|---------| | caliber init | Initialize coding agent setup for your project | --agent <claude\|cursor\|both>, --dry-run, --force | | caliber update | Re-analyze project and update setup | --dry-run | | caliber status | Show current Caliber setup status | --json | | caliber undo | Revert all config changes made by Caliber | | | caliber recommend | Discover and manage skill recommendations | --generate, --status <pending\|accepted\|dismissed> | | caliber health | Analyze context health and quality | --fix, --json | | caliber sync | Sync local config with server state | --platform <claude\|cursor\|both>, --dry-run | | caliber diff | Compare local config with server state | --platform <claude\|cursor\|both> | | caliber login | Authenticate with Caliber | | | caliber logout | Clear stored credentials | |

How It Works

1. Login — Authenticate with your Caliber account via the browser.
2. Init — Caliber analyzes your project structure, dependencies, and patterns, then generates tailored configuration files (e.g., CLAUDE.md, .cursorrules) for your chosen coding agent.
3. Update — Re-run the analysis when your project changes to keep agent configs up to date.
4. Recommend — Discover relevant skills from skills.sh based on your project's tech stack, scored by an LLM for relevance.
5. Health — Analyze the quality of your agent context configuration and get a score (A-F) with actionable recommendations. Use --fix to auto-remediate issues.
6. Sync / Diff — Compare your local agent config against the server state and sync missing or outdated items across platforms.
7. Undo — Cleanly revert all changes if you want to start fresh.

CI/CD

Pushes to main automatically publish to npm with semantic versioning based on conventional commits. A Sentry release is created for each version.

Requirements

• Node.js >= 20

License

MIT