Get unlimited public & private packages + team-based management with npm Teams.Learn more »


0.1.2 • Public • Published


GrappleHound is a CLI that will create, list, pull, push, and locally purge gists from your working directory. It supports sub-folders and works with your personal (public and private) gists only.

... but ... why!!?!?!?!?!?!?!?!??!?

Think of it as a quick way to create and consume scaffolding/skeletons for new projects. It's a toy that I built for me, partly for funsies and partly because I loath copying different sets of files around between project folders with a series of cp commands. (This is where you enjoy laughter at my expense)


npm install grapplehound -g


Ask for help help

gh --help

If you can't remember the commands, just type gh and pick what you want... menu


GrappleHound is hand-holdy. You should be able to get what you need from the interactive prompts. As much as I love typing, I'm not going to hand-write all the menu systems for something that I may only ever use.

Stuff You Should Know

API Tokens & Auth

The first time you use GrappleHound, it will prompt you for your username and password. I do not save this anywhere nor do I send it to any endpoint other than GitHub's. Please see my dependencies for how this is handled. It's worth checking the source code for how this all happens just so you can feel relatively safe about how your credentials are handled.

GrappleHound will create an API token in your GitHub account. Once created, it will store this token in ~/.grapplehound.json. This process supports two-factor authentication. If it's gross to you to have a token stored on your hard-drive DO NOT USE GRAPPLEHOUND.

If you should delete/lose the ~/.grapplehound.json file, not to worry, instead of getting a new token, GrappleHound will just find and use the existing token (assuming you didn't delete it from GitHub) it created previously.

Local Settings

GrappleHound keeps a local ./.grapplehound.json file in any directory where you're using it. This is how it knows which gists you've pulled down, what files belonged to those gists and things like that. It's good to know its there so you can add it to your .gitignore and .npmignore files OR even decide that this is yet another reason you hate it and shouldn't use it.


GrappleHound has no unit tests. It is a tortued, frankenstinian beast cobbled together during a late-night, caffeine-fueled, weekend, hack-session from Mike de Boer's fantastic GitHub API client for Node, Inquirer and Commander (and other nice libraries).


With certain features, like pull and purge, you can and probably will destroy/overwrite local files when that's the last thing you had intended. Be extremely careful with these two commands. You'll want to be certain you're using pull/purge in directories where you've recently committed or have back-ups somewhere.

Contributing (lol)

If you find this thing and think, "If only it ...", please send a PR. It's a bit of a mess but it's also not that complicated and adding features should be relatively straight-forward.



npm i grapplehound

DownloadsWeekly Downloads





MIT License

Last publish


  • avatar