NAME

gist - Gist command-line tool

SYNOPSIS

gist [OPTIONS] FILE

Create a new gist from a file

$ gist script.pl

Create a new gist from a pipe with a description

$ cat script.pl | gist -d 'some script' -n script.pl

Create a new gist and copy the web URL in the clipboard

$ echo "something" | gist -w | xclip
$ echo "something" | gist -w | pbcopy # on Mac OS X

OPTIONS

--description, -d DESCRIPTION: Set the description for the gist.
--name, -n NAME: Specify the name of the file (useful when using a pipe).
--update, -u GIST_ID: Update the given gist (identified by GIST_ID), with the given file.
--private, -p: Create a private gist.
--web, -w: Only output the web url.

CONFIGURATION

Configure git with your GitHub credentials:

$ git config --global github.user LoginName
$ git config --global github.password GitHubPassword

Alternatively you can install Config::Identity and write your credentials in the (optionally GPG-encrypted) ~/.github file as follows:

login LoginName
password GitHubpassword

(if only the login name is set, the password will be asked interactively)

AUTHOR

Alessandro Ghedini <alexbio@cpan.org>

LICENSE AND COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.