Build CLIs for people, scripts and AI agents

Mutating commands take --dry-run and print the change they would make, with secrets masked.

$ ./hello widget create gamma --dry-run
DRY RUN: would POST /widgets
  body:
    name = gamma
    token = ***
  no changes were made

A command renders its result for people or as stable --json for programs. Both forms come from the same value.

$ ./hello widget list
ID  Name
1   alpha
2   beta
$ ./hello widget list --json
[
  {
    "id": "1",
    "name": "alpha"
  },
...

Scripts and agents branch on the exit code instead of parsing text. Destructive commands refuse to act without confirmation.

$ ./hello widget delete alpha --no-prompt
Error: destructive action requires --confirm
exit code 1
$ ./hello widget delete alpha --confirm
Deleted widget alpha
exit code 0