Automate the CLI - Almanac

Automation should make authentication and Organization scope explicit:

export ALMANAC_TOKEN="waka_..."
export ALMANAC_ORGANIZATION="acme"

Request JSON

almanac search "customer onboarding" --json

--json writes one JSON value to standard output and suppresses the human scope banner. The JSON includes the resolved Organization where relevant.

Keep upload receipts

The CLI returns an upload ID and processing status:

almanac upload docs/ --json

Retain that receipt for diagnostics. Processing continues after the command returns; use sources and search as the public read-side verification surfaces.

Exit behavior

Exit code	Meaning
`0`	Command completed successfully
`1`	Almanac reported an error
`2`	Command syntax or arguments were invalid
`130`	Command was interrupted

Run almanac COMMAND --help for command-specific flags. See CLI reference for the command map and configuration for automation credentials.