av-stack-branch(1) in CLI

View the av-stack-branch(1) command documentation in manual pages for Stacked PRs CLI. Use this command to create or rename a branch in the stack.

NAME

av-branch - Create or rename a branch in the stack

SYNOPSIS

av branch [-m | --rename] [--force] [--parent <parent_branch>] <branch-name> [<parent_branch>]

DESCRIPTION

Create a new branch that is stacked on the current branch by default

If the --rename/-m flag is given, the current branch is renamed to the name instead of creating a new branch. Branches should only be renamed with this command (not with git branch -m ...) because av needs to update internal tracking metadata that defines the order of branches within a stack. If you renamed a branch with git branch -m, you can retroactively update the internal metadata with av branch --rename <old-branch-name>:<new-branch-name>.

OPTIONS

--parent <parent_branch> : Instead of creating a new branch from current branch, create it from specified <parent_branch>

-m, --rename : Rename the current branch to the provided <branch_name> instead of creating a new one, only if a pull request does not exist.

--force : Force rename the branch, even if a pull request exists.

--split : Splits the last commit into a new branch, if no branch name is given create one based on commit message.