Changelog

v0.1.0 — 2026-03-08

Initial public release.

CLI (respawn-cli)

Authentication

• ·respawn login — browser-based OAuth flow; tokens saved securely to ~/.respawn/config.json (mode 0600)

Global environment (`~/.claude/`)

• ·respawn global push [-m message] [-p profile] — upload ~/.claude/ + ~/.claude.json
• ·respawn global commit <message> — shorthand for global push -m
• ·respawn global pull [-v version] — restore any version (auto-backs up existing files first)
• ·respawn global log — full version history
• ·respawn global status — current backup state

Project environment (`.claude/`)

• ·respawn init [--name name] — create .respawnrc in current directory
• ·respawn push [-m message] — upload .claude/ with version tracking per project
• ·respawn commit <message> — shorthand for push -m
• ·respawn pull [-v version] — restore any version (auto-backs up existing files first)
• ·respawn log — version history for current project
• ·respawn status — current project backup state

Sharing

• ·respawn share [--global] — generate a public share link for the latest backup
• ·respawn clone <url> — apply a shared environment to .claude/ in the current directory

Backup profiles (global push only)

• ·essential (default) — settings, plugins, MCP config; no project data or history
• ·standard — essential + MEMORY.md files from projects
• ·full — everything, including .jsonl conversation history

Safety

• ·.env* files excluded from all backups, all profiles
• ·Auto-backup of existing files before any restore
• ·~/.claude.json included in global backups

Web dashboard (respawn.run)

Auth & onboarding

• ·Email/password signup and login via Supabase Auth
• ·3-step onboarding wizard for new users: install CLI → connect account → first backup
• ·profiles.onboarded flag prevents re-showing onboarding after completion

Dashboard

• ·Global tab — all versions of ~/.claude/, sortable, with download and delete
• ·Projects tab — all projects grouped by name, each with full version history
• ·File tree browser — browse and download individual files from any backup version
• ·Markdown renderer for .md files: headings, bold, italic, inline code, code blocks, lists, tables, blockquotes, horizontal rules, task lists, strikethrough
• ·Full-width empty state with copy-ready CLI commands when no backups exist
• ·? tooltip on tab labels explaining Global vs Project scope

Sharing

• ·Share page at /s/[token] — public, no login required
• ·Dynamic OG image (/api/og) via @vercel/og Edge function for rich link previews
• ·respawn share CLI command creates the share record and returns the URL

Profile

• ·Username edit modal (3–20 chars, letters/numbers/underscore)
• ·Username uniqueness check before save

Infrastructure

• ·Route protection via proxy.ts (Next.js 16 middleware)
• ·Supabase Storage bucket backups (private, per-user RLS)
• ·shares table with public SELECT RLS for share pages

Tests (86 total, all passing)

• ·Config read/write/clear lifecycle
• ·.env* exclusion (nested paths, variants)
• ·Backup profiles: essential/standard/full file selection
• ·Version incrementing by project name
• ·Username validation regex
• ·Onboarding flag routing logic
• ·Push/pull with network failure and missing config
• ·autoBackup with deeply nested directories
• ·Init idempotency (won't overwrite existing .respawnrc)