Skip to the page

Answers and exit codes

The Buzzmark CLI answers JSON on stdout. An error is JSON on stderr with a code and a message, and the exit code says what kind, so a script or an agent can branch on it.

Calls from the CLI count toward the same limits as your AI apps, and writing and pictures use your plan's monthly amounts.

Read the answer

A command that worked prints the tool's answer as JSON on stdout, the same answer an AI app gets. An error prints {"error": {"code": …, "message": …}} on stderr. The message gives the reason and what to do, such as a platform's limit or a quota that ran out.

Help is the one thing printed as plain text: buzzmark --help and buzzmark help <tool>.

Exit codes

Exit codeWhat happened
0Done.
1The tool said no, with the reason: a platform would refuse the post, or a monthly amount ran out.
2The command was wrong: an unknown tool, a bad flag or a missing input.
3No key, or a key Buzzmark didn't accept. Make a new one in Settings, under Developers.
4Too many calls for now. Wait, then try again.
5Buzzmark couldn't be reached, or answered something unexpected.

Retry on 4 after a wait, and on 5 once Buzzmark can be reached. On 1, read the message: the same command won't work until something changes.

Limits

Calls from the CLI count toward the same limits as your AI apps, across every app and key, and writing, pictures, Hive checks and Scout runs use your plan's monthly amounts, as in the app. Sign-in, keys and limits has the numbers.

BUZZMARK_MCP_URL points the CLI at another Buzzmark address, which you only need when we ask you to.

Where to next