git town propose

git town propose [-b <text> | --body <text>] [-f <path> | --body-file <path>] [-t <text> | --title <text>] [-d | --detached] [--dry-run] [-v | --verbose]

The propose command helps create a new pull request (also known as merge request) for the current feature branch. It opens your forge’s website to create a new proposal in your browser and pre-populates information like branch and source/target repository. It also syncs the branch to merge before opening the pull request in detached mode.

Proposing prototype and parked branches makes them feature branches.

You can create pull requests for repositories hosted on:

On non-Windows systems, Git Town will first read the BROWSER environment variable to determine the browser command. If it isn’t set, Git Town will try various common commands like open, xdg-open, or x-www-browser.

Options

-b <text>
--body <text>

Pre-populate the body of the pull request with the given text.

-f <path>
--body-file <path>

When called with the --body-file aka -f flag, it pre-populates the body of the pull request with the content of the given file. The filename - reads the body text from STDIN.

-t <text>
--title <text>

When called with the --title <title> aka -t flag, the propose command pre-populate the title of the pull request to the given text.

-s
--stack

The --stack aka -s parameter makes Git Town propose all branches in the stack that the current branch belongs to.

--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.

-v
--verbose

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

Configuration

You can configure the forge type with the hosting-platform setting.

When using SSH identities, this command uses the hostname in the hosting-origin-hostname setting.