# I let an LLM use my TUI like a user. It found multiple UX bugs

> Source: <https://github.com/con-dog/clingon>
> Published: 2026-11-13 06:05:02+00:00

**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 →](https://github.com/con-dog/clingon/blob/master/docs/packs.md)
- **Chain commands into recipes.** Press`1` –`9` to line commands up, then run them in order. It stops if one fails.[How recipes work →](https://github.com/con-dog/clingon/blob/master/docs/recipes.md)

**20 packs built in**, from `git` and `docker` to `aws` and `postgres`.

|  | 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 | – | ✓ | ✓ | ✓ | 

- **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.

```
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.

```
go build -o clingon ./cmd/clingon && ./clingon
go test ./...
```

MIT