Claudebase

Your Claude Code setup is infrastructure. Agents, skills, rules, hooks, memory — these accumulate over weeks of work and represent real investment. Losing them to a disk wipe, or manually recreating them on a new machine, shouldn't happen.

Claudebase syncs your entire Claude Code environment to a private GitHub repo. Profiles let you switch between work, personal, and team configurations instantly. Secret scanning, automatic backups, and multi-machine conflict detection keep things safe.

Install

claude plugin marketplace add rohithzr/claudebase
claude plugin install claudebase@rohithzr

Then restart Claude Code or run /reload-plugins.

# Update
claude plugins marketplace update
claude plugin update claudebase@rohithzr

# Uninstall
claude plugin uninstall claudebase@rohithzr
claude plugin marketplace remove rohithzr

Quick Start

/sync-setup          # One-time: create private GitHub repo + first push
/sync-push           # Back up current config
/sync-pull           # Restore config from GitHub
/sync-status         # Compare local vs remote
/sync-profiles list  # Manage named profiles
/sync-config         # View/change settings

Type /sync to see all commands. Full namespaced form (/claudebase:sync-push) also works.

Why Not Just Copy the Folder?

| | Manual copy | Claudebase | |---|---|---| | Secret scanning | No | Blocks API keys, PEM files, tokens | | Multi-machine safety | No | Detects conflicting pushes | | Profiles | No | Switch work/personal/team instantly | | Shared team layer | No | Base config + per-person overlay | | Automatic backups | No | Timestamped backup before every pull | | Dry run preview | No | See what changes before committing |

Examples

Sync between machines

Laptop:  /sync-push               # Push your config
Desktop: /sync-pull               # Pull it down
Desktop: # ... tweak agents, add rules ...
Desktop: /sync-push --force       # Push from second machine
Laptop:  /sync-pull               # Get desktop's changes

Switch contexts during the day

/sync-profiles switch work        # Load work config
# ... deep coding session ...
/sync-push                        # Save work state
/sync-profiles switch personal    # Load personal config

Preview before committing

/sync-push --dry-run              # See what would be pushed
/sync-pull --dry-run              # See what would change locally
/sync-profiles diff work personal # Compare two profiles

Onboard a teammate

# You: push your team config to a shared profile
/sync-profiles create team-defaults --from work
/sync-push

# Teammate: on their machine
/sync-setup
/sync-pull --profile team-defaults

Recover from a bad change

/sync-pull                        # Restores from last push
                                        # Old config saved to backups/

Three-machine round-robin

Laptop:   /sync-push
Desktop:  /sync-pull && /sync-push --force
CI Box:   /sync-pull && /sync-push --force
Laptop:   /sync-pull              # Gets everything

What Gets Synced

| Path | Description | |------|-------------| | .mcp.json | MCP server configurations | | .claude/settings.json | Team-shared settings | | .claude/agents/ | Subagent definitions | | .claude/commands/ | Slash command templates | | .claude/skills/ | Reusable knowledge modules | | .claude/hooks/ | Lifecycle hooks | | .claude/rules/ | Organization rules | | .claude/agent-memory/ | Persistent agent memory | | .auto-memory/ | Auto-memory files |

Opt-in: Global ~/.claude/settings.json (--include-global), skills-lock.json (/claudebase:config set sync_agent_skills true — syncs the lock file; prints install commands on pull, does not auto-execute).

Never synced: settings.local.json, conversations, sessions, shell snapshots, logs.

How It Works

           ┌──────────────┐
Machine A  │ .claude/     │──push──┐
           │ .mcp.json    │        │     ┌──────────────────────┐
           │ .auto-memory/│        ├────>│  GitHub (private)    │
           └──────────────┘        │     │  profiles/default/   │
                                   │     │  profiles/work/      │
           ┌──────────────┐        │     │  shared/             │
Machine B  │ .claude/     │<─pull──┘     └──────────────────────┘
           │ .mcp.json    │
           │ .auto-memory/│
           └──────────────┘

When you pull, shared/ is applied first as a base layer, then profiles/<name>/ overlays on top. This lets you maintain organization-wide defaults while customizing per context.

Push is blocked if a different machine pushed since your last sync — pull first or use --force to override.

Safety

| Protection | How it works | |-----------|-------------| | Backup before pull | Every pull creates a timestamped backup (last 10 kept) | | Confirmation prompt | Pull shows a diff and asks before overwriting (--yes to skip) | | Secret scanning | Blocks API keys, PEM keys, Bearer tokens (--force to override) | | Multi-machine detection | Blocks push if another machine pushed since your last sync | | Private repo | Created private by default | | Dry run | --dry-run on push/pull shows changes without applying | | Never-sync list | Conversations, sessions, logs excluded by design |

Configuration

/sync-config show                      # View all settings
/sync-config set auto_push true        # Auto-push on session end
/sync-config set include_global true   # Always sync global settings
/sync-config set machine_id my-laptop  # Custom machine identifier
/sync-config reset auto_push           # Reset to default

Claudebase also registers two lifecycle hooks:

• SessionStart — quiet diff check (tells you if config is out of sync)
• SessionEnd — auto-pushes if auto_push is enabled

Requirements

GitHub CLI (gh) | jq | git | bash

Claudebase uses gh for all GitHub operations — no tokens to manage, no OAuth, no stored credentials.

macOS

brew install gh jq git
gh auth login

Linux (Debian/Ubuntu)

# GitHub CLI (https://github.com/cli/cli/blob/trunk/docs/install_linux.md)
(type -p wget >/dev/null || sudo apt-get install wget -y) \
  && sudo mkdir -p -m 755 /etc/apt/keyrings \
  && out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
  && cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
  && sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
  && echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
  && sudo apt update \
  && sudo apt install gh -y

sudo apt-get install -y jq git
gh auth login

Windows — Install Git for Windows (includes Git Bash), then:

winget install GitHub.cli
winget install jqlang.jq
gh auth login

Contributing

Contributions welcome. See the Code of Conduct.

git clone https://github.com/rohithzr/claudebase.git
cd claudebase
git submodule update --init --recursive

Running tests

./tests/bats/bin/bats tests/                 # All 158 tests
./tests/bats/bin/bats tests/unit/            # 57 unit tests
./tests/bats/bin/bats tests/integration/     # 72 integration tests
./tests/bats/bin/bats tests/e2e/             # 29 E2E tests

CI runs on every push across macOS, Linux, and Windows.

Local development

claude --plugin-dir ./

License

MIT