Config Management

config v1.5+

The gt config command will print your current config.yml file to stdout. It's a great way to quickly view your config, save it or share it.

The gt config command also has a series of sub-commands which allow you to manage your config without needing to kick open a text editor (along with autocomplete suggestions).


# Show your current config
gt config

config path v3.4+

Git-Tool stores repositories and scratchpads in directories you specify in your configuration file. The gt config path command allows you to quickly view and modify these directories, simplifying setup (especially when using the default configuration file location).


  • --scratch will show or change the scratchpad directory instead of the repository directory.


# Show the current repository path
gt config path

# Set the repository path to a new location
gt config path /path/to/repositories

# Show the current scratchpad path
gt config path --scratch

# Set the scratchpad path to a new location
gt config path --scratch /path/to/scratchpads

config list v1.5+

Git-Tool has a registry of useful apps and services which you can easily add to your configuration. The gt config list command will show you the items available in this registry and you can install any of them using gt config add.


Anyone is welcome to contribute their own templates to the Git-Tool registry, take a look at the registry documentation for information on how to do so.


# List the apps and services which can be added to your config automatically
gt config list

config add v1.5+

If you find something in the Git-Tool registry which you want to add to your config, you can use gt config add to install it.


  • -f, --force will overwrite any existing apps or services in your config which share the same names as those in the template you are installing.
  • -n, --name will set the name of the app or service to the value you specify. v3.0+


# Install the Visual Studio developer prompt app
gt config add apps/visualstudio

# Install the GitHub repository service, overwriting it if it exists
gt config add services/github-ssh -f

# Install versions of the GitHub service for your own and public repositories
gt config add services/github-ssh --name gh
gt config add services/github-public --name ghp

config alias v2.0+

Git-Tool allows you to setup aliases for repositories you use often. These aliases can give you a short name by which to refer to a repo and prevent confusion about which one you intended to open if multiple repos match a pattern you provide.

When using any Git-Tool command which expects a repository name, you can provide the alias instead. For example: gt o blog.


Aliases are a great way to distinguish between repos with similar or generic names. Try something like gt config alias blog gh:SierraSoftworks/blog


  • -d, --delete will delete the alias with the provided name from your config.


# Add an alias for git-tool
gt config alias gt gh:SierraSoftworks/git-tool

# View the repository name associated with the gt alias
gt config alias gt

# Remove the gt alias
gt config alias -d gt

config feature v2.1.21+

Git-Tool uses feature flags as a means of tweaking behaviour depending on your individual preferences. This command allows you to quickly view the feature flags you have set and modify their values, all with lovely autocomplete support.


For the full list of feature flags, take a look at the configuration docs.


# Check the status of all of your feature flags
gt config feature

# Disable crash reporting
gt config feature telemetry false

# Check whether crash reporting is enabled
gt config feature telemetry

auth v2.1+

The gt auth command allows you to manage the authentication tokens used to connect to remote repository hosts like GitHub. It accepts a single argument which corresponds to the name of a service (defined in your configuration) which you wish to authenticate to.


These access tokens are stored in your local system keychain for a bit of extra security, however if you are using a shared computer or are concerned about the physical security of your device, it is best to avoid this feature.


  • -d, --delete will remove the stored access token for the service you specify.


# Store an access token for
gt auth gh

# Store an access token for without using stdin
gt auth gh --token $GITHUB_TOKEN

# Remove an access token for
gt auth -d gh

apps v1.0+

The gt apps command provides you with a list of all of the applications you have added to your configuration.


# List the apps you have added to your configuration
gt apps

services v1.0+

The gt services command provides you with a list of all of the services you have added to your configuration.


# List the services you have added to your configuration
gt services