Documentation
CliCLI

CLI

Manage Boarbs from the terminal.

CLI

npm install -g @boarbs/cli

Setup

boarbs auth login --key sk_... --url https://app.boarbs.com --org org_...
boarbs auth whoami

Or via environment variables: BOARBS_API_KEY, BOARBS_API_URL, BOARBS_ORG_ID.

Output

JSON by default. Add --table for human-readable output. Pipe to jq for scripting.

Commands

boards

boarbs boards list
boarbs boards get --slug feature-requests
boarbs boards create --name "Feature Requests" --visibility PUBLIC
boarbs boards update BOARD_ID --name "New Name"
boarbs boards delete BOARD_ID

posts

boarbs posts list --board BOARD_ID --sort mostVoted --limit 50
boarbs posts get POST_ID
boarbs posts create --board BOARD_ID --title "Bug report" --email [email protected]
boarbs posts update POST_ID --title "Updated" --eta "2025-06-30"
boarbs posts delete POST_ID
boarbs posts assign POST_ID --user USER_ID

List filters: --board, --status, --tag, --assigned-to, --sort (mostVoted | newest | oldest), --limit, --cursor

comments

boarbs comments list --post POST_ID
boarbs comments create --post POST_ID --body "Thanks!" --author-email [email protected] --author-name "Team"
boarbs comments update COMMENT_ID --body "Updated"
boarbs comments delete COMMENT_ID

statuses

boarbs statuses list
boarbs statuses create --name "In Review" --color "#f59e0b" --category IN_PROGRESS
boarbs statuses update STATUS_ID --name "Reviewing"
boarbs statuses delete STATUS_ID

Categories: INBOX, PLANNED, IN_PROGRESS, COMPLETED, CANCELED

tags

boarbs tags list
boarbs tags create --name "bug" --color "#ef4444"
boarbs tags update TAG_ID --name "critical"
boarbs tags delete TAG_ID

votes

boarbs votes toggle --post POST_ID --email [email protected]

roadmaps

boarbs roadmaps list
boarbs roadmaps get --slug product-roadmap
boarbs roadmaps create --name "Q1 Roadmap" --type CUSTOM_COLUMNS
boarbs roadmaps update ROADMAP_ID --name "Updated"
boarbs roadmaps delete ROADMAP_ID