NAME

gist - Gist command-line tool

VERSION

version 0.16

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

Copyright 2011 Alessandro Ghedini.

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.

See http://dev.perl.org/licenses/ for more information.