You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Brett Bender a075f8bba2
Merge branch 'master' of
4 months ago
.chglog docs: Update changelog template 4 months ago
.github Update issue templates 4 months ago
assets/img Added banner image 4 months ago
cmd feat: API authentication 4 months ago
.gitignore Update documentation generator 5 months ago feat: API authentication 4 months ago docs: Create code of conduct 4 months ago
LICENSE Initial Commit 5 months ago feat: API authentication 4 months ago Tell users they can get on 4 months ago
go.mod feat: API authentication 4 months ago
go.sum feat: API authentication 4 months ago
main.go Finally fix that stupid main.go 5 months ago


Quick Script Runner

Made with ❤️ by @GreatGodApollo

Quick Script Runner (qsr) is a command line utility program that allows users to run code from github gists quickly with just a single command


Standard Download

Just head on over to the releases page and download the latest release for your platform. Extract it using something like 7-Zip for Windows or tar on other platforms (tar -zxvf qsr*.tar.gz).

That's it! Although you'll probably want to also add the binary to your path for ease of use.


Do you happen to have scoop installed? Well lucky for you, I happen to have a scoop bucket. Said bucket's name is Trough.

$ scoop bucket add trough
$ scoop install qsr

Go Get

Do you have go installed? You can run just one simple command to install QSR!

$ go get -u


$ qsr --help
  Quick Script Runner is a command line utility that allows you to run gists
  with a single command.
    qsr [command]
  Available Commands:
    docs        Documentation Generator
    help        Help about any command
    link        Link a gist or file alias
    run         Run a remote gist
    source      Get a link to the source code
    unlink      Remove a gist or file alias
        --config string   config file (default is $HOME/.qsr.json)
    -h, --help            help for qsr
        --version         version for qsr
  Use "qsr [command] --help" for more information about a command.


These values can be set in ~/.qsr.json. The options listed are unable to be used as alias names.

Configuration options available:

token - Personal OAuth token for Github

A personal OAuth token can be generated on your tokens page. This allows for the 60 requests per hour limit to be surpassed.

This token does not need any special scopes.

Included Gists

To prevent overcrowding this README, the included gist aliases are located in

Supported Languages

  • Batch (Windows Only)
  • Golang
  • JavaScript
  • Python 2 & 3 (Set with shebang ie. #!/usr/bin/python3)
  • Ruby
  • Shell

This list can be expanded on, either create an issue, or a PR to request a new language!

Built With


To compile the executable from the source, it's extremely easy, and can be done in as little as 3 commands.

You can follow these instructions to build:

# This assumes you already have git and golang installed.

$ git clone

$ cd qsr

$ go build


This project is licensed under the GNU Affero General Public License v3.0