Skip to content

Backup

ctx

ctx backup

Create timestamped tar.gz archives of project context and/or global Claude Code data. Optionally copies archives to an SMB share via GVFS.

ctx backup [flags]

Flags:

Flag Description
--scope Backup scope: project, global, or all (default: all)
--json Output results as JSON

Scopes:

Scope What's archived
project .context/, .claude/, ideas/, ~/.bashrc
global ~/.claude/ (excludes todos/)
all Both project and global (default)

Environment:

Variable Purpose
CTX_BACKUP_SMB_URL SMB share URL (e.g. smb://host/share)
CTX_BACKUP_SMB_SUBDIR Subdirectory on share (default: ctx-sessions)

Examples:

ctx backup                       # Back up everything (default: all)
ctx backup --scope project       # Project context only
ctx backup --scope global        # Global Claude data only
ctx backup --scope all --json    # Both, JSON output