Gist: The Script

Works great with Gist: The Website.

Installation

$ brew install gist
$ gist -h

RubyGems:

$ gem install gist
$ gist -h

Old school:

$ curl -s https://raw.github.com/defunkt/gist/master/gist > gist &&
$ chmod 755 gist &&
$ mv gist /usr/local/bin/gist

Ubuntu:

$ sudo apt-get install ruby
$ sudo apt-get install rubygems
$ sudo apt-get install libopenssl-ruby
$ sudo gem install gist
$ sudo cp /var/lib/gems/1.8/bin/gist /usr/local/bin/
$ gist -h

Use

$ gist < file.txt
$ echo secret | gist --private # or -p
$ echo "puts :hi" | gist -t rb
$ gist script.py
$ gist script.js notes.txt
$ pbpaste | gist -p # Copy from clipboard - OSX Only
$ gist -
the quick brown fox jumps over the lazy dog
^D

Authentication

There are three ways to set GitHub authentication info:

Generating an oauth token for gist access:

Set your github username either in an environment variable or the git config:

$ GITHUB_USER="your-github-username"
$ # (or)
$ git config --global github.user "your-github-username"

Generate an oauth token that can write gists:

$ curl -s -u${GITHUB_USER:-$(git config --global github.user)} -d '{ "scopes": [ "gist" ], "note": "gist cli" }' https://api.github.com/authorizations | grep '"token"' | cut -d\" -f4
Enter host password for user 'your-github-username':
9ba165eb3147168e9e56bdc1c997c8d0fd4fe25c

Set that token in your git config:

$ git config --global github.gist-oauth-token 9ba165eb3147168e9e56bdc1c997c8d0fd4fe25c

Using env vars GITHUB_USER and GITHUB_PASSWORD:

$ export GITHUB_USER="your-github-username"
$ export GITHUB_PASSWORD="your-github-password"
$ gist ~/example

Using git config options github.user and github.password

git config --global github.user "your-github-username"
git config --global github.password "your-github-password"

You can also define github.password to be a command which returns the actual password on stdout by setting the variable to a command string prefixed with !. For example, the following command fetches the password from an item named "github.password" on the Mac OS Keychain:

password = !security 2>&1 >/dev/null find-generic-password -gs github.password | ruby -e 'print $1 if STDIN.gets =~ /^password: \\\"(.*)\\\"$/'

Defaults

You can set a few options in your git config (using git-config(1)) to control the default behavior of gist(1).

gist.private - boolean (yes or no) - Determines whether to make a gist private by default
gist.extension - string - Default extension for gists you create.
gist.browse - boolean (yes or no) - Whether to open the gist in your browser after creation. Default: yes

Proxies

Set the HTTP_PROXY env variable to use a proxy.

$ HTTP_PROXY=host:port gist file.rb

Manual

Visit http://defunkt.github.com/gist/ or use:

$ gist -m

Bugs

https://github.com/defunkt/gist/issues

ziz / gist