Regardless of what the app does and whether the thing that does is particularly useful, powerful or important for what you need to do (or even well implemented), what is a command-line interface that you had a particularly good experience both learning and working with?
In other words, I’m thinking about command line interface design patterns that tend to correlate with good user experience.
“Good user experience” being vague, what I mean is, including (but not limited to)
- discoverability–learning what features are available),
- usability–those features actually being useful,
- and expressiveness–being able to do more with less words without losing clarity,
but if there’s a CLI that has none of those but you still like it, I’d be happy to hear about it.
Edit: Trying to stress more that this post is not about the functionality behind the tool. Looks like most of first responders missed the nuance: whether app x is better than app y because it does x1 ad x2 differently or better does not matter; I’m purely interested in how the command line interface is designed (short/long flags, sub-commands, verbs, nouns, output behaviors)…
I like CLI tools that everything I need can be found in a short
command --helpcall, if I don’t need to useman commandit’s even better.I’ve used poor CLI tools for example
adbyou type this and you get almost a scientific article with more than 100 flags to use. No I don’t want to need to usegrep.A good one would be
pacmanit separates clearly what it does instead of shoving it all in a single command.This is where a man page comes in but alas, but some (perhaps even most) of them are fucking horrible. The core incantation is either too dumbed-down or (more often) too long-winded.
Some good ones I can praise are netcat, ghostscript and 7z. Special praise goes to the Library Funtions Manual entries like signal and exit.
Bad ones ones in my book are vim (too short), ffmpeg (a simple reordering of sections would make it quite a bit better, like moving the less common flags lower down the page) and git starts of strong but ends up being way too detailed and unstructured.
I could go listing examples for days, so I might as well stop now.
Honestly, incus.
I know it’s not strictly a utility, but holy cow, Stephane Graber and his team have put the work into that product, such that anything you can do in the ui can be done in the CLI, and more.
Tab completion entries for all the resource types (storage, instances, image repos, etc), help entries for everything, it brings a tear to the eye.
I once thought it was cool to have standardised man entries, but even better is context-sensitive
--helpentries that work well. Almost all the discovery I’ve made using incus, I’ve made using the commands themselves.It’s a real testament to how putting in the documentation work might be tedious, but it is a boon to both users and devs.
I always thought openSUSE’s package manager
zypperhas quite a few neat ideas:- It offers two-letter shorthands for subcommands, so
zypper install→zypper in,update→up,remove→rm. - When it lists what packages it will install or remove, it will list them with the first letter highlighted in a different color, kind of like so:
fishgittexlive
This makes it really easy to visually scan the package list, and since it’s sorted alphabetically, it also makes it easier to find a particular package you might be looking for.
And while there’s separate lists for packages to be added vs. updated vs. removed, they also color those letters in green vs. yellow vs. red, so you can immediately see what’s what. - When it lists items (other than packages), it prints an ID number, too.
So,zypper reposgives you a list of your repositories, numberered 1, 2, 3 etc., and then if you want to remove a repo, you can runzypper removerepo 3. - When you run a
zypper search, it prints the results in a nicely formatted table.
Documentation: https://doc.opensuse.org/documentation/tumbleweed/zypper/
- It offers two-letter shorthands for subcommands, so
man
man man

vlc --helpoutputs text with colors which makes it so much easier to skimI like the trend of refining existing tools. You take tried-and-true commands and shave off the rough edges and quirks. I use
ripgrepinstead ofgrep,fdinstead offind,scm_breezeon top ofgit,dustinstead ofdu,dufinstead ofdf,zovercd, andxhinstead ofcurlCurl
Btop, beautiful and functional.
Pure cli or also TUI? When it comes to TUI probably yazi is my most used tool right now, use it pretty much every day. For pure cli i would probably give my vote to sed. I use the crap out of it in a bunch of scripts. For example i switch my themes with it by replacing whatever import i had in the config to the desired theme, then reload the programs.
docker’s cli makes a lot of sense to me. Anything that supports “application logical-command --help” gets a big tick.
But yeah, bash itself is great.
findandrename/perl-rename/prename(depending on your distro), are two of my favorite cli tools. I generally find both well designed and easy to use. For me, they are indispensable.I think
findUI is so bad every time I use it I think about hacking a script just to make it simpler for my use case. At the same time I am very reluctant to use one of this new versions of standard commands trying to reinvent the wheel.Some things I don’t link about
find:-
How the directory needs to be the first argument. I get the reasoning but it is such a pain, specially if you are using it with the same query repeatedly in different paths.
-
The parenthesis to set order of matches, you are doing it in the shell so you have to escape them which is never fun.
-
The fact that
-namedoes not match partial names and there is not a version that do so you have to keep doing stuff like-name "*foo*"and of course you have to escape that shit or risk you shell expanding it. Having the GLOB version is nice but there could have a more ergonomic way to do this type, which I assume is a very common use case. -
Actually, doing more complex logical matches is always a pain and it would be nice to have a easier way to do some common operations.
-
The fact that when you do some complex match then the
-printis not automatic anymore or the the behaviour is kinda weird. And is a pain to add it in all logical branches or do it in a way that you do not repeat a lot.
Anyway, sorry for the rant.
Hahaha. No apology needed. And honestly, all fair points.
-
Fossil.
does ncurses stuff count or is TUI cheating?
All CLI commands
No-one mentioned ‘jq’ yet.
Maybe there’s a reason for that!





