Skip to content

make cli help human first #44

Description

@meeech

onecli cli help is kinda unusable for a human

I think LLMs can easily read help text, can discover the command to get a json output if necessary.

a common pattern now is also to ship the cli with a skill that gives the hints an agent would need to use the cli effectively anyhow.

"should human be the default or json? and how would you want to flip between them?"

so: human default, since if i'm reaching for the cli, its probably to debug or investigate a problem.

re: flpping between them (@johnnyfish ) that i'm not sure about - i like your idea of detecting tty / env vars to make a good guess. but i do agree with --json flag would make sense (and again, easy enough for agent to discover/ know about) Otherwise, what did you mean by flipping?

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions