CLI & Agent Skill

Full access to FeedbackBasket
from your terminal.

feedbackbasket is the official command-line interface for FeedbackBasket. Manage projects, feedback, widgets, and team from your terminal or through AI agents.

terminal
npm install -g feedbackbasket-cli

Works with any AI agent that can run shell commands — Claude Code, Codex, Cursor, OpenCode. Full setup instructions

FeedbackBasket CLI

The official command-line interface. Everything you can do in the dashboard, you can do from the terminal. Create projects, customize widgets, triage feedback, export data, manage your team.

Browser login — one click locally, manual flow when callbacks are blocked
Smart output — styled for humans, JSON for agents
Name resolution — use project names, not IDs
Breadcrumbs guide you to the next command

Agent Skill

Agent skill for feedback management — projects, bugs, feature requests, widgets, and team. Install once, use from any Claude Code session.

Auto-installed during CLI login
Triggers on feedback, bugs, and project keywords
Full command reference for the agent
Works alongside MCP for IDE-native access

Everything the dashboard can do.
Now from the terminal.

Projects

create, show, update, delete

feedbackbasket projects create "My App" --url https://...

Feedback

create, list, show, search, update, note, reply, replies, delete, bulk-update, export

feedbackbasket feedback create "Login bug" --project myapp --type bug

Bug Reports

list, stats

feedbackbasket bugs list --severity high

Widget

settings, flow, script

feedbackbasket widget flow myapp --enable

Waitlist

list (--search), export

feedbackbasket waitlist list myapp --agent

Team

list, role, remove

feedbackbasket team list

Auth

login, logout, status, token

feedbackbasket login

See it in action

From login to managing feedback in under a minute.

terminal
$ npm install -g feedbackbasket-cli
added 43 packages
$ feedbackbasket login
✓ Logged in as vlad@feedbackbasket.com
✓ Default project: My SaaS App
✓ Claude Code skill installed
$ feedbackbasket projects list
My SaaS App cm3x...  42 12 5
Landing Page cm4a...  18  3 1
$ feedbackbasket widget script "My SaaS App"
<script src="https://feedbackbasket.com/api/widget/script/cm3x..." defer></script>
$ feedbackbasket feedback create "Login bug" --project "My SaaS App" --type bug
Feedback created: cm8x...
$ feedbackbasket bugs list --severity high
[HIGH] [OPEN] Login broken on Safari 17.4
[HIGH] [OPEN] Payment form crashes on mobile
2 bugs (2 high, 0 medium, 0 low)

Command Reference

Full list of available commands. Use feedbackbasket --help for details on any command.

Authentication
feedbackbasket login                   # Browser OAuth — one click
feedbackbasket login --manual          # No localhost browser callback (remote servers)
feedbackbasket login --token <token>   # Use an existing CLI token (CI / scripts)
feedbackbasket logout
feedbackbasket auth status
feedbackbasket auth token              # Print token for scripting
Projects — accepts name or ID
feedbackbasket projects list
feedbackbasket projects show myapp
feedbackbasket projects create "My App" --url https://myapp.com
feedbackbasket projects update myapp --description "Updated"
feedbackbasket projects delete myapp
Feedback
feedbackbasket feedback create "Login bug" --content "Clicking Log in does nothing" --project myapp --type bug
feedbackbasket feedback create "Feature idea" --content "Let users export saved views" --project myapp --type feature --metadata source=agent
feedbackbasket feedback list --category BUG --status OPEN
feedbackbasket feedback show <id>
feedbackbasket feedback search "crash on mobile"
feedbackbasket feedback update <id> --status PLANNED
feedbackbasket feedback note <id> "Investigating..."
feedbackbasket feedback reply <id> "Thanks!" --delivery email --reply-to support@example.com
feedbackbasket feedback reply <id> "Thanks!" --delivery widget
feedbackbasket feedback reply <id> "Thanks!" --delivery both --reply-to support@example.com
feedbackbasket feedback replies <id>
feedbackbasket feedback delete <id>
feedbackbasket feedback bulk-update --status CLOSED --ids id1,id2
feedbackbasket feedback export myapp --format csv|md|json
Bugs, Widget, Team
feedbackbasket bugs list --severity high
feedbackbasket bugs stats

feedbackbasket widget settings myapp
feedbackbasket widget settings myapp --capture-mode waitlist
feedbackbasket widget settings myapp --capture-mode feedback
feedbackbasket widget settings myapp --color "#22c55e" --label "Feedback"
feedbackbasket widget settings myapp --show-email --allow-attachments
feedbackbasket widget settings myapp --email-read-only --hide-email-when-prefilled
feedbackbasket widget settings myapp --error-tracking --allow-console-errors
feedbackbasket widget flow myapp --reset-default --enable  # guided only when requested
feedbackbasket widget flow myapp --config ./feedback-flow.json
feedbackbasket widget script myapp

feedbackbasket waitlist list myapp
feedbackbasket waitlist list myapp --search "@example.com" --limit 50 --offset 0
feedbackbasket waitlist export myapp

feedbackbasket team list
feedbackbasket team role <memberId> --role admin
feedbackbasket team remove <memberId>
Output modes
feedbackbasket projects list              # Auto: styled in TTY, JSON piped
feedbackbasket projects list --json      # JSON envelope with breadcrumbs
feedbackbasket projects list --agent     # Raw JSON for AI agents
feedbackbasket projects list --md        # Markdown