@snagtag/cli

Command-line tool for managing SnagTag test reports.

Install

npm install -g @snagtag/cli
# or use npx
npx @snagtag/cli fetch

Configuration

Create snagtag.config.json in your project root:

{
  "adapter": "supabase",
  "supabaseUrl": "https://your-project.supabase.co",
  "serviceRoleKey": "your-service-role-key",
  "tenantId": "optional"
}

Or use environment variables: SNAGTAG_SUPABASE_URL, SNAGTAG_SERVICE_ROLE_KEY, SNAGTAG_TENANT_ID.

Also checks .env.local for VITE_SUPABASE_URL as fallback.

Commands

Fetch reports

snagtag fetch                              # All submitted reports
snagtag fetch --status submitted,in_progress  # Include in-progress
snagtag fetch --severity blocking          # Only blocking issues
snagtag fetch --limit 10                   # Cap at 10
snagtag fetch --no-mark                    # Don't mark as in_progress
snagtag fetch --dry-run                    # Preview without changes

Downloads screenshots to /tmp/snagtag-reports/ and outputs markdown to stdout.

Mark reports

snagtag mark-fixed TR-47,TR-51 --commit abc123 --notes "Fixed the query"
snagtag mark-wont-fix TR-48 --notes "Intentional behaviour"
snagtag mark-deferred TR-49 --notes "Post-launch"
snagtag reopen TR-50

Report refs accept both TR-47 and 47 formats.

Adapters

Works with all three backends:

{ "adapter": "supabase", "supabaseUrl": "...", "serviceRoleKey": "..." }
{ "adapter": "rest", "baseUrl": "https://api.example.com/snagtag" }
{ "adapter": "local", "dbName": "my-app" }

License

MIT