/undo

<butler_context> !${CLAUDE_PLUGIN_ROOT}/scripts/git/gitbutler-context.sh </butler_context>

<objective>

Undo the last GitButler operation or restore to a specific snapshot.

</objective> <workflow>

Step 1: Check GitButler Active

If GITBUTLER_ACTIVE=false:

GitButler is not initialized. Use git reflog for recovery.

Exit if not active.

Step 2: Show Operation Log

but oplog

Step 3: Choose Action

If no argument provided:

AskUserQuestion({
  questions: [
    {
      question: "What would you like to do?",
      header: "Action",
      options: [
        {
          label: "Undo last operation (Recommended)",
          description: "Revert the most recent change",
        },
        {
          label: "Restore to specific snapshot",
          description: "Pick a point from the operation log",
        },
        { label: "Create manual snapshot", description: "Save current state" },
      ],
      multiSelect: false,
    },
  ],
});

Step 4: Execute

Undo last:

but undo

Restore to snapshot:

but restore ${snapshotSha}

Create snapshot:

but snapshot -m "manual checkpoint before risky operation"

Step 5: Confirm

but branch list
but oplog | head -5

</workflow>

<success_criteria>

• Operation undone or snapshot restored
• Current state confirmed
• User understands recovery options

</success_criteria>