Getting Started
New to Chain Hub?
On this page
Chain Hub is a centralized local directory on your machine (~/chain-hub) designed to store, manage, and sync custom AI agent instructions, rules, workflows, and memory definitions across all your favorite IDEs.
Instead of maintaining separate configuration files (like .cursorrules, CLAUDE.md, or custom Windsurf system instructions) across multiple different projects and editors, you write your instructions once as clean Markdown files within the Hub.
Get the CLI
On macOS or Linux, the fastest install is one command (handles common npm permission errors on /usr/local):
Then run chain init and chain setup. If chain is not recognized in the same terminal window, open a new tab or reload your shell (source ~/.zshrc) so PATH updates apply. See Quickstart for the full flow and alternatives.
How it works
When you run chain setup in your terminal, the CLI automatically links your hub directories to the specific configuration paths of every supported AI editor installed on your system.
Claude Code -> ~/.claude/skills/ Cursor -> ~/.cursor/skills/ Windsurf -> ~/.codeium/windsurf/skills/ Antigravity -> ~/.gemini/antigravity/skills/
- Central Storage (
~/chain-hub): All your custom rules, skills, agents, and workflows are stored in one place on your disk. This is the single source of truth. - Automated Symlinking: Running
chain setupcreates filesystem symlinks from this folder to your editor configuration directories. - Instant Updates: Because these are native filesystem symlinks, any changes you make in your hub are immediately visible to your editors. There is no need to copy-paste changes or restart your active editor sessions.
Key capabilities
- Tiered Skill System: Bundles 14 read-only Protected Core operational skills for managing the hub itself, alongside customizable Personal, Registry, Community, and GitHub Pack skills you install or author.
- Skill discovery, not magic: Editors see skill descriptions and load the matching playbook — they do not auto-create skills when you mention a vendor. Install with
chain add/chain search, author withchain new, or improve existing skills via the Brain pipeline. - Registry auto-sync: Skills on disk are registered automatically in
skills-registry.yamlduringchain setup, hub load, andchain validate --fix— no Unknown bucket drift after manual copies. - Universal Memory Engine: Store global and workspace-specific rules in English, automatically synced to IDE rules formats.
- Continual Learning Loop: Proactively capture learnings from coding outcomes (
chain capture) and reflect them into reviewed, automated improvements using the Reflection pipeline. - Multi-Device Git Sync: Effortlessly synchronize your entire instruction library across multiple workstations using a secure Git remote.
- Local Dashboard: Start a local-first web interface (
chain hub) to manage and edit your library — skills, rules, sync, Library Health, and embedded docs. - Chain Hub Pro (optional): Early-access add-on for Brain (Memory + Pipeline), Design System Pro features, and a private skill pack on the same
~/chain-hubtree. See Chain Hub Pro.