detached

This setting configures whether Git Town pulls new commits from the main or perennial branch at the root of your branch hierarchy. This can help if you encounter too many interruptions through expensive recompiles in busy monorepos after syncing.

options

When set to false (the default value), git town sync pulls updates from the perennial root branch of your stack. When set to true, git town sync does not pull in changes from the perennial root.

CLI flag

Commands that sync branches have a --detached CLI flag to enable detached mode for that invocation. If detached mode is enabled permanently via the configuration settings described on this page, you can override it for a single run by with the --no-detached flag.

config file

The config file can enable detached mode permanently for all commands like this:

[sync]
detached = true

Git metadata

To enable detached mode permanently for all commands using Git metadata:

git config [--global] git-town.detached <true|false>

The optional --global flag applies this setting to all Git repositories on your machine. Without it, the setting applies only to the current repository.

environment variable

You can configure whether Git Town syncs Git tags by setting the GIT_TOWN_DETACHED environment variable.