@rely-ai/caliber 1.31.0-dev.1774815271 → 1.32.0-dev.1774815754

package/README.md

@@ -26,9 +26,7 @@ Score your AI agent config in 3 seconds. No API key. No changes to your code. Ju
 
 ---
 
-Caliber keeps your AI agent configs in sync with your codebase — automatically. It works across **Claude Code**, **Cursor**, **OpenAI Codex**, and **GitHub Copilot**, updating all formats on every commit. One tool, all agents, always in sync.
-
-Install once, never think about agent configs again. Caliber fingerprints your project, generates tailored configs, and keeps them fresh as your code evolves.
+Caliber scores, generates, and keeps your AI agent configs in sync with your codebase. It fingerprints your project — languages, frameworks, dependencies, architecture — and produces tailored configs for **Claude Code**, **Cursor**, and **OpenAI Codex**. When your code evolves, Caliber detects the drift and updates your configs to match.
 
 ## Before / After
 
@@ -69,31 +67,26 @@ If your existing config scores **95+**, Caliber skips full regeneration and appl
 
 ## How It Works
 
-Caliber is not a one-time setup tool. It's continuous sync:
+Caliber is not a one-time setup tool. It's a loop:
 
 ```
-  caliber init
-       │
-       ▼
-  Install sync infrastructure
-  (pre-commit hook + agent skills)
-       │
-       ▼
-  Generate configs (optional)
-       │
-       ▼
-  ┌──────────────────────────────┐
-  │   You code. You commit.      │
-  │   Caliber syncs all agents.  │◄──── automatic on every commit
-  │                              │
-  │   CLAUDE.md ✓                │
-  │   .cursor/rules/ ✓           │
-  │   AGENTS.md ✓                │
-  │   copilot-instructions.md ✓  │
-  └──────────────────────────────┘
+          caliber score
+              │
+              ▼
+  ┌──── caliber init ◄────────────────┐
+  │     (generate / fix)              │
+  │           │                       │
+  │           ▼                       │
+  │     your code evolves             │
+  │     (new deps, renamed files,     │
+  │      changed architecture)        │
+  │           │                       │
+  │           ▼                       │
+  └──► caliber refresh ──────────────►┘
+       (detect drift, update configs)
 ```
 
-The pre-commit hook runs `caliber refresh` on every commit, updating all agent configs simultaneously. Your agents always have current context.
+Auto-refresh hooks run this loop automatically — on every commit or at the end of each AI coding session.
 
 ### What It Generates
 
@@ -113,10 +106,6 @@ The pre-commit hook runs `caliber refresh` on every commit, updating all agent c
 - `AGENTS.md` — Project context for Codex
 - `.agents/skills/*/SKILL.md` — Skills for Codex
 
-**GitHub Copilot**
-- `.github/copilot-instructions.md` — Repository-wide instructions for Copilot
-- `.github/instructions/*.instructions.md` — Path-specific instruction files
-
 ## Key Features
 
 <details>
@@ -189,59 +178,22 @@ Learned items are categorized by type — **[correction]**, **[gotcha]**, **[fix
 </details>
 
 <details>
-<summary><strong>Continuous Sync</strong></summary>
+<summary><strong>Auto-Refresh</strong></summary>
 
-Caliber keeps all agent configs in sync automatically:
+Keep configs in sync with your codebase automatically:
 
 | Hook | Trigger | What it does |
 |---|---|---|
-| **Git pre-commit** | Before each commit | Refreshes all agent configs and stages updated files |
-| **Agent instructions** | Before commit in Claude Code/Cursor | Agent announces "Caliber: syncing..." if hook isn't installed |
+| **Git pre-commit** | Before each commit | Refreshes docs and stages updated files |
 | **Claude Code session end** | End of each session | Runs `caliber refresh` and updates docs |
 | **Learning hooks** | During each session | Captures events for session learning |
 
-The pre-commit hook is installed automatically during `caliber init`. It uses the fast model (~$0.01/commit) and takes a few seconds.
-
 ```bash
 caliber hooks --install    # Enable refresh hooks
 caliber hooks --remove     # Disable refresh hooks
 ```
 
-</details>
-
-<details>
-<summary><strong>Team Sync via GitHub Action</strong></summary>
-
-For teams, add the Caliber GitHub Action for automatic sync across all developers:
-
-```yaml
-# .github/workflows/caliber-sync.yml
-name: Caliber Sync
-on:
-  schedule:
-    - cron: '0 3 * * 1-5'  # Nightly on weekdays
-  pull_request:
-    types: [opened, synchronize]
-  workflow_dispatch:
-
-jobs:
-  sync:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: caliber-ai-org/ai-setup@v1
-        with:
-          mode: sync
-          auto-refresh: true
-          comment: true
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-        env:
-          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-```
-
-This creates nightly PRs with refreshed configs and posts sync status on every PR. No developer needs to install Caliber locally — the Action handles team-wide sync.
-
-New team members can run `/setup-caliber` inside their coding agent (Claude Code or Cursor) to set up local hooks for instant sync on every commit.
+The `refresh` command analyzes your git diff (committed, staged, and unstaged changes) and updates config files to reflect what changed.
 
 </details>
 
@@ -261,7 +213,7 @@ New team members can run `/setup-caliber` inside their coding agent (Claude Code
 |---|---|
 | `caliber score` | Score config quality (deterministic, no LLM) |
 | `caliber score --compare <ref>` | Compare current score against a git ref |
-| `caliber init` | Set up continuous sync — install hooks, generate configs, install agent skills |
+| `caliber init` | Full setup wizard — analyze, generate, review, install hooks |
 | `caliber regenerate` | Re-analyze and regenerate configs (aliases: `regen`, `re`) |
 | `caliber refresh` | Update docs based on recent code changes |
 | `caliber skills` | Discover and install community skills |