Git-Tool has a ton of useful commands, but you can probably get away with knowing only three of them. Let's run through
gt new and
gt scratch and show you how they work!
Opening a Repo
So, you've just got Git-Tool installed and want to kick the tyres. The best place to start is the same place you usually do, cloning a repo and opening it up.
gt o gh:SierraSoftworks/git-tool
This will automatically clone the repo if it doesn't already exist on your machine and then open the first application in your config file.
You can also launch a specific application if you'd prefer.
gt o code gh:SierraSoftworks/git-tool
Take a look at Git-Tool's config registry for a quick way to add applications to your config.
Creating a new Repo
Okay, opening a repo is pretty easy - but how about creating a new one? Well, Git-Tool takes care of all of that for you too. Let's try creating a quick test repo to play around in.
gt n --no-create-remote gh:YOURUSER/git-tool-example1
If you'd like to open up the repo you just created (usually we do) you can either pass the
-o command line option, or you can set the
open_new_repo_in_default_app feature flag.
# Tell Git-Tool to automatically open all new repos in your default app gt config feature open_new_repo_in_default_app true # Or pass the -o option explicitly gt n -o --no-create-remote gh:YOURUSER/git-tool-example2
We're using the
--no-create-remote option here to prevent Git-Tool from automatically setting up a GitHub repo, but you can leave that out when creating real repositories. You can also permanently disable this feature by disabling the
create_remote feature flag.
We just saw a great example of wanting to play around with something but not really wanting to create repositories for it. That tends to happen quite a lot and Git-Tool has just the command to help make it easier. Meet Scratchpads, the organized, weekly, folder where you can do exactly that.
To open the current week's scratchpad, just run the following.
# Open the current week's scratchpad gt s # Open a different week's scratchpad gt s 2021w10
As with the
gt open command,
gt scratch lets you open the scratchpad in a specific application if you would prefer.
gt s shell
Of course, this is just the tip of the iceberg, take a look at the commands reference to get an idea of everything Git-Tool can do.