https://github.com/mbostock/gistup

Create a gist from terminal, then use git to update it.
https://github.com/mbostock/gistup

Last synced: 10 days ago
JSON representation

Create a gist from terminal, then use git to update it.

• Host: GitHub
• URL: https://github.com/mbostock/gistup
• Owner: mbostock
• License: other
• Archived: true
• Created: 2014-03-01T23:03:37.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2020-10-23T16:56:15.000Z (about 4 years ago)
• Last Synced: 2024-09-22T09:38:17.400Z (about 2 months ago)
• Language: JavaScript
• Size: 42 KB
• Stars: 490
• Watchers: 11
• Forks: 41
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-github-repos - mbostock/gistup - Create a gist from terminal, then use git to update it. (JavaScript)
• jimsghstars - mbostock/gistup - Create a gist from terminal, then use git to update it. (JavaScript)

README

        
# Gistup

Create a gist from the command line! Then just use git to update it.

For more, read the tutorial: [Let’s Make a Block](http://bost.ocks.org/mike/block/).

## Installation

```bash

npm install -g gistup

```

The first time you run gistup, you’ll be prompted to create a GitHub *personal access token*. You can revoke the token in the future from your GitHub [developer settings](https://github.com/settings/tokens).

## Usage

To upload all files in the current directory to your new gist:

```bash

gistup

```

If you just want to create a gist from a single file, try this instead:

```bash

gistup index.html

```

If you specify any options, such as a private gist, you must separate files from options with a double-dash (--) like this:

```bash

gistup --private -- index.html

```

If you want to update your gist later, just use git:

```bash

edit index.html

git commit -m 'Made some awesome changes.'

git push

```

Gistup works with binary files, too!

Arguments:

* --description, -m - provide an optional description

* --interactive, -i - request confirmation of every file before adding

* --exclude, -x - skip files matching pattern; may use wildcards

* --private, --no-public - make a secret gist

* --open [url] - specify the URL to open after creating the gist

* --no-open - don’t open the created gist in your web browser when done

* --remote - specify the name of the git remote

* --help - show some help

* --version - print the current version of gistup

Gistup comes bundled with two helper programs: `gistup-rename` and `gistup-open`. Use `gistup-rename "description of gist"` to update the description of the gist in the current directory and `gistup-open` to open it for viewing in your default browser.

## Troubleshooting

If you see the following error:

```

Error: Command failed: Permission denied (publickey).

fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists.

```

You probably need to [generate your SSH keys](https://help.github.com/articles/generating-ssh-keys) for GitHub. These keys give you permission to git push to your repositories, including Gists.

If you’re unable to follow the first-time setup to create a personal access token, you can [create a new access token](https://github.com/settings/tokens/new) by hand. The only required permission is "gist". You can then create a .gistup.json file in your home directory, with the following contents:

```json

{

  "token": "0123456789012345678901234567890123456789"

}

```

Replace the numbers 0123456789… with your access token and save.