gist

README

gist

Installation

go get kkn.fi/cmd/gist

Usage

% gist -h
usage: gist [-v] [-d string] [-p] [-a] file ... | -f file
  -a	create anonymous Gist
  -d string
    	description for Gist
  -f string
    	file name of the Gist. Reads file contents from stdin
  -p	create a public Gist
  -token file
    	read GitHub personal access token from file (default $HOME/.github-gist-token)
  -v	print version and exit

Dependencies

• Google GitHub
• oauth2

License

BSD-3-Clause. See LICENSE for details.

Documentation

Overview

Gist is a client for creating GitHub Gists.

usage: gist [-v] [-p] [-a] [-d string] file ... | -f file

Gist uploads local file[s] to gist.github.com and prints information about the created Gist. Default user is the authenticated user.

Authentication

Gist expects to find a GitHub "personal access token" in $HOME/.github-gist-token and will that token to authenticate to Github when writing Gist data. A token can be created by visiting https://github.com/settings/tokens/new. The token only needs the 'gist' scope checkbox. It does not need any other permissions. The -token flag specifies an alternate file from which to read the token.