/assign

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

<objective>

Manually assign files to a virtual branch using the rub command.

</objective> <workflow>

Step 1: Check GitButler Active

If GITBUTLER_ACTIVE=false:

GitButler is not initialized. File assignment requires GitButler.

Exit if not active.

Step 2: Get Current State

but branch list

Step 3: Parse Arguments or Ask

If both file and branch provided, proceed.

Otherwise:

AskUserQuestion({
  questions: [
    {
      question: "What operation?",
      header: "Operation",
      options: [
        {
          label: "Assign file to branch",
          description: "Move file to specific branch",
        },
        {
          label: "Unassign file",
          description: "Remove file from all branches",
        },
        { label: "Move commit to branch", description: "Relocate a commit" },
        { label: "Squash commits", description: "Combine two commits" },
      ],
      multiSelect: false,
    },
  ],
});

Step 4: Execute Rub Command

Assign file to branch:

but rub ${file} ${branch}

Unassign file:

but rub ${file} 00

Move commit to branch:

but rub ${commitSha} ${branch}

Squash commits:

but rub ${commit1} ${commit2}

Step 5: Confirm

but branch list

</workflow>

<rub_reference>

Operation	Command	Result
Assign file	but rub FILE BRANCH	File moves to branch
Unassign	but rub FILE 00	File becomes unassigned
Amend	but rub FILE COMMIT	Add file to commit
Move commit	but rub COMMIT BRANCH	Commit moves to branch
Squash	but rub COMMIT1 COMMIT2	Commits combined

</rub_reference>

<success_criteria>

• Operation executed successfully
• Branch state updated
• User understands rub command options

</success_criteria>