Working with Pull Requests

Submitting pull requests

When your local changes are ready, use the following commands to submit your changes upstream:

• gs branch submit (or gs bs) submits the current branch
• gs downstack submit (or gs dss) submits the current branch and all branches below it
• gs upstack submit (or gs uss) submits the current branch and all branches above it
• gs stack submit (or gs ss) submits all branches in the stack

Branch submission is an idempotent operation: pull requests will be created for branches that don't already have them, and updated for branches that do.

For new pull requests, these commands will prompt you for PR information. For example:

Important

Be aware that for stacks with multiple branches, you must have write access to the repository so that you can push branches to it. See Limitations for more information.

Navigation comments

Pull Requests created by git-spice will include a navigation comment at the top with a visual representation of the stack, and the position of the current branch in it.

This behavior may be changed with the spice.submit.navigationComment configuration key.

Non-interactive submission

Use the --fill flag (or -c since v0.3.0) provided by all the above commands to fill in the PR information from commit messages and skip the interactive prompts.

Additionally, with gs branch submit, you may also specify title and body directly.