Simple program for uploading files to Gist of GitHub
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


gCLIst is a simple Gist uploader. It's designed only for create a Gist and upload file(s). It is not for maintaining furthermore. If you need to edit the files, then you should use Git to clone the Gist, instead.


usage: [-h] [-a] [-d DESCRIPTION] [-p] [-c SECTION]
                 [FILE [FILE ...]]

Upload files to Gist.

positional arguments:
  FILE                  File to upload (default: None)

optional arguments:
  -h, --help            show this help message and exit
  -a, --anonymous       Upload anonymously (default: False)
                        Description for Gist (default: None)
  -p, --private         Set Gist to private (default: False)
  -c SECTION, --config SECTION
                        Which INI section to use (default: default)


gCLIst looks for gclistrc in current directory or ~/$XDG_CONFIG_DIR/gclist/config for configuration. Currently, it's only used for username and password. A sample configuration file looks like:

username = your_username
password = your_password

username = other_username
password = other_password

[default] is the default account. You can use -c other to use [other] in the case above.


$ ./ file1 file2

$ ./ -

$ ./ file1 - < file2

$ cat file1 | ./ file2

If you use pipe or redirection, you will be asked for a filename.

Output Example

$ ./ *
Uploading... done

Gist 1179959 was created at

User       : livibetter
Public     : True
Description: None

    <script src=""> </script>
    <script src=""></script>
    <script src=""></script>


Although I intend to make gCLIst only for uploading once, then editing using Git. But if you want to make it a super CLI command, feel free to add pull requests. I would be glad to include your enhancements.