@rely-ai/caliber 0.9.0 → 1.0.0

package/README.md

@@ -1,10 +1,14 @@
-# Caliber
+<p align="center">
+  <img src="assets/social-preview.svg" alt="Caliber" width="640">
+</p>
 
-[![npm version](https://img.shields.io/npm/v/@rely-ai/caliber)](https://www.npmjs.com/package/@rely-ai/caliber)
-[![license](https://img.shields.io/npm/l/@rely-ai/caliber)](./LICENSE)
-[![node](https://img.shields.io/node/v/@rely-ai/caliber)](https://nodejs.org)
+<p align="center">
+  <a href="https://www.npmjs.com/package/@rely-ai/caliber"><img src="https://img.shields.io/npm/v/@rely-ai/caliber" alt="npm version"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@rely-ai/caliber" alt="license"></a>
+  <a href="https://nodejs.org"><img src="https://img.shields.io/node/v/@rely-ai/caliber" alt="node"></a>
+</p>
 
-**Analyze your codebase. Generate optimized AI agent configs. One command.**
+<p align="center"><strong>Analyze your codebase. Generate optimized AI agent configs. One command.</strong></p>
 
 Caliber scans your project — languages, frameworks, dependencies, file structure — and generates tailored config files for Claude Code and Cursor. If configs already exist, it audits them and suggests improvements.
 
@@ -13,7 +17,7 @@ Caliber scans your project — languages, frameworks, dependencies, file structu
 ## Quick Start
 
 ```bash
-npx @rely-ai/caliber init
+npx @rely-ai/caliber onboard
 ```
 
 That's it. On first run, Caliber walks you through provider setup interactively.
@@ -22,19 +26,19 @@ Or install globally:
 
 ```bash
 npm install -g @rely-ai/caliber
-caliber init
+caliber onboard
 ```
 
 > **Already have an API key?** Skip the interactive setup:
 > ```bash
 > export ANTHROPIC_API_KEY=sk-ant-...
-> npx @rely-ai/caliber init
+> npx @rely-ai/caliber onboard
 > ```
 
 ## How It Works
 
 ```
-caliber init
+caliber onboard
 │
 ├─ 1. Scan        Analyze languages, frameworks, dependencies, file structure,
 │                  and existing agent configs in your project
@@ -64,16 +68,16 @@ If these files already exist, Caliber audits them against your actual codebase a
 
 | Command | Description |
 |---------|-------------|
-| `caliber init` | Scan project, generate/audit agent configs, review and apply |
+| `caliber onboard` | Onboard your project for AI-assisted development |
 | `caliber score` | Score your config quality (deterministic, no LLM needed) |
 | `caliber recommend` | Discover and install skills from [skills.sh](https://skills.sh) |
 | `caliber config` | Configure LLM provider, API key, and model |
 
 ```bash
-caliber init --agent claude      # Target Claude Code only
-caliber init --agent cursor      # Target Cursor only
-caliber init --agent both        # Target both
-caliber init --dry-run           # Preview without writing files
+caliber onboard --agent claude      # Target Claude Code only
+caliber onboard --agent cursor      # Target Cursor only
+caliber onboard --agent both        # Target both
+caliber onboard --dry-run           # Preview without writing files
 caliber score --json             # Machine-readable output
 ```
 

package/dist/bin.js

@@ -55,7 +55,7 @@ import fs24 from "fs";
 import path21 from "path";
 import { fileURLToPath } from "url";
 
-// src/commands/init.ts
+// src/commands/onboard.ts
 import chalk4 from "chalk";
 import ora from "ora";
 import readline3 from "readline";
@@ -2194,7 +2194,7 @@ function openDiffsInEditor(editor, files) {
   }
 }
 
-// src/commands/init.ts
+// src/commands/onboard.ts
 import { createTwoFilesPatch } from "diff";
 
 // src/lib/hooks.ts
@@ -3820,7 +3820,7 @@ function displayScoreDelta(before, after) {
   }
 }
 
-// src/commands/init.ts
+// src/commands/onboard.ts
 async function initCommand(options) {
   const brand = chalk4.hex("#EB9D83");
   const title = chalk4.hex("#83D1EB");
@@ -3832,18 +3832,16 @@ async function initCommand(options) {
   \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551  \u2588\u2588\u2551
    \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D
   `));
-  console.log(chalk4.dim("  Configure your coding agent environment\n"));
-  console.log(title.bold("  What is Caliber?\n"));
-  console.log(chalk4.dim("  Caliber audits your AI agent configurations and suggests targeted"));
-  console.log(chalk4.dim("  improvements. It analyzes CLAUDE.md, .cursorrules, and skills"));
-  console.log(chalk4.dim("  against your actual codebase \u2014 keeping what works, fixing"));
-  console.log(chalk4.dim("  what's stale, and adding what's missing.\n"));
-  console.log(title.bold("  How it works:\n"));
-  console.log(chalk4.dim("  1. Scan      Analyze your code, dependencies, and existing configs"));
-  console.log(chalk4.dim("  2. Generate  AI creates or improves config files for your project"));
-  console.log(chalk4.dim("  3. Review    You accept, refine, or decline the proposed changes"));
-  console.log(chalk4.dim("  4. Apply     Config files are written with backups\n"));
-  console.log(title.bold("  Step 1/4 \u2014 How do you want to use Caliber?\n"));
+  console.log(chalk4.dim("  Onboard your project for AI-assisted development\n"));
+  console.log(title.bold("  Welcome to Caliber\n"));
+  console.log(chalk4.dim("  Caliber analyzes your codebase and creates tailored config files"));
+  console.log(chalk4.dim("  so your AI coding agents understand your project from day one.\n"));
+  console.log(title.bold("  How onboarding works:\n"));
+  console.log(chalk4.dim("  1. Connect   Set up your LLM provider"));
+  console.log(chalk4.dim("  2. Discover  Analyze your code, dependencies, and structure"));
+  console.log(chalk4.dim("  3. Generate  Create config files tailored to your project"));
+  console.log(chalk4.dim("  4. Review    Preview, refine, and apply the changes\n"));
+  console.log(title.bold("  Step 1/4 \u2014 Connect your LLM\n"));
   let config = loadConfig();
   if (!config) {
     console.log(chalk4.dim("  No LLM provider set yet. Choose how to run Caliber:\n"));
@@ -3860,14 +3858,14 @@ async function initCommand(options) {
       console.log(chalk4.red("  Setup was cancelled or failed.\n"));
       throw new Error("__exit__");
     }
-    console.log(chalk4.green("  \u2713 Provider saved. Continuing with init.\n"));
+    console.log(chalk4.green("  \u2713 Provider saved. Let's continue.\n"));
   }
   const displayModel = config.model === "default" && config.provider === "claude-cli" ? process.env.ANTHROPIC_MODEL || "default (inherited from Claude Code)" : config.model;
   const fastModel = process.env.ANTHROPIC_SMALL_FAST_MODEL;
   const modelLine = fastModel ? `  Provider: ${config.provider} | Model: ${displayModel} | Scan: ${fastModel}` : `  Provider: ${config.provider} | Model: ${displayModel}`;
   console.log(chalk4.dim(modelLine + "\n"));
-  console.log(title.bold("  Step 2/4 \u2014 Scan project\n"));
-  console.log(chalk4.dim("  Detecting languages, dependencies, file structure, and existing configs.\n"));
+  console.log(title.bold("  Step 2/4 \u2014 Discover your project\n"));
+  console.log(chalk4.dim("  Learning about your languages, dependencies, structure, and existing configs.\n"));
   const spinner = ora("Analyzing project...").start();
   const fingerprint = collectFingerprint(process.cwd());
   await enrichFingerprintWithLLM(fingerprint, process.cwd());
@@ -3881,7 +3879,7 @@ async function initCommand(options) {
   const hasExistingConfig = !!(fingerprint.existingConfigs.claudeMd || fingerprint.existingConfigs.claudeSettings || fingerprint.existingConfigs.claudeSkills?.length || fingerprint.existingConfigs.cursorrules || fingerprint.existingConfigs.cursorRules?.length);
   if (hasExistingConfig && baselineScore.score === 100) {
     console.log(chalk4.bold.green("  Your setup is already optimal \u2014 nothing to change.\n"));
-    console.log(chalk4.dim("  Run `caliber init --force` to regenerate anyway.\n"));
+    console.log(chalk4.dim("  Run `caliber onboard --force` to regenerate anyway.\n"));
     if (!options.force) return;
   }
   const isEmpty = fingerprint.fileTree.length < 3;
@@ -3896,8 +3894,8 @@ async function initCommand(options) {
     passingChecks = baselineScore.checks.filter((c) => c.passed).map((c) => ({ name: c.name }));
     currentScore = baselineScore.score;
     if (failingChecks.length > 0) {
-      console.log(title.bold("  Step 3/4 \u2014 Targeted fixes\n"));
-      console.log(chalk4.dim(`  Score is ${baselineScore.score}/100 \u2014 only fixing ${failingChecks.length} remaining issue${failingChecks.length === 1 ? "" : "s"}:
+      console.log(title.bold("  Step 3/4 \u2014 Fine-tuning\n"));
+      console.log(chalk4.dim(`  Your setup scores ${baselineScore.score}/100 \u2014 fixing ${failingChecks.length} remaining issue${failingChecks.length === 1 ? "" : "s"}:
 `));
       for (const check of failingChecks) {
         console.log(chalk4.dim(`    \u2022 ${check.name}`));
@@ -3905,12 +3903,12 @@ async function initCommand(options) {
       console.log("");
     }
   } else if (hasExistingConfig) {
-    console.log(title.bold("  Step 3/4 \u2014 Auditing your configs\n"));
-    console.log(chalk4.dim("  AI is reviewing your existing configs against your codebase"));
-    console.log(chalk4.dim("  and suggesting improvements.\n"));
+    console.log(title.bold("  Step 3/4 \u2014 Improve your setup\n"));
+    console.log(chalk4.dim("  Reviewing your existing configs against your codebase"));
+    console.log(chalk4.dim("  and preparing improvements.\n"));
   } else {
-    console.log(title.bold("  Step 3/4 \u2014 Generating configs\n"));
-    console.log(chalk4.dim("  AI is creating agent config files tailored to your project.\n"));
+    console.log(title.bold("  Step 3/4 \u2014 Build your agent setup\n"));
+    console.log(chalk4.dim("  Creating config files tailored to your project.\n"));
   }
   console.log(chalk4.dim("  This can take a couple of minutes depending on your model and provider.\n"));
   const genStartTime = Date.now();
@@ -3970,7 +3968,7 @@ async function initCommand(options) {
     role: "assistant",
     content: summarizeSetup("Initial generation", generatedSetup)
   });
-  console.log(title.bold("  Step 4/4 \u2014 Review\n"));
+  console.log(title.bold("  Step 4/4 \u2014 Review and apply\n"));
   const setupFiles = collectSetupFiles(generatedSetup);
   const staged = stageFiles(setupFiles, process.cwd());
   console.log(chalk4.dim(`  ${chalk4.green(`${staged.newFiles} new`)} / ${chalk4.yellow(`${staged.modifiedFiles} modified`)} file${staged.newFiles + staged.modifiedFiles !== 1 ? "s" : ""}
@@ -4029,11 +4027,6 @@ async function initCommand(options) {
     console.error(chalk4.red(err instanceof Error ? err.message : "Unknown error"));
     throw new Error("__exit__");
   }
-  if (!fs17.existsSync("AGENTS.md")) {
-    const agentsContent = "# AGENTS.md\n\nThis project uses AI coding agents. See CLAUDE.md for Claude Code configuration and .cursor/rules/ for Cursor rules.\n";
-    fs17.writeFileSync("AGENTS.md", agentsContent);
-    console.log(`  ${chalk4.green("\u2713")} AGENTS.md`);
-  }
   ensurePermissions();
   const sha = getCurrentHeadSha();
   writeState({
@@ -4041,6 +4034,9 @@ async function initCommand(options) {
     lastRefreshTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
     targetAgent
   });
+  console.log("");
+  console.log(title.bold("  Keep your configs fresh\n"));
+  console.log(chalk4.dim("  Caliber can automatically update your agent configs when your code changes.\n"));
   const hookChoice = await promptHookType(targetAgent);
   if (hookChoice === "claude" || hookChoice === "both") {
     const hookResult = installHook();
@@ -4083,13 +4079,15 @@ async function initCommand(options) {
       }
     } catch {
     }
-    console.log(chalk4.dim("  Run `caliber init --force` to override.\n"));
+    console.log(chalk4.dim("  Run `caliber onboard --force` to override.\n"));
     return;
   }
   displayScoreDelta(baselineScore, afterScore);
-  console.log(chalk4.bold.green("  Setup complete! Your coding agent is now configured."));
+  console.log(chalk4.bold.green("  Onboarding complete! Your project is ready for AI-assisted development."));
   console.log(chalk4.dim("  Run `caliber undo` to revert changes.\n"));
   console.log(chalk4.bold("  Next steps:\n"));
+  console.log(`    ${title("caliber score")}        See your full config breakdown`);
+  console.log(`    ${title("caliber recommend")}    Discover community skills for your stack`);
   console.log(`    ${title("caliber undo")}         Revert all changes from this run`);
   console.log("");
 }
@@ -4464,6 +4462,11 @@ function printSetupSummary(setup) {
       }
     }
   }
+  if (!fs17.existsSync("AGENTS.md")) {
+    console.log(`  ${chalk4.green("+")} ${chalk4.bold("AGENTS.md")}`);
+    console.log(chalk4.dim("    Cross-agent coordination file"));
+    console.log("");
+  }
   if (Array.isArray(deletions) && deletions.length > 0) {
     for (const del of deletions) {
       console.log(`  ${chalk4.red("-")} ${chalk4.bold(del.filePath)}`);
@@ -4533,6 +4536,21 @@ function collectSetupFiles(setup) {
       }
     }
   }
+  if (!fs17.existsSync("AGENTS.md")) {
+    const agentRefs = [];
+    if (claude) agentRefs.push("See `CLAUDE.md` for Claude Code configuration.");
+    if (cursor) agentRefs.push("See `.cursor/rules/` for Cursor rules.");
+    if (agentRefs.length === 0) agentRefs.push("See CLAUDE.md and .cursor/rules/ for agent configurations.");
+    files.push({
+      path: "AGENTS.md",
+      content: `# AGENTS.md
+
+This project uses AI coding agents configured by [Caliber](https://github.com/rely-ai-org/caliber).
+
+${agentRefs.join(" ")}
+`
+    });
+  }
   return files;
 }
 
@@ -4590,7 +4608,7 @@ async function statusCommand(options) {
   }
   if (!manifest) {
     console.log(`  Setup: ${chalk6.dim("No setup applied")}`);
-    console.log(chalk6.dim("\n  Run `caliber init` to get started.\n"));
+    console.log(chalk6.dim("\n  Run `caliber onboard` to get started.\n"));
     return;
   }
   console.log(`  Files managed: ${chalk6.cyan(manifest.entries.length.toString())}`);
@@ -4614,7 +4632,7 @@ async function regenerateCommand(options) {
   }
   const manifest = readManifest();
   if (!manifest) {
-    console.log(chalk7.yellow("No existing setup found. Run `caliber init` first."));
+    console.log(chalk7.yellow("No existing setup found. Run `caliber onboard` first."));
     throw new Error("__exit__");
   }
   const spinner = ora3("Re-analyzing project...").start();
@@ -5356,9 +5374,9 @@ async function scoreCommand(options) {
   const separator = chalk9.gray("  " + "\u2500".repeat(53));
   console.log(separator);
   if (result.score < 40) {
-    console.log(chalk9.gray("  Run ") + chalk9.hex("#f97316")("caliber init") + chalk9.gray(" to generate a complete, optimized setup."));
+    console.log(chalk9.gray("  Run ") + chalk9.hex("#f97316")("caliber onboard") + chalk9.gray(" to generate a complete, optimized setup."));
   } else if (result.score < 70) {
-    console.log(chalk9.gray("  Run ") + chalk9.hex("#f97316")("caliber init") + chalk9.gray(" to improve your setup."));
+    console.log(chalk9.gray("  Run ") + chalk9.hex("#f97316")("caliber onboard") + chalk9.gray(" to improve your setup."));
   } else {
     console.log(chalk9.green("  Looking good!") + chalk9.gray(" Run ") + chalk9.hex("#f97316")("caliber update") + chalk9.gray(" to keep it fresh."));
   }
@@ -6216,7 +6234,7 @@ var pkg = JSON.parse(
 var program = new Command();
 var displayVersion = process.env.CALIBER_LOCAL ? `${pkg.version}-local` : pkg.version;
 program.name(process.env.CALIBER_LOCAL ? "caloc" : "caliber").description("Configure your coding agent environment").version(displayVersion);
-program.command("init").description("Initialize coding agent setup for this project").option("--agent <type>", "Target agent: claude, cursor, or both").option("--dry-run", "Preview changes without writing files").option("--force", "Overwrite existing setup without prompting").action(initCommand);
+program.command("onboard").alias("init").description("Onboard your project for AI-assisted development").option("--agent <type>", "Target agent: claude, cursor, or both").option("--dry-run", "Preview changes without writing files").option("--force", "Overwrite existing setup without prompting").action(initCommand);
 program.command("undo").description("Revert all config changes made by Caliber").action(undoCommand);
 program.command("status").description("Show current Caliber setup status").option("--json", "Output as JSON").action(statusCommand);
 program.command("regenerate").alias("regen").alias("re").alias("update").description("Re-analyze project and regenerate setup").option("--dry-run", "Preview changes without writing files").action(regenerateCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rely-ai/caliber",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "Analyze your codebase and generate optimized AI agent configs (CLAUDE.md, .cursorrules, skills) — no API key needed",
   "type": "module",
   "bin": {