Config Management
Learn how to quickly make changes to your Git-Tool config without leaving the command line.

config

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).

Example

1
# Show your current config
2
gt config
Copied!

config list

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.

Example

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

config add

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.

Options

    -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.

Example

1
# Install the Visual Studio developer prompt app
2
gt config add apps/visualstudio
3
4
# Install the GitHub repository service, overwriting it if it exists
5
gt config add services/github -f
Copied!

config alias

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 github.com/SierraSoftworks/blog

Options

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

Example

1
# Add an alias for git-tool
2
gt config alias gt github.com/SierraSoftworks/git-tool
3
4
# View the repository name associated with the gt alias
5
gt config alias gt
6
7
# Remove the gt alias
8
gt config alias -d gt
Copied!

config feature

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.

Example

1
# Check the status of all of your feature flags
2
gt config feature
3
4
# Disable crash reporting
5
gt config feature telemetry false
6
7
# Check whether crash reporting is enabled
8
gt config feature telemetry
Copied!

auth

The gt auth command allows you to manage the authentication tokens used to connect to remote repository hosts like GitHub.
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.

Options

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

Example

1
# Store an access token for github.com
2
gt auth github.com
3
4
# Store an access token for github.com without using stdin
5
gt auth github.com --token $GITHUB_TOKEN
6
7
# Remove an access token for github.com
8
gt auth -d github.com
Copied!

apps

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

Example

1
# List the apps you have added to your configuration
2
gt apps
Copied!

services

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

Example

1
# List the services you have added to your configuration
2
gt services
Copied!
Last modified 20d ago