Commands

Run beeive <command> --help to see a command’s options in your terminal.

Account

auth:login

Logs in through your browser. The terminal shows a code and a link: open the link, enter the code, log in to Beeive and click Approve. The login is saved on this computer. See Authenticate.

auth:status

Shows whether you’re logged in, and which account the CLI is using.

auth:logout

Removes the saved login from this computer.

Posts

posts:create

Creates a post on one or more channels.

Option	Description
-c, --content	Post text. Repeat it to add comments or thread items: the first -c is the post, each following -c is a comment.
-m, --media	Comma-separated media URLs for the matching -c. Repeat it once per -c.
-i, --integrations	Comma-separated channel IDs from integrations:list.
-s, --date	Required. Publish date in ISO 8601, for example 2026-12-31T09:00:00Z.
-t, --type	schedule (default) or draft.
-d, --delay	Minutes to wait between comments. Default 0.
--settings	Channel-specific settings as a JSON string. See integrations:settings.
--shortLink	Shorten links in the post. Default true.
-j, --json	Path to a JSON file with the full post body, for complex posts.

Examples

# Simple scheduled post
beeive posts:create -c "Hello World!" -s "2026-12-31T12:00:00Z" -i "CHANNEL_ID"

# Save as a draft
beeive posts:create -c "Draft post" -s "2026-12-31T12:00:00Z" -t draft -i "CHANNEL_ID"

# Same post on two channels
beeive posts:create -c "Big news!" -s "2026-12-31T12:00:00Z" -i "CHANNEL_ID_1,CHANNEL_ID_2"

# A thread of three, five minutes apart
beeive posts:create -c "Thread 1/3" -c "Thread 2/3" -c "Thread 3/3" -d 5 \
  -s "2026-12-31T12:00:00Z" -i "CHANNEL_ID"

# Post with images, and a comment with its own image
beeive posts:create \
  -c "Main post" -m "https://example.com/a.jpg,https://example.com/b.jpg" \
  -c "First comment" -m "https://example.com/c.jpg" \
  -s "2026-12-31T12:00:00Z" -i "CHANNEL_ID"

Posting local images

-m takes URLs. To post a file from your computer, upload it first with beeive upload, then pass the path it returns to -m.

posts:list

Lists posts in a date range. Defaults to 30 days back through 30 days ahead.

Option	Description
--startDate	Start of the range, ISO 8601.
--endDate	End of the range, ISO 8601.
--customer	Only posts for this customer (group) ID.

beeive posts:list --startDate "2026-01-01T00:00:00Z" --endDate "2026-12-31T23:59:59Z"

posts:delete <id>

Deletes a post.

posts:status <id>

Switches a post between draft and scheduled.

posts:settings <id>

Updates a post’s channel-specific settings. Only works on draft and scheduled posts that haven’t been published yet. The new settings are merged with the existing ones.

posts:missing <id> and posts:connect <id>

For a published post Beeive couldn’t link to its live version: posts:missing lists the matching content found on the network, and posts:connect links the post to the right one.

Channels

integrations:list

Lists your connected channels with their IDs.

integrations:groups

Lists your groups (customers).

integrations:settings <id>

Shows the settings a channel accepts, such as a title, board or privacy option. Use this to build the --settings JSON for posts:create.

integrations:trigger <id> <method>

Fetches extra data a channel’s settings need, for example the list of boards to pick from.

Media

upload <file>

Uploads a local file to your media library and prints its id and path.

beeive upload ./photo.jpg

Agent skill

skill:install

Installs the Beeive skill for your AI agent, such as Claude Code, Cursor or Codex. See Agent skill.

Option	Description
-g, --global	Install for your user account instead of the current project.
-a, --agent	Agents to install to, for example claude-code. Use "*" for all.
-y, --yes	Skip confirmation prompts.

beeive skill:install -g -a claude-code -y

Analytics

analytics:platform <id>

Analytics for a channel.

Option	Description
-d, --date	Number of days to look back. Default 7.

beeive analytics:platform CHANNEL_ID -d 30

analytics:post <id>

Analytics for a single post.