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):

curl -fsSL https://www.chainhub.one/install.sh | bash

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 setup creates 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 with chain new, or improve existing skills via the Brain pipeline.
  • Registry auto-sync: Skills on disk are registered automatically in skills-registry.yaml during chain setup, hub load, and chain 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-hub tree. See Chain Hub Pro.