Installation
Install Git-Tool on your computer and start using it.

Downloading Git-Tool

We publish the latest Git-Tool releases on [GitHub][release] for all of our supported platforms. Head on over and download the executable for your platform.
    Windows users on 64-bit platforms should download git-tool-windows-amd64.exe.
    Linux users on x86_64 platforms should download git-tool-linux-amd64 while those on ARM64 platforms should download git-tool-linux-arm64.
    Mac OS users on Intel platforms should download git-tool-darwin-amd64 while those on Apple Silicon should download git-tool-darwin-arm64.
Once you have downloaded the latest Git-Tool executable, rename it to git-tool and place it in a directory which is on your $PATH. On Linux and Mac OS machines, you may need to use chmod +x git-tool to mark the program as executable.

Using Cargo

If you'd prefer, or if we don't (yet) provide pre-built releases for your platform, you can build Git-Tool yourself using cargo. Note that you'll need to have rust installed for this to work.
Git-Tool depends on libdbus to integrate with the keychain on common Linux distros. If you do not have a system keychain, or cannot get a version of libdbus and libdbus-dev for your platform, you can build Git-Tool with --no-default-features to disable keychain support.
With keychain support disabled, the gt auth command will no longer be available and the create_remote feature will be disabled.
Windows
Linux (with Keychain)
Linux (without Keychain)
Mac OS
1
cargo install --git https://github.com/SierraSoftworks/git-tool.git
Copied!
1
# Install libdbus-1-3 and libdbus-1-dev
2
sudo apt update && sudo apt install -y libdbus-1-dev libdbus-1-3
3
cargo install --git https://github.com/SierraSoftworks/git-tool.git
Copied!
1
# If your platform doesn't support dbus or the Linux Keychain
2
# you can disable the auth feature
3
cargo install --git https://github.com/SierraSoftworks/git-tool.git --no-default-features
Copied!
1
cargo install --git https://github.com/SierraSoftworks/git-tool.git
Copied!

Setting up your PATH

Don't put your download folder on your $PATH - it's probably not a good idea from a security perspective. Instead, find a different directory to store git-tool in, I personally use a dedicated Programs folder which is used for exactly these kinds of tools.

Windows

To add or modify environment variables on Windows, you can press Win+Pause and then choose Advanced System SettingsEnvironment Variables. This will open the Environment Variables editor.
There are two changes you'll want to make:
    1.
    Find the Path environment variable and edit it, adding the directory you saved Git-Tool into as the bottom of this list.
    2.
    Add a new environment variable called GITTOOL_CONFIG and set it to %USERPROFILE%\git-tool.yml (or another location if you'd prefer).
When you're done, save your changes by clicking on Ok.

Linux

The easiest way to modify your PATH on Linux is to open up your ~/.profile file and add the following (fill in the path to the directory you placed git-tool into earlier):
1
# ~/.profile
2
3
export PATH="$PATH:$HOME/apps" # Add ~/apps to your path
4
export GITTOOL_CONFIG="$HOME/.config/git-tool.yml" # Set ~/.config/git-tool.yml as your config
Copied!

Mac OS

The easiest way to ensure that a program is on your path in Mac OS is to simply drag and drop it into your Applications folder. To setup the GITTOOL_CONFIG path, open up your .bash_profile file using vi ~/.bash_profile and add the following.
1
# ~/.bash_profile
2
3
# If you prefer to keep git-tool in a different folder, you can update your PATH
4
# export PATH="$PATH:$HOME/apps"
5
6
export GITTOOL_CONFIG="$HOME/Library/Preferences/git-tool.yml"
Copied!

Checkpoint #1

You should now be able to run git-tool --version and see something similar to the following appear in your terminal.
1
Git-Tool v2.2.0
Copied!
If you instead get an error saying that git-tool could not be found, that means that it is either not on your path or not marked as executable. First try restarting your terminal to make sure you've got the latest $PATH loaded and if that doesn't help, head on back to the Setting up your PATH section and check that you haven't missed anything.

Setup your Config

Now that you can run Git-Tool, the next step is to configure it. If you've followed the steps up to now, you will have a $GITTOOL_CONFIG environment variable set. That means we can quickly open up your favourite editor and start getting things configured.
Windows (PowerShell)
Windows (cmd)
Linux
Mac OS
1
notepad $env:GITTOOL_CONFIG
Copied!
1
notepad %GITTOOL_CONFIG%
Copied!
1
vi $GITTOOL_CONFIG
Copied!
1
vi $GITTOOL_CONFIG
Copied!
Drop in the following starter configuration and change the directory to point wherever you'd like to keep your repositories.
1
---
2
directory: "C:\\dev" # CHANGE ME
3
services:
4
- domain: github.com
5
website: "https://{{ .Service.Domain }}/{{ .Repo.FullName }}"
6
httpUrl: "https://{{ .Service.Domain }}/{{ .Repo.FullName }}.git"
7
gitUrl: "[email protected]{{ .Service.Domain }}:{{ .Repo.FullName }}.git"
8
default: true
9
pattern: "*/*"
10
apps:
11
- name: shell
12
command: powershell
13
14
features:
15
# Set this to false if you don't want to send crash information to us
16
telemetry: true
Copied!

Checkpoint #2

Now that you've got your config added, let's make sure that git-tool can find it. Run the following command and make sure that it prints out the same config you just saved.
1
git-tool config
Copied!
If the config doesn't look like the one you just added, that means Git-Tool couldn't find it. Make sure that you have configured the $GITTOOL_CONFIG environment variable to match the path to the file and that it is readable.

Setting up your Shell

The last step in setting up Git-Tool is to configure your shell to support autocompletion and add the gt alias.

PowerShell

To get the most out of Git-Tool (including adding the gt alias), you'll need to make changes to your PowerShell profile, which is run whenever you start a new command prompt.
In an existing PowerShell terminal, open your profile file for modification using notepad $PROFILE.CurrentUserAllHosts or vi $PROFILE.CurrentUserAllHosts and add the following to it:
1
# Open this file with:
2
# notepad $PROFILE.CurrentUserAllHosts
3
4
# This adds an alias for Git-Tool so you can simply type "gt"
5
New-Alias -Name gt -Value git-tool
6
7
# This sets up autocomplete support for git-tool and "gt"
8
Invoke-Expression (&git-tool shell-init powershell)
Copied!

bash

To get the most out of Git-Tool (including adding the gt alias), you'll need to make changes to your bash profile, which is run whenever you start a new terminal session.
1
# ~/.bashrc
2
3
alias gt="git-tool"
4
eval "$(git-tool shell-init bash)"
Copied!

zsh

To get the most out of Git-Tool (including adding the gt alias), you'll need to make changes to your zsh profile, which is run whenever you start a new terminal session.
1
# ~/.zshrc
2
alias gt="git-tool"
3
eval "$(git-tool shell-init zsh)"
Copied!

fish

To get the most out of Git-Tool (including adding the gt alias), you'll need to make changes to your fish config, which is run whenever you start a new terminal session.
1
# ~/config.fish
2
alias gt="git-tool"
3
complete -f -c git-tool -a "(git-tool complete)"
Copied!

Checkpoint #3

You should now be fully set up. Restart your terminal to load the newest version of your profile and try running gt --version, you should see something similar to this appear. If you do, Congratulations, you're all set up!
🚀
1
Git-Tool v2.2.0
Copied!
Last modified 20d ago