winget install --id=SocialBu.SocialBuCLI -e A command-line client for managing SocialBu accounts, posts, teams, analytics, notifications, curated content, media, and AI features.
Use SocialBu from your terminal, scripts, or AI agents. Manage connected accounts, drafts and scheduled posts, analytics, notifications, curated content, media, teams, and SocialBu AI.
curl -fsSL https://raw.githubusercontent.com/socialbu/socialbu-cli/main/scripts/install.sh | sh
irm https://raw.githubusercontent.com/socialbu/socialbu-cli/main/scripts/install.ps1 | iex
Both installers select the right binary for your system and verify its checksum.
brew tap socialbu/cli https://github.com/socialbu/socialbu-cli
brew install --cask socialbu/cli/socialbu
scoop bucket add socialbu https://github.com/socialbu/socialbu-cli
scoop install socialbu/socialbu
choco install socialbu
go install github.com/socialbu/socialbu-cli/cmd/socialbu@latest
You can also download a binary for macOS, Linux, or Windows from GitHub Releases.
Check the installation:
socialbu version
Copy your token from Settings > API for Developers in SocialBu, then save it locally:
socialbu config set-key YOUR_API_TOKEN
socialbu whoami
See the SocialBu API documentation if you need help finding or creating a token.
Treat the token like a password. Do not commit it, paste it into an issue, or include it in logs. socialbu config show confirms whether a token is configured without printing it.
# See connected social accounts and their IDs
socialbu account list
# See scheduled posts
socialbu post list --type scheduled
# See account statistics
socialbu analytics stats
# See unread notifications
socialbu notifications unread
Add --json when another program or agent needs structured output:
socialbu account list --json
socialbu analytics stats --json
Use an account ID from socialbu account list. This example creates a draft and does not publish it:
socialbu post create \
--accounts 123 \
--content "Review this before publishing" \
--publish-at "2099-01-01 10:00:00" \
--draft
Remove --draft only when you want SocialBu to schedule the post. --publish-at uses UTC and the format YYYY-MM-DD HH:MM:SS.
socialbu post create \
--accounts 123,456 \
--content "This post is ready" \
--publish-at "2099-01-01 10:00:00"
For agents, CI, and scripts, pass the token through the SOCIALBU_API_KEY environment variable instead of storing it in a repository.
macOS and Linux:
export SOCIALBU_API_KEY="YOUR_API_TOKEN"
socialbu whoami --json
Windows PowerShell:
$env:SOCIALBU_API_KEY = "YOUR_API_TOKEN"
socialbu whoami --json
Environment variables override local CLI configuration for the current process. Store the value in your agent or CI platform's secret manager.
You can give an agent this instruction:
Use the socialbu CLI with --json. Start with `socialbu whoami` and
`socialbu account list`. Do not create, publish, upload, delete, or change
anything unless I explicitly approve it. When I ask for a post draft, use
`socialbu post create` with --draft and show me the returned post details.
Never print or repeat SOCIALBU_API_KEY.
| Command | What it does |
|---|---|
socialbu account | List connected accounts and inspect account details |
socialbu post | List, inspect, create, and schedule posts |
socialbu analytics | Read post, account, follower, engagement, automation, and team metrics |
socialbu ai | Generate or autocomplete content with SocialBu AI |
socialbu notifications | Read notifications and update their read state |
socialbu curation | Browse curated topics and content |
socialbu media | Upload media and check processing status |
socialbu team | List, create, and delete teams |
socialbu config | Manage local CLI configuration |
socialbu completion | Generate shell completions for Bash, Zsh, Fish, or PowerShell |
Run socialbu --help to see every command, or ask for help with a specific command:
socialbu post create --help
socialbu analytics --help