flusterduck-cli

The command line for Flusterduck, the automatic UX friction detector. Set up the SDK, read confusion scores and issues, manage issues, and record deploys from your terminal or CI. The binary answers to both flusterduck and duck.

Set up a project

npx flusterduck-cli init

Detects your framework (Next.js, React, Vue, SvelteKit, Nuxt, or vanilla), signs you in with your browser to pick or create a site, installs the right packages, injects the init call, and then watches for the first real event so you know the install works.

Sign in once

duck login     # browser sign-in mints a key for this terminal, or paste one
duck logout

The key is verified against the API before it is saved to a 0600 file under your config directory. After login, commands need no --key, and a site-scoped key makes --site optional too.

Everyday commands

duck scores                          # per-page confusion scores
duck issues --status open            # ranked UX issues
duck issue resolve <id> --note "Fixed in #142"
duck insights --days 30              # confused-vs-calm conversion gap
duck status --wait                   # is data flowing for a publishable key?
duck deploy notify                   # record a deploy for fix verification (run in CI)

Every command takes --json for machine-readable output. deploy notify auto-detects commit metadata on GitHub Actions, Vercel, GitLab, and Bitbucket.

Full documentation: docs.flusterduck.com/cli