claude-config — backup of agent infrastructure

This folder is a read-only backup of files that live at ~/.claude/ on the primary machine. Claude Code reads from the originals at runtime; these copies are version-controlled so the configuration can be recovered on machine rebuild or replicated to other machines.

Files

Backup path	Lives at runtime	What it is
`CLAUDE.md`	`~/.claude/CLAUDE.md`	Machine-wide agent instructions loaded into every Claude Code session
`AGENTS_INDEX.md`	`~/.claude/agents/AGENTS_INDEX.md`	Canonical catalog of every subagent + skill on this machine
`bin/obsidian-research.mjs`	`~/.claude/bin/obsidian-research.mjs`	CLI for querying / saving research notes across vault + Compendium
`bin/presence.mjs`	`~/.claude/bin/presence.mjs`	Cross-agent presence (“who’s working on what right now”)
`bin/presence-hook.mjs`	`~/.claude/bin/presence-hook.mjs`	PostToolUse hook that emits heartbeat records
`bin/auto-capture.mjs`	`~/.claude/bin/auto-capture.mjs`	WebFetch/WebSearch hook that saves results to Research/Sources

NOT backed up here (and why)

Excluded	Why
`~/.claude/obsidian.json`	Contains the local-REST-API key — secret, never publish
`~/.claude/settings.json`	Per-machine deny lists + MCP credentials — machine-specific
`~/.claude/agents/*.md` (specialists)	Already version-controlled in this Compendium under their own repos (marketing-design firm) and via Claude Code’s plugin system; only the cross-cutting `AGENTS_INDEX.md` is here
`~/.claude/skills/`, `~/.claude/plugins/`, `~/.claude/sessions/`	Large directories of upstream content + ephemeral session state; pull from upstream when restoring

Restoring on a new machine

# Assuming you've cloned Compendium to d:\Vault\Compendium
$src = "d:\Vault\Compendium\System\claude-config"
$dst = "$env:USERPROFILE\.claude"
 
# CLAUDE.md
Copy-Item "$src\CLAUDE.md" "$dst\CLAUDE.md" -Force
 
# AGENTS_INDEX
New-Item -ItemType Directory -Force "$dst\agents" | Out-Null
Copy-Item "$src\AGENTS_INDEX.md" "$dst\agents\AGENTS_INDEX.md" -Force
 
# bin/*.mjs scripts
New-Item -ItemType Directory -Force "$dst\bin" | Out-Null
Copy-Item "$src\bin\*.mjs" "$dst\bin\" -Force
 
# Then create obsidian.json manually with your own API key:
# {"apiKey": "...", "baseUrl": "http://127.0.0.1:27123", "vaultPath": "d:\\Vault\\AI Vault", ...}

Drift detection

These copies will drift from the runtime originals over time. To diff:

$src = "d:\Vault\Compendium\System\claude-config"
$home_claude = "$env:USERPROFILE\.claude"
fc.exe "$src\CLAUDE.md" "$home_claude\CLAUDE.md"
fc.exe "$src\AGENTS_INDEX.md" "$home_claude\agents\AGENTS_INDEX.md"
fc.exe "$src\bin\obsidian-research.mjs" "$home_claude\bin\obsidian-research.mjs"

Re-copy from runtime → backup when intentional changes were made.

Last sync

2026-05-23 — initial creation. Sync includes the Compendium-aware CLI extension (--vault-only / --compendium-only flags + Node-fallback filesystem walk).

Compendium

Explorer

README