Getting Started
A quick guide to getting started with Git-Tool
Welcome to Git-Tool, we hope you'll find it to be an awesome addition to your toolkit and that it'll bring you plenty of smiles. There are a few things you'll need to do to get yourself set up and working and these are covered in each of the Getting Started guides you'll find here.
This guide is the high-level run-through for anyone familiar with setting up Git-Tool or who likes guessing their way to a conclusion. If you run into trouble or want something more detailed, use the links in each Step.

Step #1: Installation

You can download the latest version of Git-Tool from our GitHub releases page. Pop it into your $PATH, setup a config file, configure your shell and you're good to go!
PowerShell
bash
zsh
1
# $PROFILE.CurrentUserAllHosts
2
3
$env:GITTOOL_CONFIG="${env:HOME}/git-tool.yml"
4
5
# This adds an alias for Git-Tool so you can simply type "gt"
6
New-Alias -Name gt -Value git-tool
7
8
# This sets up autocomplete support for git-tool and "gt"
9
Invoke-Expression (&git-tool shell-init powershell)
Copied!
1
# ~/.bashrc
2
3
export GITTOOL_CONFIG="$HOME/.config/git-tool.yml"
4
5
alias gt="git-tool"
6
eval "$(git-tool shell-init bash)"
Copied!
1
# ~/.zshrc
2
3
export GITTOOL_CONFIG="$HOME/Library/Preferences/git-tool.yml"
4
5
alias gt="git-tool"
6
eval "$(git-tool shell-init zsh)"
Copied!

Step #2: Configuration

Setup your $GITTOOL_CONFIG file with the repository hosting services and apps you want to use, point it at your development directory and Git-Tool will do the rest.
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: pwsh # CHANGE ME
13
14
features:
15
# Set this to false if you don't want to send crash information to us
16
telemetry: true
Copied!

Step #3: Linking to GitHub

Git-Tool
💕
GitHub and can automatically create repositories there whenever you run gt new.
To set this up, generate a new Personal Access Token with the repo scope and run the following command to store it in your local keychain.
1
gt auth github.com
Copied!

Bonus Step: Updating Git-Tool

We update Git-Tool regularly to patch bugs, add features and ensure that any potential security vulnerabilities in Git-Tool or its dependencies are closed as quickly as possible.
You'll find our list of releases on GitHub and can subscribe there for notifications, but the quickest way to update is to run gt update.
Due to the way Git-Tool runs and updates itself, you'll need to make sure that you close down any shells it has launched before running gt update.
Last modified 20d ago