finds.dev

f/omelette

Omelette is a simple, template based autocompletion tool for Node and Deno projects with super easy API. (For Bash, Zsh and Fish)

View on GitHub

★ 1,405CoffeeScriptMITupdated Jan 2022

// the take

Omelette is a small CLI library for generating Bash/Zsh/Fish autocompletion from a template-literal or tree-based spec, for Node and Deno programs. It's aimed at CLI tool authors who want tab-completion without hand-writing shell completion scripts.

The template-literal API is genuinely nice ergonomics — defining completion fragments inline next to the command structure beats most completion libraries' separate-config-file approach. It supports both sync and async reply handlers, a tree-based alternative for deeply nested commands, and ships Deno support alongside Node via a parallel .ts file. It's also battle-tested: office365-cli and appcenter-cli used it in production.

No push since January 2022 and only 40 forks against 1405 stars, so bug fixes or new shell support aren't coming. Source is CoffeeScript compiled to JS, which raises the bar for anyone wanting to actually read or patch src/omelette.js rather than just consume the npm package. setupShellInitFile() auto-appends to the user's .bashrc/.zshrc/config.fish, which is convenient but a surprising thing for a library to do without an obvious dry-run or diff step. CI is Travis, which is effectively dead, so there's no working signal that the test suite (if any) still passes.

We read the README, the directory tree and a key source file in October 2026. Nobody pays to be listed. How we judge →

search the same ground:

// at a glance

Stars
1,405
Forks
40
Language
CoffeeScript
License
MIT
Last commit
21 Jan 2022

// nearby

If omelette isn't quite it.

All repos →