A template for beautiful, modern, cross-platform compatible CLI tools written with Go!
|This template features|
|Build on top of cobra
|Easy installation for your users (one command)
|Automatic Website/Docs Generation
You can find an in-depth tutorial in the Wiki here: Getting Started
- Click on Use this template on the top of the page.
- Enable GitHub Pages and set the path to
- Create a personal access token (with repo scope) and add it as a repository secret (name:
- Clone and open your repository to change the description of your CLI in
- After you have set up your programm you have to create the very first release manually (
v0.0.1), to initialize the CI-System. (Don’t worry if your CLI tool doesn’t do anything yet. It’s common that the
v0.0.1release is just the plain project setup)
- The setup is done and you can start to code!
This template uses PTerm to provide colorful, cross-platform compatible output by default!
By using PTerm, you can output progressbars, colored text, charts and many more.
Build on top of cobra
Cobra is a popular CLI framework for Go.
Our custom made CI system will detect when you change the version of your CLI and will automatically create a new GitHub release for you. You’ll never have to deploy your CLI tools manually again!
The automatic releases contain binaries, for the most common operating systems.
This binaries can be installed using instl.sh.
This means that your users, can install your CLI Tool with a single command!
The command will automatically be put into your README.md, after you click Use this template.
The commands will look like below, depending on the OS, your user has.
iwr instl.sh/username/reponame/windows | iex
curl -sSL instl.sh/username/reponame/macos | sudo bash
curl -sSL instl.sh/username/reponame/linux | sudo bash
Automatic Website Generation
Every time you push a new commit, a GitHub Pages website is created/updated, which documents your whole CLI tool automatically. You don’t need to document anything by yourself.
You only need to enable GitHub Pages by going to your repository settings (set the path to
This template uses Goreleaser to build binaries of GitHub releases, for the most common operating systems.
Since we feature Automatic Releases, your whole deployment process is automated, when you increase the version of your CLI tool.
Your users will be notified if a new version of your tool is availble.
We wrote a custom CI-System, which will be included in your repository.
It sets up the template, creates/updates the website, writes docs for you and run your tests. (And much more!)
We use libraries, which were specially made for this template, to give you the best user experience without a ton of code.