git town prepend

git town prepend [<branch-name>...] [--(no)-auto-resolve] [-b | --beam] [--body <string>] [-c | --commit] [-d | --(no)-detached] [--dry-run] [-h | --help] [--(non)-interactive] [(-m | --message) <message>] [--propose] [-p | --prototype] [--(no)-push] [--(no)-stash] [--(no)-sync] [(-t | --title) <text>] [-v | --verbose]

main
 \
* feature-2

main
 \
* feature-1
   \
    feature-2

If your Git workspace is clean (no uncommitted changes), it also syncs the current feature branch to ensure you work on top of the current state of the repository. If the workspace is not clean (contains uncommitted changes), git town prepend does not perform this sync to let you commit your open changes.

If the branch you call this command from has a proposal, this command updates it. To do so, it pushes the new branch.

Options

--auto-resolve
--no-auto-resolve

Disables automatic resolution of phantom merge conflicts.

-b
--beam

Moves (“beams”) one or more commits from the current branch to the new parent branch that gets created. Lets you select the commits to beam via a visual dialog. Beaming suppresses all branch updates. Any merge conflicts encountered while beaming arise from moving the beamed commits.

--body <string>

Pre-populate the body of the pull request to create with the given text. Requires --propose.

-c
--commit

When given, commits the currently staged changes into the branch to create and remains on the current branch. This is intended to quickly commit changes unrelated to the current branch into another branch and keep hacking on the current branch. Committing suppresses all branch updates to allow you to get your open changes committed.

-d
--detached
--no-detached

The --detached aka -d flag enables detached mode for the current command. If detached mode is enabled through configuration data, the --no-detached flag disables detached mode for the current command.

In detached mode, feature branches don’t receive updates from the perennial branch at the root of your branch hierarchy. This can be useful in busy monorepos.

--dry-run

Use the --dry-run flag to test-drive this command. It prints the Git commands that would be run but doesn’t execute them.

-h
--help

Display help for this command.

--interactive
--non-interactive

Enables or disables interactive dialogs.

-m <text>
--message <text>

Commit message to use together with --commit. Implies --commit.

--propose

Propose the created branch.

To always propose new branches, set the share new branches setting to propose.

-p
--prototype

Adding the --prototype aka -p switch creates a prototype branch.

--push
--no-push

The --push/--no-push argument overrides the push-branches config setting.

--stash
--no-stash

Enables or disables stashing for this invocation.

--sync
--no-sync

Enables or disables automatic syncing of the current branch before prepending the new one.

-t <text>
--title <text>

Pre-populate the title of the pull request to create with the given text. Requires --propose.

-v
--verbose

The --verbose aka -v flag prints all Git commands run under the hood to determine the repository state.

Configuration

If share-new-branches is configured, git town hack creates a remote tracking branch for the new feature branch. This behavior is disabled by default to make git town hack run fast. The first run of git town sync will create the remote tracking branch.

If the configuration setting new-branch-type is set, git town prepend creates a branch with the given type.

See also

• append creates the new branch as a child of the current branch
• hack creates the new branch as a child of the main branch