Skip to the page

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. 1. Make a personal key in Buzzmark, in Settings under Developers.

  2. 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. 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