Use Buzzmark from a terminal
The Buzzmark CLI runs every Buzzmark tool as a command, npx buzzmark followed by the tool's name, for AI agents that work in a terminal and for scripts.
It signs in with an API key from Settings, under Developers, read from BUZZMARK_API_KEY, and answers JSON.
It can write, check, plan and schedule a Buzz in your Hive voice, but it can't post right away.
What it's for
An AI agent in a shell, such as Claude Code, Codex or OpenClaw, can run a command without adding an MCP server, and so can a cron job, a CI step or n8n's command node. The CLI runs the same tools as a connected AI app, with the same rules: each platform's limits, Buzz's writing rules and your plan's monthly amounts.
From your own code over HTTP, use the REST API; from a chat, connect an AI app.
Install
There's nothing to install: npx buzzmark fetches the CLI on first run, on Node.js 22 or later. To keep it on the machine, run npm install -g buzzmark once, then buzzmark without npx.
Sign in with a key
Terminal
1. Make a personal key in Buzzmark, in Settings under Developers.
2. Put it in BUZZMARK_API_KEY where your agent or script runs, the way you keep other secrets. The CLI reads it from there, never from a flag.
3. Run the commands below with Node.js 22 or later. Each one answers JSON, and buzzmark tools lists the rest.
Keep the key in your agent's secret store, a .env file your script loads, or your shell profile. The CLI has no flag for the key: anything on a command line can be read by other programs on the machine. A key works as you until it expires or you revoke it, and the same key works with the REST API and in AI apps without sign-in. Sign-in, keys and limits covers making, limiting and revoking it.
Run your first command
Terminal
npx buzzmark list-social-sets
The answer is your social sets as JSON, each with its accounts, brand profile, clock and posting slots. Most other commands take a set or account id from here. Commands and flags covers the rest.
Where to next
- Commands and flags
Each Buzzmark tool is a command: `buzzmark schedule-post` runs the schedule_post tool, and `buzzmark tools` lists them all.
- Pictures and video
`buzzmark upload <file>` adds a picture or video from the machine the CLI runs on to your Library, and to a draft when you name one with --post-id.
- 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.
- Sign-in, keys and limits
An AI app signs in on a Buzzmark page in your browser, where you press Allow, and works as you until you disconnect it.