Beeive CLI

The beeive CLI schedules posts, uploads media and reads analytics from your terminal. It suits scripts, cron jobs, CI pipelines and AI coding agents.

Install

You need Node.js 18 or newer.

npm install -g beeive

Check that it works:

beeive --version

Authenticate

CLI access is included on every paid Beeive plan. There are two ways to sign in.

Log in with your browser (recommended)

Best on your own computer. You never copy a key.

beeive auth:login

1. The terminal shows a short code and a link.

2. Open the link in any browser, even on your phone, and enter the code.

3. Log in to Beeive and click Approve on Beeive CLI.

4. The terminal confirms you’re logged in. The login is saved on this computer, so every command works from now on.

The CLI uses whichever Beeive account is logged in to that browser. To use a different account, log in to beeive.com as that account first, or use a private window.

Command	What it does
beeive auth:status	Shows which account the CLI is using.
beeive auth:logout	Removes the saved login from this computer.

To revoke access from a lost or shared computer, go to Settings → Approved Apps on beeive.com.

Use an API key (for scripts and CI)

Best for servers, scripts and CI pipelines, where nobody is around to click Approve. Your API key is under Settings → Developers → Access in the app. Set it as the BEEIVE_API_KEY environment variable:

Note

If you’ve also run beeive auth:login on this computer, the saved login is used instead of the key. Run beeive auth:logout to switch to the key.

macOS / Linux

export BEEIVE_API_KEY="YOUR_API_KEY"

To keep it across terminal sessions, add that line to ~/.bashrc or ~/.zshrc.

Windows (PowerShell)

$env:BEEIVE_API_KEY = "YOUR_API_KEY"

To keep it permanently:

[Environment]::SetEnvironmentVariable("BEEIVE_API_KEY", "YOUR_API_KEY", "User")

CI (GitHub Actions)

Store the key as a repository secret named BEEIVE_API_KEY, then:

env:
  BEEIVE_API_KEY: ${{ secrets.BEEIVE_API_KEY }}

Your first post

1. Find the channel you want to post to:

   beeive integrations:list

   Copy the id of the channel.

2. Schedule the post:

   beeive posts:create \
     -c "Hello from the Beeive CLI!" \
     -s "2026-12-31T09:00:00Z" \
     -i "YOUR_CHANNEL_ID"

3. Check it’s in the queue:

   beeive posts:list

Tip

Dates use ISO 8601 format in UTC, for example 2026-12-31T09:00:00Z for 9am UTC on 31 December 2026.

All commandsEvery command and option, with examples.

Agent skillTeach AI coding agents to use the CLI.