snapshot

🔸 snapshot

Command to save and restore the current state of orchestra members (Git worktrees) as snapshots. You can create backups before experimental changes or at important work milestones.

Overview

mst snapshot [options]
mst snap [options]  # alias

Usage Examples

Basic Usage

# Create snapshot of current orchestra member
mst snapshot

# Create snapshot with message
mst snapshot -m "State before feature implementation"

# Save changes to stash and create snapshot
mst snapshot --stash

# Create snapshots of all orchestra members
mst snapshot --all

Snapshot Management

# Display snapshot list
mst snapshot --list

# Display list in JSON format
mst snapshot --list --json

# Restore snapshot
mst snapshot --restore snapshot-20250120-103045

# Delete snapshot
mst snapshot --delete snapshot-20250120-103045

Options

Option	Short	Description	Default
--message <msg>	-m	Snapshot description	none
--stash	-s	Stash uncommitted changes	false
--all	-a	Snapshot all orchestra members	false
--list	-l	Display snapshot list	false
--restore <id>	-r	Restore snapshot	none
--delete <id>	-d	Delete snapshot	none
--json	-j	Output in JSON format	false
--force	-f	Execute without confirmation	false

Snapshot Contents

Snapshots save the following information:

• Git state (branch, HEAD, tracking info)
• Commit history (latest 10 commits)
• Staged files
• Modified files
• Untracked files
• Worktree metadata
• Stash (when using --stash option)

Snapshot File Format

{
  "id": "snapshot-20250120-103045",
  "worktree": "feature/auth",
  "timestamp": "2025-01-20T10:30:45Z",
  "message": "State before feature implementation",
  "git": {
    "branch": "feature/auth",
    "head": "abc123def456",
    "tracking": "origin/feature/auth",
    "ahead": 2,
    "behind": 0
  },
  "changes": {
    "staged": ["src/auth.js", "src/login.js"],
    "modified": ["README.md"],
    "untracked": ["test.log"]
  },
  "commits": [
    {
      "hash": "abc123def456",
      "message": "feat: add login functionality",
      "author": "[email protected]",
      "date": "2025-01-20T09:00:00Z"
    }
  ],
  "stash": {
    "ref": "stash@{0}",
    "message": "WIP on feature/auth: abc123d feat: add login"
  }
}