Suggestion: --libsq as discoverability feature
I appreciate your efforts to improve the documentation. Along this line, an an aspect that I've heard some folks struggling with, is discoverability. I'd like to bring up a suggestions for this:
--libsq flag for the
sq command line tool.
This is a feature found in curl, which outputs a piece of code that performs exactly the operation done by the given command line. For high-level workflows, it's often much easier to do them on the command line than in code, a shortcut from there to working code is amazingly useful for discoverability. Perhaps equally important, it helps you notice when
sq something turns into a way too large or way too magical piece of code.
I realize this is not a simple feature, and I admit I haven't thought much about practicalities of an implementation. Perhaps it's too complicated to do. But boy, would this be a killer feature.