Installation

Installation

Step 1: Clone claude-kit (once per machine)

git clone --depth 1 https://github.com/luiseiman/claude-kit.git
cd claude-kit
export CLAUDE_KIT_DIR="$(pwd)"

Add to your shell profile (~/.zshrc or ~/.bashrc):

export CLAUDE_KIT_DIR="$HOME/path/to/claude-kit"

Step 2: Install global config

./global/sync.sh

This installs:

Component	Location	Method
Skills (15)	~/.claude/skills/	Symlinks
Agents (7)	~/.claude/agents/	Symlinks
/forge command	~/.claude/commands/forge.md	Copy
Global CLAUDE.md	~/.claude/CLAUDE.md	Merge
Global settings.json	~/.claude/settings.json	Merge

Cross-platform: Linux, macOS, WSL, Git Bash.

Step 3: Verify

/forge global status

═══ GLOBAL STATUS ═══
CLAUDE.md:     ✓ synced
settings.json: deny list 9 items
Skills:        15/15 installed
Agents:        7/7 installed
Commands:      forge.md (file)

Step 4: Bootstrap a project

cd ~/my-project
claude

/forge init

Done. Your project now has a complete .claude/ setup.

Alternative: Plugin install

If claude-kit is available in the Claude Code marketplace:

claude plugin install claude-kit

This installs skills, agents, hooks, and commands without needing git clone.

Updating

From any project:

/forge global sync

This auto-pulls the latest claude-kit and syncs ~/.claude/.

Then in each project:

/forge diff    # see what changed
/forge sync    # apply updates