Discoverabilty is the point. That’s what a GUI excels at. The focus of the terminal is “expressiveness” (I think that’s the commonly used word). It is usually clear when you need one vs the other: bulk or compound tasks, repetitive tasks, or very particular tasks are where the terminal excels.

It sounds like you might benefit from man or tldr as a sidenote. Most people know man, but tldr is also a nice to have.