Skip to main content
rule CX Codex

caliber-onboarding — Claude Code rule: check config sync status

caliber-onboarding — a rule for Claude Code and Codex that checks whether Caliber configs are synced before the agent responds to your first message. If sync is not set up, it offers to run /setup-caliber in about 30 seconds.

MIT ★ 1,319 updated 2026-09-24

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/rules/caliber-onboarding.md
Open on GitHub

What caliber-onboarding does

On both Claude Code and Codex, the rule runs before the agent's first response. It checks for caliber inside the pre-commit hook — if missing, it notifies you of desync and asks whether to run automatic setup. If the hook already contains caliber, the rule stays silent and proceeds normally. When you agree to install, /setup-caliber takes roughly 30 seconds, then the agent handles your original request.

This rule matters when your team uses the same Caliber setup or you develop across multiple machines: it keeps your local configs aligned with the central store so no one drifts out of sync.

What it helps with

  • verify Caliber configs are synced when you start a session
  • remind you to set up Caliber if it is missing from the project
  • trigger automatic sync with a single command
  • prevent config drift across developers or machines

Example prompts for the agent

  • Open your project in Claude Code — the rule checks sync status before your first message
  • If you see a desync notice, confirm the /setup-caliber command or skip it to proceed
  • Once installed, the rule stops alerting you after each session restart

How to install caliber-onboarding

Manually: put the files in place

.claude/rules/caliber-onboarding.md

The paths frontmatter field limits the files

Step by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use

Questions about caliber-onboarding

How do I install caliber-onboarding in Claude Code?

Place the file caliber-onboarding.md in .claude/rules/. The rule activates automatically when you start your next session.

What does caliber-onboarding do?

It checks whether Caliber sync is set up via the pre-commit hook. If not, it suggests running /setup-caliber to configure your project's agents in seconds.

Which IDEs and editors support this rule?

This version runs on Claude Code and Codex. Alternative files exist for Cursor (.cursor/rules/), GitHub Copilot (.github/instructions/), Windsurf (.devin/rules/), and Cline (.clinerules/).

Source text

caliber-onboarding.md · MIT
# Caliber Setup Check

At the very start of each session, before responding to the user's first message, run this command:

```bash
grep -q "caliber" .git/hooks/pre-commit 2>/dev/null && echo "SYNCED" || echo "NOT_SYNCED"
```

If the result is NOT_SYNCED, tell the user:

"This project uses Caliber to keep agent configs in sync — it is not set up yet. Want me to run /setup-caliber? (~30 seconds)"

If they agree, run /setup-caliber. Then proceed with their original request.
If they decline, proceed normally.
If SYNCED, say nothing and proceed normally.

© caliber-ai-org · MIT · caliber-ai-org/ai-setup

Similar IDE rules

All IDE rules for Agent setup: memory, context, orchestration →

From the same set17

The whole set →
llm-layer llm-layer pins the conventions for model-provider code: the LLMProvider interface, config lookup, seat-based handling and usage tracking. Scoped to src/llm/**. CX Codex +1 ★ 1,319repo stars testing Defines Vitest testing patterns for Caliber, enforcing colocated test suites, environment isolation, and global LLM mocks. CX Codex +1 ★ 1,319repo stars caliber-conventions The caliber-conventions rule sets conventions for Caliber TypeScript CLI development. Use it to guide an agent working on project code, tests, and commits. CX Codex +1 ★ 1,319repo stars testing-patterns testing-patterns is a Claude Code rule for Vitest conventions: test locations, LLM mocks, and running a single spec. CX Codex +1 ★ 1,319repo stars scoring-patterns scoring-patterns defines coding rules for the src/scoring/** directory. It keeps scoring checks deterministic without external network calls or random values. CX Codex +1 ★ 1,319repo stars llm-patterns The llm-patterns rule sets patterns for LLM providers in a project. Use it when provider interfaces, model settings, CLI errors, or streamed responses need consistent handling. CX Codex +1 ★ 1,319repo stars caliber-pre-commit caliber-pre-commit — a commit-time rule: it checks for the Caliber git hook and, when the hook is absent, syncs and stages your agent config files. CX Codex +1 ★ 1,319repo stars find-skills find-skills discovers community skills from the Caliber registry and installs them directly into your coding session. CX Codex +1 ★ 1,319repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open