@rely-ai/caliber 1.31.0-dev.1774713696 → 1.31.0-dev.1774714593
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +71 -23
- package/dist/bin.js +8 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -26,7 +26,9 @@ Score your AI agent config in 3 seconds. No API key. No changes to your code. Ju
|
|
|
26
26
|
|
|
27
27
|
---
|
|
28
28
|
|
|
29
|
-
Caliber
|
|
29
|
+
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.
|
|
30
|
+
|
|
31
|
+
Install once, never think about agent configs again. Caliber fingerprints your project, generates tailored configs, and keeps them fresh as your code evolves.
|
|
30
32
|
|
|
31
33
|
## Before / After
|
|
32
34
|
|
|
@@ -67,26 +69,31 @@ If your existing config scores **95+**, Caliber skips full regeneration and appl
|
|
|
67
69
|
|
|
68
70
|
## How It Works
|
|
69
71
|
|
|
70
|
-
Caliber is not a one-time setup tool. It's
|
|
72
|
+
Caliber is not a one-time setup tool. It's continuous sync:
|
|
71
73
|
|
|
72
74
|
```
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
│
|
|
85
|
-
|
|
86
|
-
|
|
75
|
+
caliber init
|
|
76
|
+
│
|
|
77
|
+
▼
|
|
78
|
+
Install sync infrastructure
|
|
79
|
+
(pre-commit hook + agent skills)
|
|
80
|
+
│
|
|
81
|
+
▼
|
|
82
|
+
Generate configs (optional)
|
|
83
|
+
│
|
|
84
|
+
▼
|
|
85
|
+
┌──────────────────────────────┐
|
|
86
|
+
│ You code. You commit. │
|
|
87
|
+
│ Caliber syncs all agents. │◄──── automatic on every commit
|
|
88
|
+
│ │
|
|
89
|
+
│ CLAUDE.md ✓ │
|
|
90
|
+
│ .cursor/rules/ ✓ │
|
|
91
|
+
│ AGENTS.md ✓ │
|
|
92
|
+
│ copilot-instructions.md ✓ │
|
|
93
|
+
└──────────────────────────────┘
|
|
87
94
|
```
|
|
88
95
|
|
|
89
|
-
|
|
96
|
+
The pre-commit hook runs `caliber refresh` on every commit, updating all agent configs simultaneously. Your agents always have current context.
|
|
90
97
|
|
|
91
98
|
### What It Generates
|
|
92
99
|
|
|
@@ -106,6 +113,10 @@ Auto-refresh hooks run this loop automatically — on every commit or at the end
|
|
|
106
113
|
- `AGENTS.md` — Project context for Codex
|
|
107
114
|
- `.agents/skills/*/SKILL.md` — Skills for Codex
|
|
108
115
|
|
|
116
|
+
**GitHub Copilot**
|
|
117
|
+
- `.github/copilot-instructions.md` — Repository-wide instructions for Copilot
|
|
118
|
+
- `.github/instructions/*.instructions.md` — Path-specific instruction files
|
|
119
|
+
|
|
109
120
|
## Key Features
|
|
110
121
|
|
|
111
122
|
<details>
|
|
@@ -178,22 +189,59 @@ Learned items are categorized by type — **[correction]**, **[gotcha]**, **[fix
|
|
|
178
189
|
</details>
|
|
179
190
|
|
|
180
191
|
<details>
|
|
181
|
-
<summary><strong>
|
|
192
|
+
<summary><strong>Continuous Sync</strong></summary>
|
|
182
193
|
|
|
183
|
-
|
|
194
|
+
Caliber keeps all agent configs in sync automatically:
|
|
184
195
|
|
|
185
196
|
| Hook | Trigger | What it does |
|
|
186
197
|
|---|---|---|
|
|
187
|
-
| **Git pre-commit** | Before each commit | Refreshes
|
|
198
|
+
| **Git pre-commit** | Before each commit | Refreshes all agent configs and stages updated files |
|
|
199
|
+
| **Agent instructions** | Before commit in Claude Code/Cursor | Agent announces "Caliber: syncing..." if hook isn't installed |
|
|
188
200
|
| **Claude Code session end** | End of each session | Runs `caliber refresh` and updates docs |
|
|
189
201
|
| **Learning hooks** | During each session | Captures events for session learning |
|
|
190
202
|
|
|
203
|
+
The pre-commit hook is installed automatically during `caliber init`. It uses the fast model (~$0.01/commit) and takes a few seconds.
|
|
204
|
+
|
|
191
205
|
```bash
|
|
192
206
|
caliber hooks --install # Enable refresh hooks
|
|
193
207
|
caliber hooks --remove # Disable refresh hooks
|
|
194
208
|
```
|
|
195
209
|
|
|
196
|
-
|
|
210
|
+
</details>
|
|
211
|
+
|
|
212
|
+
<details>
|
|
213
|
+
<summary><strong>Team Sync via GitHub Action</strong></summary>
|
|
214
|
+
|
|
215
|
+
For teams, add the Caliber GitHub Action for automatic sync across all developers:
|
|
216
|
+
|
|
217
|
+
```yaml
|
|
218
|
+
# .github/workflows/caliber-sync.yml
|
|
219
|
+
name: Caliber Sync
|
|
220
|
+
on:
|
|
221
|
+
schedule:
|
|
222
|
+
- cron: '0 3 * * 1-5' # Nightly on weekdays
|
|
223
|
+
pull_request:
|
|
224
|
+
types: [opened, synchronize]
|
|
225
|
+
workflow_dispatch:
|
|
226
|
+
|
|
227
|
+
jobs:
|
|
228
|
+
sync:
|
|
229
|
+
runs-on: ubuntu-latest
|
|
230
|
+
steps:
|
|
231
|
+
- uses: actions/checkout@v4
|
|
232
|
+
- uses: caliber-ai-org/ai-setup@v1
|
|
233
|
+
with:
|
|
234
|
+
mode: sync
|
|
235
|
+
auto-refresh: true
|
|
236
|
+
comment: true
|
|
237
|
+
github-token: ${{ secrets.GITHUB_TOKEN }}
|
|
238
|
+
env:
|
|
239
|
+
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
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.
|
|
243
|
+
|
|
244
|
+
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.
|
|
197
245
|
|
|
198
246
|
</details>
|
|
199
247
|
|
|
@@ -213,7 +261,7 @@ The `refresh` command analyzes your git diff (committed, staged, and unstaged ch
|
|
|
213
261
|
|---|---|
|
|
214
262
|
| `caliber score` | Score config quality (deterministic, no LLM) |
|
|
215
263
|
| `caliber score --compare <ref>` | Compare current score against a git ref |
|
|
216
|
-
| `caliber init` |
|
|
264
|
+
| `caliber init` | Set up continuous sync — install hooks, generate configs, install agent skills |
|
|
217
265
|
| `caliber regenerate` | Re-analyze and regenerate configs (aliases: `regen`, `re`) |
|
|
218
266
|
| `caliber refresh` | Update docs based on recent code changes |
|
|
219
267
|
| `caliber skills` | Discover and install community skills |
|
|
@@ -343,7 +391,7 @@ export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
|
|
|
343
391
|
See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines.
|
|
344
392
|
|
|
345
393
|
```bash
|
|
346
|
-
git clone https://github.com/
|
|
394
|
+
git clone https://github.com/caliber-ai-org/ai-setup.git
|
|
347
395
|
cd caliber
|
|
348
396
|
npm install
|
|
349
397
|
npm run dev # Watch mode
|
package/dist/bin.js
CHANGED
|
@@ -261,7 +261,7 @@ grep -q "caliber" .git/hooks/pre-commit 2>/dev/null && echo "hook-active" || ech
|
|
|
261
261
|
2. Run: \`${bin} refresh && git add ${MANAGED_DOC_PATHS} 2>/dev/null\`
|
|
262
262
|
3. After it completes, briefly tell the user what Caliber updated. Then proceed with the commit.
|
|
263
263
|
|
|
264
|
-
If \`${bin}\` is not found, tell the user: "This project uses Caliber for agent config sync.
|
|
264
|
+
If \`${bin}\` is not found, tell the user: "This project uses Caliber for agent config sync. Run /setup-caliber to get set up."
|
|
265
265
|
${BLOCK_END}`;
|
|
266
266
|
}
|
|
267
267
|
function getCursorRuleContent() {
|
|
@@ -276,7 +276,7 @@ Run: \`grep -q "caliber" .git/hooks/pre-commit 2>/dev/null && echo "hook-active"
|
|
|
276
276
|
If hook-active: just commit normally \u2014 Caliber syncs automatically via the hook. Tell the user: "Caliber will sync your agent configs automatically."
|
|
277
277
|
If no-hook: run \`${bin} refresh && git add ${MANAGED_DOC_PATHS} 2>/dev/null\` before committing, and tell the user what was updated.
|
|
278
278
|
|
|
279
|
-
If \`${bin}\` is not found, tell the user: "This project uses Caliber for agent config sync.
|
|
279
|
+
If \`${bin}\` is not found, tell the user: "This project uses Caliber for agent config sync. Run /setup-caliber to get set up."
|
|
280
280
|
`;
|
|
281
281
|
}
|
|
282
282
|
function hasPreCommitBlock(content) {
|
|
@@ -306,7 +306,7 @@ function getSyncBlock() {
|
|
|
306
306
|
return `${SYNC_BLOCK_START}
|
|
307
307
|
## Context Sync
|
|
308
308
|
|
|
309
|
-
This project uses [Caliber](https://github.com/
|
|
309
|
+
This project uses [Caliber](https://github.com/caliber-ai-org/ai-setup) to keep AI agent configs in sync across Claude Code, Cursor, Copilot, and Codex.
|
|
310
310
|
Configs update automatically before each commit via \`${bin} refresh\`.
|
|
311
311
|
If the pre-commit hook is not set up, run \`${bin} hooks --install\` to enable automatic sync.
|
|
312
312
|
${SYNC_BLOCK_END}`;
|
|
@@ -327,7 +327,7 @@ alwaysApply: true
|
|
|
327
327
|
---
|
|
328
328
|
This project uses Caliber to keep AI agent configs (CLAUDE.md, Cursor rules, Copilot instructions)
|
|
329
329
|
in sync with the codebase automatically. Before each commit, run \`${bin} refresh\` to sync configs.
|
|
330
|
-
If \`${bin}\` is not found, tell the user: "This project uses Caliber for agent config sync.
|
|
330
|
+
If \`${bin}\` is not found, tell the user: "This project uses Caliber for agent config sync. Run /setup-caliber to get set up."
|
|
331
331
|
`;
|
|
332
332
|
}
|
|
333
333
|
function getCursorSyncRule() {
|
|
@@ -5280,7 +5280,7 @@ function collectSetupFiles(setup, targetAgent) {
|
|
|
5280
5280
|
if (agentRefs.length === 0) agentRefs.push("See CLAUDE.md and .cursor/rules/ for agent configurations.");
|
|
5281
5281
|
const stubContent = `# AGENTS.md
|
|
5282
5282
|
|
|
5283
|
-
This project uses AI coding agents configured by [Caliber](https://github.com/
|
|
5283
|
+
This project uses AI coding agents configured by [Caliber](https://github.com/caliber-ai-org/ai-setup).
|
|
5284
5284
|
|
|
5285
5285
|
${agentRefs.join(" ")}
|
|
5286
5286
|
`;
|
|
@@ -9622,7 +9622,7 @@ async function initCommand(options) {
|
|
|
9622
9622
|
if (agentRefs.length === 0) agentRefs.push("See CLAUDE.md and .cursor/rules/ for agent configurations.");
|
|
9623
9623
|
const stubContent = `# AGENTS.md
|
|
9624
9624
|
|
|
9625
|
-
This project uses AI coding agents configured by [Caliber](https://github.com/
|
|
9625
|
+
This project uses AI coding agents configured by [Caliber](https://github.com/caliber-ai-org/ai-setup).
|
|
9626
9626
|
|
|
9627
9627
|
${agentRefs.join(" ")}
|
|
9628
9628
|
`;
|
|
@@ -10333,13 +10333,13 @@ var LEARNINGS_FILE = "CALIBER_LEARNINGS.md";
|
|
|
10333
10333
|
var LEARNINGS_HEADER = `# Caliber Learnings
|
|
10334
10334
|
|
|
10335
10335
|
Accumulated patterns and anti-patterns from development sessions.
|
|
10336
|
-
Auto-managed by [caliber](https://github.com/
|
|
10336
|
+
Auto-managed by [caliber](https://github.com/caliber-ai-org/ai-setup) \u2014 do not edit manually.
|
|
10337
10337
|
|
|
10338
10338
|
`;
|
|
10339
10339
|
var PERSONAL_LEARNINGS_HEADER = `# Personal Learnings
|
|
10340
10340
|
|
|
10341
10341
|
Developer-specific patterns and preferences.
|
|
10342
|
-
Auto-managed by [caliber](https://github.com/
|
|
10342
|
+
Auto-managed by [caliber](https://github.com/caliber-ai-org/ai-setup) \u2014 do not edit manually.
|
|
10343
10343
|
|
|
10344
10344
|
`;
|
|
10345
10345
|
var LEARNED_START = "<!-- caliber:learned -->";
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@rely-ai/caliber",
|
|
3
|
-
"version": "1.31.0-dev.
|
|
3
|
+
"version": "1.31.0-dev.1774714593",
|
|
4
4
|
"description": "AI context infrastructure for coding agents — keeps CLAUDE.md, Cursor rules, and skills in sync as your codebase evolves",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|