A developer-focused entry in TopGit's GitHub warehouse: infinitered/gluegun, 3.1k stars, Developer Tools, TypeScript. A delightful toolkit for building TypeScript-powered command-line apps.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Gluegun is a delightful toolkit for building Node-based command-line interfaces (CLIs) in TypeScript or modern JavaScript, with support for:
🌯 parameters - command-line arguments and options
🎛 template - generating files from templates
🗄 patching - manipulating file contents
💾 filesystem - moving files and directories around
⚒ system - executing other command-line scripts
🎅 http - interacting with API servers
🛎 prompt - auto-complete prompts
💃 print - printing pretty colors and tables
👩✈️ semver - working with semantic versioning
🎻 strings - manipulating strings & template data
📦 packageManager - installing NPM packages with Yarn or NPM
In addition, gluegun supports expanding your CLI's ecosystem with a robust set of easy-to-write plugins and extensions.
Originally built by Infinite Red, a U.S.-based web and mobile development company.
Notice
Gluegun is at a stable point and we aren't planning on building new features for it, although the community continues to send in PRs and we release them if they are performance, stability, types, or other similar enhancements. Read the Community Supported section to learn more.
Why use Gluegun?
Introductory YouTube video by our CTO, Jamon Holmgren: https://www.youtube.com/watch?v=_KEqXfLOSQY
You might want to use Gluegun if:
You need to build a CLI app
You want to have powerful tools at your fingertips
And you don't want to give up flexibility at the same time
If so ... welcome!
Quick Start
Just run the gluegun CLI like this:
# spin up your new CLI
npx gluegun new movies
# choose TypeScript or Modern JavaScript
# now jump into the source
cd movies
# and link your new executable
yarn link
# and run it!
movies help
You should see your new CLI help. Open the folder in your favorite editor and start building your CLI!
Commands are simple objects that provide a name, optional aliases, and a function to run.
// in movie/src/commands/foo.js
module.exports = {
name: 'foo',
alias: 'f',
run: async function (toolbox) {
// gluegun provides all these features and more!
const { system, print, filesystem, strings } = toolbox
// ...and be the CLI you wish to see in the world
const awesome = strings.trim(await system.run('whoami'))
const moreAwesome = strings.kebabCase(`${awesome} and a keyboard`)
const contents = `🚨 Warning! ${moreAwesome} coming thru! 🚨`
const home = process.env['HOME']
filesystem.write(`${home}/realtalk.json`, { contents })
print.info(`${print.checkmark} Citius`)
print.warning(`${print.checkmark} Altius`)
print.success(`${print.checkmark} Fortius`)
},
}
See the toolbox api docs for more details on what you can do.
See the runtime docs for more details on building your own CLI and join us in the #gluegun channel of the Infinite Red Community Slack (community.infinite.red) to get friendly help!
Who Is Using This?
Ignite CLI - React Native CLI and starter kit
Solidarity - audits your system dependencies so you can develop in peace
Sara Vieira's Fiddly - Create beautiful and simple HTML pages from your Readme.md files - https://fiddly.netlify.com
Graph CLI - CLI for building and managing subgraphs that index data from Ethereum and IPFS - https://thegraph.com/explorer
Vts - Vanilla TypeScript library starter CLI tool
Additionally, the first versions of the AWS Amplify CLI (a CLI toolchain for simplifying serverless web and mobile development) used Gluegun. They've since integrated Gluegun's functionality into their CLI in a bespoke way, but you can still see Gluegun patterns in their CLI.
What's under the hood?
We've assembled an all-star cast of libraries to help you build your CLI.
⭐️ ejs for templating
⭐️ semver for version investigations
⭐️ fs-jetpack for the filesystem
⭐️ yargs-parser, enquirer, colors, ora and cli-table3 for the command line
⭐️ axios & apisauce for web & apis
⭐️ cosmiconfig for flexible configuration
⭐️ cross-spawn for running sub-commands
⭐️ execa for running more sub-commands
⭐️ node-which for finding executables
⭐️ pluralize for manipulating strings
Node.js 12.0+ is required.
Community CLIs and Plugins
Here are a few community CLIs based on Gluegun plus some plugins you can use. Is yours missing? Send a PR to add it!
Gluegun-Menu - A command menu for Gluegun-based CLIs
Gluegun CLI-Starter - A CLI Starter for your next Gluegun CLI project
Community Supported
While Gluegun is no longer actively developed by Infinite Red, it has built a community that cares deeply about it. Infinite Red won't be building new features ourselves for Gluegun, but we encourage the community to continue to send high quality pull requests. We will try to review and merge them in a timely manner.
If you're looking for alternatives, here's a list:
Rust CLI -- Rust is a rapidly growing community and hot language, and has the benefit of speed and not needing to rely on a local Node engine.
oclif - oclif is used by some large CLIs and is very actively maintained
commander and yeoman - commander and yeoman have been around a long time and have very large communities. Keep in mind that we built Gluegun to avoid Commander and Yeoman, so YMMV
vorpal - unfortunately looks like it isn't actively maintained
just make your own - you don't need a framework to make a Node CLI. Check out this article from Twilio
And of course, check out your favorite React Native Consultants, Infinite Red!.
No homepage URL was recorded for infinitered/gluegun in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How active is development on infinitered/gluegun?
The most recent commit recorded on infinitered/gluegun was 1.0 years ago, based on the GitHub push timestamp. The repository has 155 forks — one of the better signals of community interest.
How many stars does infinitered/gluegun have?
infinitered/gluegun has 3.1k GitHub stars — refresh the page for the live number, or check github.com/infinitered/gluegun. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is infinitered/gluegun open source?
Yes — infinitered/gluegun ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/infinitered/gluegun.
What else is in the Developer Tools space?
infinitered/gluegun is tracked by TopGit under the Developer Tools category, alongside 4 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What topics is infinitered/gluegun associated with?
GitHub's repository topics for infinitered/gluegun: "cli", "javascript", "nodejs", "toolkit". TopGit's editorial category is Developer Tools.
Where do I read more about infinitered/gluegun?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/infinitered/gluegun is the definitive source.
Read full README in the tab above.
Is gluegun worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of gluegun.