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

The CLI uses your Beeive API key, which you’ll find under Settings → Developers → Access in the app. API access is included on every paid plan.

Set it as the BEEIVE_API_KEY environment variable:

export BEEIVE_API_KEY="YOUR_API_KEY"

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

$env:BEEIVE_API_KEY = "YOUR_API_KEY"

To keep it permanently:

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

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

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

Your first post

Find the channel you want to post to:
Terminal window
```
beeive integrations:list
```
Copy the id of the channel.

Schedule the post:

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

Check it’s in the queue:
Terminal window
```
beeive posts:list
```

All commandsEvery command and option, with examples.

Agent skillTeach AI coding agents to use the CLI.