Newshot Original text(via HN AI)
clingon
Stop googling commands. Pick one, fill in the blanks, run it. Or let an AI do it.
brew install con-dog/tap/clingon
clingon
Needs macOS, with zsh or bash. Opens in its own window in Terminal or iTerm2 (Ghostty, kitty and Alacritty untested).
- An AI drives it for you. Give it a task and watch it use the menu as you would.
- It's your real shell. Your config, aliases and environment. clingon only types the command in.
- It checks before risky commands. ⚠ commands ask No/Yes. ☠ commands can't be undone, so you type a short code first.
- Commands are just Markdown. A pack is a folder of .md files that reads as docs on GitHub and runs in clingon. How packs work →
- Chain commands into recipes. Press 1–9 to line commands up, then run them in order. It stops if one fails. How recipes work →
20 packs built in, from git and docker to aws and postgres.
Why clingon?
| clingon | navi | tldr | fzf | |
|---|---|---|---|---|
| Finds commands you've never run | ✓ | ✓ | ✓ | – |
| Fills in the blanks for you | ✓ | ✓ | – | – |
| Runs it in your shell | ✓ | ✓ | – | ✓ |
| Runs plain Markdown | ✓ | – | – | – |
| Asks before risky commands | ✓ | – | – | – |
| Chains commands into recipes | ✓ | – | – | – |
| Has an AI that does it for you | ✓ | – | – | – |
| Works in any terminal | – | ✓ | ✓ | ✓ |
| Runs on Linux | – | ✓ | ✓ | ✓ |
Good to know
- It never changes your setup. clingon reads your shell config and never writes to it.
- What it adds: a font, and a "clingon" profile in Terminal or iTerm2. macOS may ask once to let clingon control those apps, only to open and style the window.
- Separate history. Unless your config sets HISTFILE, zsh inside clingon keeps its own history.
- Its files are in ~/.clingon: your packs and recipes, and its own files in config. Set $CLINGON_CONFIG to move it.
- Something wrong? Clingon › General in the menu checks your setup, shows the last crash and updates clingon.
- Zero telemetry. clingon collects nothing. It goes online only to check for a new release, once a day.
- The AI needs an OpenRouter key (add it under Clingon › AI, or set $OPENROUTER_API_KEY) and runs only when you give it a task. The task, the menu and the shell's screen then go to OpenRouter and the model's maker.
Removing clingon
brew uninstall clingon
rm -rf ~/.clingon
rm -f ~/Library/Fonts/ClingonMono-*.otf
rm -f ~/Library/Application\ Support/iTerm2/DynamicProfiles/clingon.json # iTerm2
rm -rf ~/Library/Caches/clingon # Terminal
If you use Terminal, also delete any profiles named "clingon" in Settings › Profiles.
Hacking on clingon
go build -o clingon ./cmd/clingon && ./clingon
go test ./...