Home

Bluetemberg

Scaffold vendor-neutral AI tooling config (rules, agents, skills) with cross-platform sync for Cursor, Claude Code, GitHub Copilot, Gemini CLI, and Windsurf.

What is Bluetemberg?

Bluetemberg is an open-source CLI tool (published on npm as bluetemberg, MIT) that sets up and maintains AI assistant configuration across multiple platforms from a single source of truth. Write your rules, agent definitions, and skills once in llm/, and Bluetemberg syncs them to Cursor, Claude, GitHub Copilot, Gemini CLI, and Windsurf with the correct format for each.

Rules are self-contained Markdown files — the AI reads them directly, no cross-file dependencies. The sync engine only transforms frontmatter for each platform. sync --check in CI catches any drift before it ships.

If you're wondering why this exists or how it's different from maintaining platform configs by hand, start with Why Bluetemberg.

Quick links

• Why Bluetemberg — design philosophy and what problem it solves
• Installation — install from public npm (no auth or registry config)
• Commands — CLI reference for init and sync
• Configuration — bluetemberg.config.json schema
• Profiles — team profiles and what each one includes
• Writing Rules — how to write vendor-neutral rules
• Writing Agents — agent definition format
• Writing Skills — SKILL.md format
• Writing Hooks — Cursor hooks.json in llm/
• Guardrails — declarative checks enforced as platform-native hooks
• Writing Commands — Claude Code slash commands in llm/commands/
• Writing Prompts — Copilot prompt files in llm/prompts/
• Architecture — how the sync engine works
• Adapters — sync extensions, platform gates, roadmap
• Consumer Setup — set up a downstream project
• Registry — install community & official packs (official packs live in bluetemberg-packs)
• Sources — pull rules from GitHub, PRPM, or cursor.directory and translate them to native format
• Contributing — dev setup, adding packs, and release process