Installation

Installation

Step 1: Clone dotforge (once per machine)

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

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

export DOTFORGE_DIR="$HOME/path/to/dotforge"

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 dotforge is available in the Claude Code marketplace:

claude plugin install dotforge

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

Updating

From any project:

/forge global sync

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

Then in each project:

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