Git-Tool

# Features

In some situations you may want finer grained control over the way Git Tool behaves. This is accomplished through the Git Tool configuration file and some of its advanced options.

# http_transport v1.2.19+

  • Default false

By default Git-Tool uses the SSH transport for git with URLs like [email protected]:sierrasoftworks/git-tool.git. In some situations, particularly those where you wish to run without authentication, you may prefer to use git's HTTPS transport instead.

TIP

Use gt config feature http_transport true to turn this flag on directly from your command line.

# create_remote v1.0+

  • Default true

Git-Tool will, if this feature is enabled and the --no-create-remote option is not specified, attempt to create a remote repository on your hosting provider for recognized services when running gt new. This can be helpful for users who don't want to manually set up a GitHub repo - but you can disable it if you prefer.

TIP

Use gt config feature create_remote false to turn this flag off directly from your command line.

# create_remote_private v2.0+

  • Default true

When creating a remote repository with gt n and the create_remote feature enabled, Git-Tool will (by default) create a Private repo (if your service supports it). You can usually convert a Private repository to a Public one when you're ready, however if you would prefer to create Public repos, you can disable this feature flag.

TIP

Use gt config feature create_remote_private false to turn this flag off directly from your command line.

# open_new_repo_in_default_app v2.1.1+

  • Default false

When this feature flag is enabled, Git-Tool will automatically open newly created repositories in your default application when running gt new. This is equivalent to passing the --open flag.

TIP

Use gt config feature open_new_repo_in_default_app true to turn this flag on directly from your command line.

# telemetry v2.1.21+

  • Default true

Git-Tool sends limited telemetry to Sentry.ioopen in new window when system-level crashes occur to try and help us figure out the these crashes and improve the tool for everyone. If you would prefer not to submit this telemetry, you can disable it with this feature flag.

TIP

Use gt config feature telemetry true to turn this flag on directly from your command line.

# native_clone v1.2.18+ v2.0+

  • Default false

WARNING

This feature flag is not supported in Git-Tool v2.x, with this behaviour being the default in all newer versions of Git-Tool.

Git-Tool supports using your local git executable to clone and initialize repositories instead of using its built-in git logic. If you wish to use your local git executable, set this feature to true in your config. Doing so may resolve issues with smart-card/YubiKey authentication, or with SSH-Agent on Windows.