Quick configuration
Git Town prompts for all the configuration information it needs. The commands below set additional configuration options that might be helpful in your use case. We will cover the full list of options later.
Shorter commands
Having to type git town <command>
gets old. Git Town can install aliases for
its commands that make them feel like native Git commands, i.e. allow you to run
for example git hack
instead of git town hack
. To enable this feature:
git town alias true
To remove these aliases, run git town alias false
.
API access to your hosting provider
Git Town can ship branches that have an open pull request by merging this pull request via your code hosting service's API. This feature is currently implemented for GitHub and Gitea only. To enable it, create an API token for your account at your code hosting provider.
Then run this command inside the folder that contains your Git repository to provide this API token to Git Town.
git config --add git-town.github-token <your api token>
Delete remote branches
Some code hosting providers automatically delete feature branches after merging them. This is a very useful feature that you should enable if possible. It can interfere with Git Town's attempts to also delete this branch after shipping it. To make Git Town play along, run:
git config git-town.ship-delete-remote-branch false
Shell autocompletion
Follow the instructions given by git-town help completions
to install the
autocompletions for your shell.