Set up configuration

If your repository already contains a .git-branches.toml or .git-town.toml file, you are good to go. If not or something doesn’t work, run Git Town’s setup assistant. It walks you through every configuration option and gives you a chance to adjust it.

git town config setup

You can find more background around how Git Town stores configuration in the overview of all configuration options.

Access tokens

API access multiplies Git Town’s utility:

  • if the parent of a branch is not known, Git Town can look for a pull requests of this branch and uses their parent branch
  • updates affected pull requests when you prepend, rename, remove branches or change their parent
  • click the “merge” button on a pull request from your CLI

Configuring API access takes only one minute. Here is how you do it: