JSPM

Caliber scans your project — languages, frameworks, dependencies, file structure — and generates tailored config files for Claude Code, Cursor, and OpenAI Codex. If configs already exist, it audits them against your actual codebase and suggests targeted improvements.

🔑 API Key Optional — use your existing Claude Code or Cursor subscription. Or bring your own key (Anthropic, OpenAI, Vertex AI, any OpenAI-compatible endpoint).

🧠 BYOAI — Caliber works where you do. All LLM processing runs through your own models — no data is sent to third parties.

Why Caliber?

Caliber generates, audits, and maintains your agentic development sessions.

• 🏗️ Generates, not just score — builds your CLAUDE.md, Cursor rules, AGENTS.md, skills, and MCP configs from scratch
• 🔀 Multi-agent — one command sets up Claude Code, Cursor, and Codex together
• 🌍 Any codebase — TypeScript, Python, Go, Rust, Terraform, Java, Ruby — detection is fully LLM-driven, not hardcoded
• 🧩 Finds and installs skills — searches community registries and installs relevant skills for your stack
• 🔗 Discovers MCP servers — auto-detects tools your project uses and installs matching MCP servers
• 🔄 Keeps configs fresh — git hooks and session hooks auto-update your docs as your code changes
• ↩️ Fully reversible — automatic backups, score regression guard, and one-command undo

🚀 Quick Start

npx @rely-ai/caliber init

That's it. On first run, Caliber walks you through provider setup interactively.

Or install globally:

npm install -g @rely-ai/caliber
caliber init

Already have an API key? Skip the interactive setup:

export ANTHROPIC_API_KEY=sk-ant-...
npx @rely-ai/caliber init

⚙️ How It Works

caliber init
│
├─ 1. 🔌 Connect      Choose your LLM provider — Claude Code seat, Cursor seat,
│                      or an API key (Anthropic, OpenAI, Vertex AI)
│
├─ 2. 🔍 Discover     Analyze languages, frameworks, dependencies, file structure,
│                      and existing agent configs via LLM
│
├─ 3. 🛠️  Generate     Create CLAUDE.md + skills in parallel (core docs via smart
│                      model, skills via fast model). Auto-polishes for max score
│
├─ 4. 👀 Review       See a diff of proposed changes — accept, refine via
│                      chat, or decline. All changes are backed up automatically
│
└─ 5. 🧩 Skills       Search community skill registries and install relevant
                       skills for your tech stack

Caliber works on any codebase — TypeScript, Python, Go, Rust, Terraform, Java, Ruby, and more. Language and framework detection is fully LLM-driven, not hardcoded.

📦 What It Generates

If these files already exist, Caliber audits them and suggests improvements — keeping what works, fixing what's stale, adding what's missing.

🛡️ Safety

Every change Caliber makes is reversible:

• 💾 Automatic backups — previous versions saved to .caliber/backups/{timestamp}/ before every write
• 📊 Score regression guard — if a regeneration produces a lower score, changes are auto-reverted
• ↩️ Full undo — caliber undo reverts all changes made by Caliber
• 🔍 Dry run — preview any command's changes with --dry-run

📋 Commands

Examples

# Initialize
caliber init                      # Interactive — picks agent, walks through setup
caliber init --agent claude       # Target Claude Code only
caliber init --agent cursor       # Target Cursor only
caliber init --agent codex        # Target OpenAI Codex only
caliber init --agent all          # Target all three
caliber init --agent claude,cursor # Comma-separated
caliber init --dry-run            # Preview without writing files
caliber init --force              # Overwrite existing setup without prompting

# Scoring
caliber score                        # Full breakdown with grade (A-F)
caliber score --json                 # Machine-readable output
caliber score --agent claude         # Score for a specific agent

# Day-to-day
caliber regenerate                   # Re-analyze and regenerate (alias: regen, re)
caliber refresh                      # Update docs from recent git changes
caliber refresh --dry-run            # Preview what would change
caliber skills                       # Browse and install community skills
caliber hooks                        # Toggle auto-refresh hooks
caliber hooks --install              # Enable all hooks non-interactively
caliber status                       # Show what Caliber has set up
caliber undo                         # Revert everything

📊 Scoring

caliber score gives you a deterministic, tech-stack-agnostic quality score. No LLM needed — it cross-references your config files against the actual project filesystem.

  Agent Config Score    88 / 100    Grade A

  FILES & SETUP                                17 / 17
  QUALITY                                      21 / 23
  GROUNDING                                    20 / 20
  ACCURACY                                     10 / 15
  FRESHNESS & SAFETY                           10 / 10
  BONUS                                         5 / 5

Every failing check includes structured fix data — when caliber init runs, the LLM receives exactly what's wrong and how to fix it.

🧩 Skills

Caliber searches three community registries and scores results against your project

caliber skills

Skills are scored by LLM relevance (0–100) based on your project's actual tech stack and development patterns, then you pick which ones to install via an interactive selector. Installed skills follow the OpenSkills standard with YAML frontmatter.

🔄 Auto-Refresh

Keep your agent configs in sync with your codebase automatically:

Set up hooks interactively with caliber hooks, or non-interactively:

caliber hooks --install    # Enable all hooks
caliber hooks --remove     # Disable all hooks

The refresh command analyzes your git diff (committed, staged, and unstaged changes) and updates your config files to reflect what changed. It works across multiple repos if run from a parent directory.

🔌 LLM Providers

Override the model for any provider: export CALIBER_MODEL=<model-name> or use caliber config.

Configuration is stored in ~/.caliber/config.json with restricted permissions (0600). 🔒 API keys are never written to project files.

# Custom region
export VERTEX_PROJECT_ID=my-gcp-project
export VERTEX_REGION=europe-west1

# Service account credentials (inline JSON)
export VERTEX_PROJECT_ID=my-gcp-project
export VERTEX_SA_CREDENTIALS='{"type":"service_account",...}'

# Service account credentials (file path)
export VERTEX_PROJECT_ID=my-gcp-project
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

📋 Requirements

• Node.js >= 20
• One LLM provider: your Claude Code or Cursor subscription (no API key), or an API key for Anthropic / OpenAI / Vertex AI

🤝 Contributing

See CONTRIBUTING.md for detailed guidelines.

git clone https://github.com/rely-ai-org/caliber.git
cd caliber
npm install
npm run dev      # Watch mode
npm run test     # Run tests
npm run build    # Compile

Uses conventional commits — feat: for features, fix: for bug fixes.

📄 License

MIT