Documentation
Everything you need to back up, restore, and share your Claude Code environment.
Getting Started
Install the CLI globally, authenticate, then push your environment — including CLAUDE.md, agents, slash commands, MCP servers, and plugins.
npm install -g respawn-clirespawn loginrespawn global push -m "my setup"
# backs up:
# ~/.claude/CLAUDE.md
# ~/.claude/agents/code-reviewer.md
# ~/.claude/commands/deploy.md
# ~/.claude/settings.json (MCP servers, hooks)
# ~/.claude/plugins/CLI Reference
| Command | Description |
|---|---|
| respawn login | Authenticate with Respawn |
| respawn global push -m "msg" | Back up ~/.claude/ — CLAUDE.md, agents, commands, settings |
| respawn global pull | Restore ~/.claude/ — skills, commands, MCP config and all |
| respawn global log | View global backup history |
| respawn init | Initialize a project and create .respawnrc |
| respawn init --from <name> | Link to an existing project (continues version history) |
| respawn push -m "msg" | Back up .claude/ in current directory |
| respawn pull | Restore .claude/ |
| respawn pull -p <name> | Pull from a named project (no .respawnrc needed) |
| respawn log | View project backup history |
| respawn share | Generate a shareable link |
| respawn clone [token] | Clone someone's setup |
| respawn status | Show current backup status |
Backup profiles
Control how much of your environment gets included in each backup. Set your profile during respawn init.
| Profile | What's included | Typical size |
|---|---|---|
| essential (default) | settings.json, plugins/installed_plugins.json | ~5 KB |
| standard | + CLAUDE.md, agents/ (skills), commands/ (slash commands) | ~50 KB |
| full | + CLAUDE.md, agents/, commands/, conversation history | ~5 MB |
Reuse existing projects
Two ways to start a new folder from an existing project backup:
Continue version history
Link a new folder to an existing project. Future pushes continue the same version history.
cd new-folder
respawn init --from my-project
respawn pullFork as a new project
Pull files from an existing project into a new folder. A new project ID is created automatically, so future pushes won't affect the original.
cd new-folder
respawn pull --project my-projectMCP Setup
Add the Respawn MCP server to your Claude Code settings to back up and restore directly from within Claude.
Configuration
Add to ~/.claude/settings.json:
{
"mcpServers": {
"respawn": {
"command": "npx",
"args": ["-y", "respawn-mcp"]
}
}
}Available MCP tools
| Tool | Description |
|---|---|
| backup | Back up your current environment |
| restore | Restore your environment from a backup |
| list_backups | View your backup history |
| share | Generate a shareable link |
Plugin Setup
Install the Respawn plugin to access backup commands directly from the Claude Code slash command menu.
Install
In Claude Code, run:
/plugin install respawn@rubric-devAvailable commands
| Command | Description |
|---|---|
| /respawn:backup [message] | Back up your current environment |
| /respawn:restore | Restore your environment |
| /respawn:share | Generate a shareable link |
| /respawn:status | Show current backup status |
respawn-cli to be installed globally.