feedbackbasket-cli 0.9.1 → 0.10.0

package/README.md

@@ -41,6 +41,8 @@ feedbackbasket feedback update <id> --status PLANNED --agent
 feedbackbasket widget script myproject --agent
 ```
 
+When installing or configuring a widget for the current app, agents should not rely on the CLI default project. First run `feedbackbasket projects list --agent`, match the current app by its real website URL or clearly matching project name, and only create a new project after confirming no existing project belongs to this app. If the only known URL is `localhost`, ask for the production, staging, preview, or intended public URL before creating the project.
+
 ### Install Claude Code Skill
 
 ```bash
@@ -70,11 +72,14 @@ All project commands accept **name or ID** (e.g. `feedbackbasket` or `cmn3c7sgv.
 feedbackbasket projects list                              # List all projects with stats
 feedbackbasket projects show <name-or-id>                 # Project details
 feedbackbasket projects create "My App" --url https://... # Create project
+feedbackbasket projects create "Local Test" --url http://localhost:3000 --allow-local-url
 feedbackbasket projects update myapp --name "New Name"    # Update project
 feedbackbasket projects update myapp --reply-to vlad@example.com  # Set default reply-to email
 feedbackbasket projects delete myapp                      # Delete (with confirmation)
 ```
 
+Use the production, staging, preview, or intended public website URL for projects. The CLI blocks accidental `localhost`/loopback URLs in agent and non-interactive mode unless you pass `--allow-local-url` for an explicitly local-only test project.
+
 ### Feedback
 
 ```bash
@@ -124,23 +129,39 @@ feedbackbasket bugs stats --project myapp   # Per-project stats
 feedbackbasket widget settings myapp
 
 # Update widget configuration
+feedbackbasket widget settings myapp --capture-mode waitlist
+feedbackbasket widget settings myapp --capture-mode feedback
 feedbackbasket widget settings myapp --color "#22c55e" --label "Send Feedback"
 feedbackbasket widget settings myapp --position bottom-left --display modal
 feedbackbasket widget settings myapp --email-required --intro "How can we improve?"
 feedbackbasket widget settings myapp --button-radius 10 --button-size regular
-feedbackbasket widget settings myapp --show-email --allow-attachments --guided
+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
 
 # Configure guided feedback types and follow-up questions
 feedbackbasket widget flow myapp
-feedbackbasket widget flow myapp --enable
-feedbackbasket widget flow myapp --reset-default --enable
+feedbackbasket widget flow myapp --enable                  # guided only when requested
+feedbackbasket widget flow myapp --reset-default --enable  # guided only when requested
 feedbackbasket widget flow myapp --config ./feedback-flow.json
 
 # Get embed code (ready to paste into your HTML)
 feedbackbasket widget script myapp
 ```
 
+Waitlist mode uses the same project script. Add `data-feedbackbasket-waitlist` to your own form, with a required `email` field and optional `name` field. The CLI's `widget script` output shows a starter form when waitlist mode is active.
+
+### Waitlist
+
+```bash
+feedbackbasket waitlist list myapp
+feedbackbasket waitlist list myapp --search "@example.com" --limit 50 --offset 0
+feedbackbasket waitlist list myapp --agent
+feedbackbasket waitlist export myapp
+```
+
+Waitlist listing returns emails, optional names, source pages, total counts, the active capture mode, and pagination. Export prints the dashboard-compatible CSV to stdout.
+
 For inline trigger mode, load the widget once and call the public API from your own button:
 
 ```html
@@ -151,8 +172,12 @@ For inline trigger mode, load the widget once and call the public API from your
 
 Passing the trigger element lets popup mode open beside your custom button. Calling `window.FeedbackWidget.openFeedbackForm()` with no arguments still uses the configured widget position.
 
+Use only the public `openFeedbackForm()` API from the snippet. Do not call internal or undocumented methods such as `open()` or `openModal()`.
+
 Use `--email-read-only` and `--hide-email-when-prefilled` with runtime `userEmail` values from your app. These settings do not store visitor emails in FeedbackBasket widget settings.
 
+The default widget experience is a basic modal. Only switch to popup mode or enable guided feedback when you intentionally want that flow.
+
 `widget flow --config` accepts either a `feedbackFlow` object or a JSON object with a `feedbackFlow` key. V1 supports guided mode with `text`, `textarea`, and `single_choice` follow-up questions.
 
 ```json

package/dist/src/cli.js

@@ -11,6 +11,7 @@ import { createDoctorCommand } from './commands/doctor.js';
 import { createSetupCommand } from './commands/setup.js';
 import { createWidgetCommand } from './commands/widget.js';
 import { createTeamCommand } from './commands/team.js';
+import { createWaitlistCommand } from './commands/waitlist.js';
 import { renderRootHelp } from './help.js';
 let writer;
 function resolveFormat(opts) {
@@ -62,6 +63,7 @@ export function run() {
     program.addCommand(createFeedbackCommand(getWriter));
     program.addCommand(createBugsCommand(getWriter));
     program.addCommand(createWidgetCommand(getWriter));
+    program.addCommand(createWaitlistCommand(getWriter));
     program.addCommand(createTeamCommand(getWriter));
     program.addCommand(createDoctorCommand(getWriter));
     program.addCommand(createSetupCommand(getWriter));

package/dist/src/client.d.ts

@@ -1,6 +1,7 @@
-import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, FeedbackReplyResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings } from './types.js';
+import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, FeedbackReplyResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings, WaitlistResponse } from './types.js';
 export declare class FeedbackBasketClient {
-    private http;
+    private readonly apiBaseUrl;
+    private readonly token;
     constructor(token: string, baseUrl: string);
     me(): Promise<UserProfile>;
     listProjects(): Promise<ProjectsResponse>;
@@ -48,9 +49,16 @@ export declare class FeedbackBasketClient {
     getWidgetScript(projectId: string): Promise<{
         projectId: string;
         projectName: string;
+        captureMode: 'feedback' | 'waitlist';
         embedCode: string;
         scriptUrl: string;
     }>;
+    getWaitlist(projectId: string, params?: {
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<WaitlistResponse>;
+    exportWaitlist(projectId: string): Promise<string>;
     updateFeedback(id: string, data: {
         status?: string;
         category?: string;
@@ -118,5 +126,4 @@ export declare class FeedbackBasketClient {
         email: string;
     }>;
     private request;
-    private handleError;
 }

package/dist/src/client.js

@@ -1,18 +1,11 @@
-import axios, { AxiosError } from 'axios';
 import { USER_AGENT } from './version.js';
-import { errAuth, errForbidden, errRateLimit, errNetwork, errAPI } from './output/errors.js';
+import { CLIError, errAuth, errForbidden, errRateLimit, errNetwork, errAPI } from './output/errors.js';
 export class FeedbackBasketClient {
-    http;
+    apiBaseUrl;
+    token;
     constructor(token, baseUrl) {
-        this.http = axios.create({
-            baseURL: `${baseUrl}/api/v1`,
-            timeout: 30_000,
-            headers: {
-                'Authorization': `Bearer ${token}`,
-                'Content-Type': 'application/json',
-                'User-Agent': USER_AGENT,
-            },
-        });
+        this.apiBaseUrl = `${baseUrl.replace(/\/$/, '')}/api/v1`;
+        this.token = token;
     }
     async me() {
         return this.request('GET', '/auth/me');
@@ -63,6 +56,14 @@ export class FeedbackBasketClient {
     async getWidgetScript(projectId) {
         return this.request('GET', `/projects/${encodeURIComponent(projectId)}/widget-script`);
     }
+    async getWaitlist(projectId, params = {}) {
+        const query = buildQuery(params);
+        return this.request('GET', `/projects/${encodeURIComponent(projectId)}/waitlist${query}`);
+    }
+    async exportWaitlist(projectId) {
+        const data = await this.request('GET', `/projects/${encodeURIComponent(projectId)}/waitlist/export`);
+        return typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+    }
     // Write operations
     async updateFeedback(id, data) {
         return this.request('PATCH', `/feedback/${encodeURIComponent(id)}`, data);
@@ -95,8 +96,8 @@ export class FeedbackBasketClient {
         return this.request('DELETE', `/feedback/${encodeURIComponent(feedbackId)}/notes/${encodeURIComponent(noteId)}`);
     }
     async exportFeedback(projectId, format = 'csv') {
-        const response = await this.http.get(`/projects/${encodeURIComponent(projectId)}/export?format=${format}`);
-        return typeof response.data === 'string' ? response.data : JSON.stringify(response.data, null, 2);
+        const data = await this.request('GET', `/projects/${encodeURIComponent(projectId)}/export?format=${format}`);
+        return typeof data === 'string' ? data : JSON.stringify(data, null, 2);
     }
     // Team
     async listTeam() {
@@ -109,34 +110,58 @@ export class FeedbackBasketClient {
         return this.request('DELETE', `/team/${encodeURIComponent(memberId)}`);
     }
     async request(method, path, data) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 30_000);
         try {
-            const response = await this.http.request({ method, url: path, data });
-            return response.data;
+            const response = await fetch(`${this.apiBaseUrl}${path}`, {
+                method,
+                signal: controller.signal,
+                headers: {
+                    'Authorization': `Bearer ${this.token}`,
+                    'Content-Type': 'application/json',
+                    'User-Agent': USER_AGENT,
+                },
+                body: data === undefined ? undefined : JSON.stringify(data),
+            });
+            const contentType = response.headers.get('content-type') ?? '';
+            const payload = contentType.includes('application/json')
+                ? await response.json().catch(() => null)
+                : await response.text();
+            if (!response.ok) {
+                const message = getErrorMessage(payload, response.statusText);
+                switch (response.status) {
+                    case 401: throw errAuth(message);
+                    case 403: throw errForbidden(message);
+                    case 404: throw errAPI(404, message);
+                    case 429: throw errRateLimit();
+                    default: throw errAPI(response.status, message);
+                }
+            }
+            return payload;
         }
         catch (error) {
-            throw this.handleError(error);
+            if (error instanceof CLIError)
+                throw error;
+            const cause = error instanceof Error ? error : new Error(String(error));
+            throw errNetwork(cause);
         }
-    }
-    handleError(error) {
-        if (error instanceof AxiosError) {
-            const status = error.response?.status;
-            const message = error.response?.data?.error
-                ?? error.response?.data?.message
-                ?? error.message;
-            if (!error.response) {
-                return errNetwork(error);
-            }
-            switch (status) {
-                case 401: return errAuth(message);
-                case 403: return errForbidden(message);
-                case 404: return errAPI(404, message);
-                case 429: return errRateLimit();
-                default: return errAPI(status ?? 500, message);
-            }
+        finally {
+            clearTimeout(timeout);
         }
-        return error instanceof Error ? error : new Error(String(error));
     }
 }
+function getErrorMessage(payload, fallback) {
+    if (payload && typeof payload === 'object') {
+        const value = payload;
+        if (typeof value.error === 'string')
+            return value.error;
+        if (typeof value.message === 'string')
+            return value.message;
+    }
+    if (typeof payload === 'string' && payload.trim())
+        return payload;
+    return fallback || 'Request failed';
+}
 function buildQuery(params) {
     const parts = [];
     for (const [key, value] of Object.entries(params)) {

package/dist/src/commands/projects.js

@@ -59,9 +59,11 @@ export function createProjectsCommand(getWriter) {
         .description('Create a new project')
         .requiredOption('--url <url>', 'Project URL')
         .option('--description <text>', 'Project description')
+        .option('--allow-local-url', 'Allow localhost URLs for local-only test projects')
         .action(async (name, opts) => {
         const writer = getWriter();
         const client = requireClient();
+        await ensureProjectUrlIsIntentional(opts.url, writer, Boolean(opts.allowLocalUrl));
         const result = await client.createProject({
             name,
             url: opts.url,
@@ -89,6 +91,7 @@ export function createProjectsCommand(getWriter) {
         .option('--url <url>', 'New project URL')
         .option('--description <text>', 'New project description')
         .option('--reply-to <email>', 'Default reply-to email for feedback replies (empty string to clear)')
+        .option('--allow-local-url', 'Allow localhost URLs for local-only test projects')
         .action(async (idOrName, opts) => {
         const writer = getWriter();
         if (!opts.name &&
@@ -100,6 +103,9 @@ export function createProjectsCommand(getWriter) {
         const client = requireClient();
         const resolved = await resolveProject(client, idOrName);
         const id = resolved.id;
+        if (opts.url) {
+            await ensureProjectUrlIsIntentional(opts.url, writer, Boolean(opts.allowLocalUrl));
+        }
         const data = {};
         if (opts.name)
             data['name'] = opts.name;
@@ -225,3 +231,32 @@ function renderProjectDetail(project) {
     }
     console.log();
 }
+async function ensureProjectUrlIsIntentional(url, writer, allowLocalUrl) {
+    if (!isLocalProjectUrl(url) || allowLocalUrl)
+        return;
+    const message = 'Project URL looks like a local development address. Use the production, staging, preview, or intended public website URL, or pass --allow-local-url for a local-only test project.';
+    if (writer.isMachineOutput() || !process.stdin.isTTY) {
+        throw errUsage(message, 'Example: feedbackbasket projects create "My App" --url https://myapp.com');
+    }
+    console.log(`  ${brand.warning('Warning:')} ${message}`);
+    console.log();
+    const confirmed = await confirm('  Use this as a local-only test project URL?', false);
+    if (!confirmed) {
+        throw errUsage('Project URL change cancelled. Re-run with the real website URL.', 'Example: feedbackbasket projects create "My App" --url https://myapp.com');
+    }
+}
+function isLocalProjectUrl(input) {
+    try {
+        const url = new URL(input);
+        const hostname = url.hostname.toLowerCase();
+        return (hostname === 'localhost' ||
+            hostname === '127.0.0.1' ||
+            hostname === '0.0.0.0' ||
+            hostname === '::1' ||
+            hostname === '[::1]' ||
+            hostname.endsWith('.localhost'));
+    }
+    catch {
+        return false;
+    }
+}

package/dist/src/commands/waitlist.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+import { type OutputWriter } from '../output/writer.js';
+export declare function createWaitlistCommand(getWriter: () => OutputWriter): Command;

package/dist/src/commands/waitlist.js

@@ -0,0 +1,99 @@
+import { Command } from 'commander';
+import { FeedbackBasketClient } from '../client.js';
+import { AuthManager } from '../auth/manager.js';
+import { loadConfig } from '../config/config.js';
+import { errAuth, errUsage } from '../output/errors.js';
+import { Format } from '../output/writer.js';
+import { brand, divider } from '../output/theme.js';
+import { resolveProject } from '../resolve.js';
+export function createWaitlistCommand(getWriter) {
+    const waitlist = new Command('waitlist')
+        .description('View and export waitlist signups');
+    waitlist
+        .command('list [project]')
+        .description('List waitlist signups with optional search')
+        .option('--search <query>', 'Search email addresses and names')
+        .option('--limit <n>', 'Max results (1-100)', '50')
+        .option('--offset <n>', 'Offset for pagination', '0')
+        .action(async (projectArg, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        const limit = parseInteger(opts.limit, '--limit', 1, 100);
+        const offset = parseInteger(opts.offset, '--offset', 0);
+        const result = await client.getWaitlist(projectId, {
+            search: opts.search,
+            limit,
+            offset,
+        });
+        if (writer.effectiveFormat() === Format.Styled) {
+            renderWaitlist(result.project.name, result.project.captureMode, result.entries, result.totalSignups, result.pagination.totalCount);
+            if (result.pagination.hasMore) {
+                console.log(brand.muted(`  Next page: feedbackbasket waitlist list ${projectId} --offset ${offset + limit} --limit ${limit}`));
+                console.log();
+            }
+            return;
+        }
+        writer.ok(result, {
+            summary: `Showing ${result.entries.length} of ${result.pagination.totalCount} matching waitlist signups`,
+        });
+    });
+    waitlist
+        .command('export [project]')
+        .description('Export all waitlist signups as CSV')
+        .action(async (projectArg) => {
+        const client = requireClient();
+        const projectId = await resolveProjectId(client, projectArg);
+        console.log(await client.exportWaitlist(projectId));
+    });
+    return waitlist;
+}
+function requireClient() {
+    const manager = new AuthManager();
+    const token = manager.resolveToken();
+    if (!token)
+        throw errAuth();
+    const config = loadConfig();
+    return new FeedbackBasketClient(token, config.baseUrl);
+}
+async function resolveProjectId(client, projectArg) {
+    if (projectArg)
+        return (await resolveProject(client, projectArg)).id;
+    const config = loadConfig();
+    if (config.defaultProject)
+        return config.defaultProject;
+    throw errUsage('Project is required. Pass a project name/ID or set a default.', 'feedbackbasket waitlist list <project>');
+}
+function parseInteger(value, flag, minimum, maximum) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) ||
+        parsed < minimum ||
+        (maximum !== undefined && parsed > maximum)) {
+        const range = maximum === undefined ? `${minimum} or greater` : `${minimum}-${maximum}`;
+        throw errUsage(`${flag} must be an integer in the range ${range}`);
+    }
+    return parsed;
+}
+function renderWaitlist(projectName, captureMode, entries, totalSignups, matchingSignups) {
+    console.log(brand.bold(`Waitlist — ${projectName}`));
+    console.log(divider(50));
+    console.log();
+    console.log(`  ${brand.label('Capture mode')}  ${captureMode}`);
+    console.log(`  ${brand.label('Total signups')} ${totalSignups}`);
+    if (matchingSignups !== totalSignups) {
+        console.log(`  ${brand.label('Matches')}       ${matchingSignups}`);
+    }
+    console.log();
+    if (entries.length === 0) {
+        console.log(`  ${brand.muted('No waitlist signups found')}`);
+        console.log();
+        return;
+    }
+    for (const entry of entries) {
+        console.log(`  ${brand.bold(entry.email)}${entry.name ? ` — ${entry.name}` : ''}`);
+        console.log(`    ${brand.muted(new Date(entry.updatedAt).toLocaleString())}`);
+        if (entry.pageUrl)
+            console.log(`    ${brand.muted(entry.pageUrl)}`);
+        console.log();
+    }
+}

package/dist/src/commands/widget.js

@@ -51,6 +51,7 @@ export function createWidgetCommand(getWriter) {
     widget
         .command('settings [project]')
         .description('View or update widget settings')
+        .option('--capture-mode <mode>', 'Capture mode (feedback, waitlist)')
         .option('--color <hex>', 'Button color (e.g. #22c55e)')
         .option('--label <text>', 'Button label')
         .option('--position <pos>', 'Widget position (bottom-right, bottom-left, middle-right-edge, middle-left-edge, bottom-right-edge, bottom-left-edge)')
@@ -77,6 +78,10 @@ export function createWidgetCommand(getWriter) {
         .option('--no-show-icon', 'Hide the icon')
         .option('--show-branding', 'Show FeedbackBasket branding')
         .option('--no-show-branding', 'Hide FeedbackBasket branding when plan allows it')
+        .option('--allow-console-errors', 'Let visitors include captured console errors with feedback')
+        .option('--no-allow-console-errors', 'Hide the console error sharing option')
+        .option('--error-tracking', 'Enable automatic browser error tracking')
+        .option('--no-error-tracking', 'Disable automatic browser error tracking')
         .option('--z-index <value>', 'Widget z-index')
         .option('--guided', 'Enable guided feedback types')
         .option('--disable-guided', 'Disable guided feedback types')
@@ -84,20 +89,26 @@ export function createWidgetCommand(getWriter) {
         const writer = getWriter();
         const client = requireClient();
         const projectId = await resolveProjectId(client, projectArg);
-        const hasUpdates = opts.color || opts.label || opts.position || opts.intro ||
+        const hasUpdates = opts.captureMode || opts.color || opts.label || opts.position || opts.intro ||
             opts.success || opts.trigger || opts.display ||
             opts.buttonRadius || opts.buttonSize || opts.icon ||
             opts.emailRequired !== undefined || opts.showEmail !== undefined ||
             opts.emailReadOnly !== undefined || opts.hideEmailWhenPrefilled !== undefined ||
             opts.allowAttachments !== undefined || opts.iconOnly !== undefined ||
             opts.showIcon !== undefined || opts.showBranding !== undefined ||
+            opts.allowConsoleErrors !== undefined || opts.errorTracking !== undefined ||
             opts.zIndex || opts.guided || opts.disableGuided;
         if (hasUpdates) {
             if (opts.guided && opts.disableGuided) {
                 throw errUsage('Choose either --guided or --disable-guided, not both');
             }
+            if (opts.captureMode && !['feedback', 'waitlist'].includes(opts.captureMode)) {
+                throw errUsage('Capture mode must be feedback or waitlist');
+            }
             // Update mode
             const settings = {};
+            if (opts.captureMode)
+                settings.captureMode = opts.captureMode;
             if (opts.color)
                 settings.buttonColor = opts.color;
             if (opts.label)
@@ -134,6 +145,10 @@ export function createWidgetCommand(getWriter) {
                 settings.showIcon = opts.showIcon;
             if (opts.showBranding !== undefined)
                 settings.showBranding = opts.showBranding;
+            if (opts.allowConsoleErrors !== undefined)
+                settings.allowConsoleErrors = opts.allowConsoleErrors;
+            if (opts.errorTracking !== undefined)
+                settings.errorTrackingEnabled = opts.errorTracking;
             if (opts.zIndex)
                 settings.zIndex = parseInt(opts.zIndex, 10);
             if (opts.guided || opts.disableGuided) {
@@ -153,7 +168,7 @@ export function createWidgetCommand(getWriter) {
                 breadcrumbs: [
                     { action: 'Get embed code', cmd: `feedbackbasket widget script ${projectId}` },
                     { action: 'View settings', cmd: `feedbackbasket widget settings ${projectId}` },
-                    { action: 'Configure guided questions', cmd: `feedbackbasket widget flow ${projectId} --enable` },
+                    { action: 'Configure guided questions', cmd: `feedbackbasket widget flow ${projectId}` },
                 ],
             });
         }
@@ -167,7 +182,7 @@ export function createWidgetCommand(getWriter) {
                 summary: `Widget settings for "${result.projectName}"`,
                 breadcrumbs: [
                     { action: 'Update color', cmd: `feedbackbasket widget settings ${projectId} --color "#22c55e"` },
-                    { action: 'Enable guided flow', cmd: `feedbackbasket widget flow ${projectId} --enable` },
+                    { action: 'View guided flow', cmd: `feedbackbasket widget flow ${projectId}` },
                     { action: 'Get embed code', cmd: `feedbackbasket widget script ${projectId}` },
                 ],
             });
@@ -227,8 +242,8 @@ export function createWidgetCommand(getWriter) {
         writer.ok(result.settings.feedbackFlow ?? DEFAULT_FEEDBACK_FLOW, {
             summary: `Guided feedback flow for "${result.projectName}"`,
             breadcrumbs: [
-                { action: 'Enable guided flow', cmd: `feedbackbasket widget flow ${projectId} --enable` },
-                { action: 'Reset templates', cmd: `feedbackbasket widget flow ${projectId} --reset-default --enable` },
+                { action: 'Enable guided flow if requested', cmd: `feedbackbasket widget flow ${projectId} --enable` },
+                { action: 'Reset templates if requested', cmd: `feedbackbasket widget flow ${projectId} --reset-default --enable` },
                 { action: 'Apply JSON config', cmd: `feedbackbasket widget flow ${projectId} --config ./feedback-flow.json` },
             ],
         });
@@ -253,9 +268,26 @@ export function createWidgetCommand(getWriter) {
             console.log();
             console.log(brand.muted(`  Script URL: ${result.scriptUrl}`));
             console.log();
-            renderInlineTriggerHelp(settingsResult.settings);
+            if (settingsResult.settings.captureMode === 'waitlist') {
+                renderWaitlistHelp();
+            }
+            else {
+                renderInlineTriggerHelp(settingsResult.settings);
+            }
         }
-        writer.ok(result, {
+        const output = result.captureMode === 'waitlist'
+            ? {
+                ...result,
+                waitlist: {
+                    formAttribute: 'data-feedbackbasket-waitlist',
+                    requiredField: 'email',
+                    optionalField: 'name',
+                    stateAttribute: 'data-feedbackbasket-state',
+                    events: ['feedbackbasket:waitlist:success', 'feedbackbasket:waitlist:error'],
+                },
+            }
+            : result;
+        writer.ok(output, {
             summary: `Embed code for "${result.projectName}"`,
             breadcrumbs: [
                 { action: 'Customize widget', cmd: `feedbackbasket widget settings ${projectId}` },
@@ -362,6 +394,23 @@ function renderInlineTriggerHelp(settings) {
         console.log(brand.muted('  Modal mode stays centered; passing the trigger is safe for future popup changes.'));
     }
     console.log(brand.muted('  Existing calls to window.FeedbackWidget.openFeedbackForm() still work.'));
+    console.log(brand.muted('  Do not call internal methods such as open() or openModal().'));
+    console.log();
+}
+function renderWaitlistHelp() {
+    console.log(brand.bold('Waitlist form setup'));
+    console.log(divider(50));
+    console.log();
+    console.log(brand.muted('  Keep the project script installed and annotate your own form:'));
+    console.log();
+    console.log(`  ${brand.primary('<form data-feedbackbasket-waitlist>')}`);
+    console.log(`  ${brand.primary('  <input name="name" autocomplete="name">')}`);
+    console.log(`  ${brand.primary('  <input name="email" type="email" autocomplete="email" required>')}`);
+    console.log(`  ${brand.primary('  <button type="submit">Join the waitlist</button>')}`);
+    console.log(`  ${brand.primary('</form>')}`);
+    console.log();
+    console.log(brand.muted('  Email is required; name is optional. The script handles submission without replacing your styling.'));
+    console.log(brand.muted('  Read data-feedbackbasket-state for loading, success, and error UI.'));
     console.log();
 }
 function renderWidgetSettings(projectName, settings) {
@@ -369,6 +418,7 @@ function renderWidgetSettings(projectName, settings) {
     console.log(divider(40));
     console.log();
     const display = [
+        ['Capture Mode', String(settings.captureMode ?? 'feedback')],
         ['Button Color', String(settings.buttonColor ?? '')],
         ['Button Label', String(settings.buttonLabel ?? '')],
         ['Button Radius', String(settings.buttonRadius ?? '')],
@@ -389,6 +439,8 @@ function renderWidgetSettings(projectName, settings) {
         ['Success Message', String(settings.successMessage ?? '')],
         ['Z-Index', String(settings.zIndex ?? '')],
         ['Show Branding', String(settings.showBranding ?? true)],
+        ['Share Console Errors', String(settings.allowConsoleErrors ?? false)],
+        ['Error Tracking', String(settings.errorTrackingEnabled ?? false)],
     ];
     for (const [label, value] of display) {
         console.log(`  ${brand.label(label.padEnd(18))} ${value}`);

package/dist/src/help.js

@@ -17,7 +17,7 @@ export function renderRootHelp() {
     lines.push(`  ${logo()} CLI ${brand.muted(`v${VERSION}`)}`);
     lines.push('');
     lines.push(`  ${brand.muted('The command-line interface for FeedbackBasket.')}`);
-    lines.push(`  ${brand.muted('Manage projects, feedback, widgets, and team from your terminal.')}`);
+    lines.push(`  ${brand.muted('Manage projects, feedback, waitlists, widgets, and team from your terminal.')}`);
     lines.push('');
     // Core Commands
     lines.push(section('  CORE COMMANDS'));
@@ -25,6 +25,7 @@ export function renderRootHelp() {
     lines.push(cmd('feedback', 'View and manage feedback'));
     lines.push(cmd('bugs', 'View bug reports with severity'));
     lines.push(cmd('widget', 'Manage feedback widget & get embed code'));
+    lines.push(cmd('waitlist', 'View and export waitlist signups'));
     lines.push(cmd('team', 'Manage organization members'));
     lines.push('');
     // Shortcuts
@@ -36,6 +37,7 @@ export function renderRootHelp() {
     lines.push(section('  SEARCH & EXPORT'));
     lines.push(cmd('feedback search', 'Search feedback across projects'));
     lines.push(cmd('feedback export', 'Export feedback to CSV, Markdown, or JSON'));
+    lines.push(cmd('waitlist export', 'Export waitlist signups to CSV'));
     lines.push(cmd('bugs stats', 'Bug statistics summary'));
     lines.push('');
     // Auth & Config
@@ -61,7 +63,9 @@ export function renderRootHelp() {
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket feedback list --category BUG --status OPEN`);
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket bugs list --severity high`);
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket widget script myapp`);
-    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket widget flow myapp --reset-default --enable`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket widget settings myapp --display modal`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket widget settings myapp --capture-mode waitlist`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket waitlist list myapp --search "@example.com"`);
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket projects create "My App" --url https://myapp.com`);
     lines.push('');
     // Learn More

package/dist/src/types.d.ts

@@ -24,6 +24,7 @@ export interface FeedbackFlowSettings {
     types: FeedbackFlowType[];
 }
 export interface WidgetSettings {
+    captureMode?: 'feedback' | 'waitlist';
     widgetType?: string;
     triggerMode?: 'floating' | 'inline';
     buttonColor?: string;
@@ -44,6 +45,8 @@ export interface WidgetSettings {
     displayMode?: 'modal' | 'popup';
     zIndex?: number;
     showBranding?: boolean;
+    allowConsoleErrors?: boolean;
+    errorTrackingEnabled?: boolean;
     feedbackFlow?: FeedbackFlowSettings;
 }
 export interface Project {
@@ -124,6 +127,25 @@ export interface Pagination {
     offset: number;
     hasMore: boolean;
 }
+export interface WaitlistEntry {
+    id: string;
+    email: string;
+    name?: string | null;
+    pageUrl?: string | null;
+    referrerUrl?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface WaitlistResponse {
+    project: {
+        id: string;
+        name: string;
+        captureMode: 'feedback' | 'waitlist';
+    };
+    entries: WaitlistEntry[];
+    totalSignups: number;
+    pagination: Pagination;
+}
 export interface FeedbackResponse {
     feedback: Feedback[];
     pagination: Pagination;

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.9.1";
-export declare const USER_AGENT = "FeedbackBasket-CLI/0.9.1";
+export declare const VERSION = "0.10.0";
+export declare const USER_AGENT = "FeedbackBasket-CLI/0.10.0";

package/dist/src/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.9.1';
+export const VERSION = '0.10.0';
 export const USER_AGENT = `FeedbackBasket-CLI/${VERSION}`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feedbackbasket-cli",
-  "version": "0.9.1",
-  "description": "Command-line interface for FeedbackBasket — manage feedback from your terminal",
+  "version": "0.10.0",
+  "description": "Command-line interface for FeedbackBasket — manage feedback and waitlists from your terminal",
   "type": "module",
   "main": "dist/src/cli.js",
   "bin": {
@@ -28,14 +28,13 @@
   },
   "homepage": "https://feedbackbasket.com",
   "dependencies": {
-    "axios": "1.7.0",
     "chalk": "^5.3.0",
     "commander": "^13.1.0",
     "open": "^10.1.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "tsx": "^4.0.0",
+    "tsx": "^4.23.0",
     "typescript": "^5.7.0"
   },
   "engines": {

package/skills/feedbackbasket/SKILL.md

@@ -1,21 +1,11 @@
 ---
-name: FeedbackBasket
-description: Manage FeedbackBasket projects, feedback, bugs, widgets, and team from the command line
-triggers:
-  - feedbackbasket
-  - feedback
-  - bugs
-  - bug reports
-  - user feedback
-  - widget
-  - feedback widget
-invocable: true
-argument-hint: "<command> [options]"
+name: feedbackbasket
+description: Manage FeedbackBasket projects, feedback, bugs, feedback widgets, waitlist capture, and teams from the command line. Use when an agent needs to configure FeedbackBasket, collect feedback or waitlist signups, query feedback, or manage a FeedbackBasket project.
 ---
 
 # FeedbackBasket CLI
 
-Full command-line interface for managing feedback, bug reports, projects, widgets, and team in FeedbackBasket. Works with any AI agent that can run shell commands.
+Full command-line interface for managing feedback, waitlist signups, bug reports, projects, widgets, and teams in FeedbackBasket. Works with any AI agent that can run shell commands.
 
 ## Authentication
 
@@ -53,6 +43,18 @@ feedbackbasket projects delete <name-or-id> --yes
 
 All project commands accept **name or ID**. Names are matched case-insensitively with fuzzy suggestions on typos.
 
+**Project selection rule for widget installs:** when the user asks to add a FeedbackBasket widget, bubble, popup, modal, or feedback button to the current app, first resolve the FeedbackBasket project for this app. Do not use the CLI default project just because one is configured.
+
+1. Identify the current app's real website URL or intended public URL from the user, app config, docs, or existing FeedbackBasket embed code.
+2. Run `feedbackbasket projects list --agent` and look for an existing project whose `url` matches that site or whose name clearly matches the current app.
+3. If exactly one project matches, use that project ID/name for `widget settings`, `widget script`, and feedback commands.
+4. If multiple projects could match, ask the user which one to use.
+5. If no project matches, ask whether to create a new project for this app, then create it with the confirmed real URL. Do not create a project from a localhost URL unless the user explicitly wants a local-only test project.
+
+**Project URL rule for agents:** confirm the real website URL before creating or updating a project. Never use `localhost`, `127.0.0.1`, `0.0.0.0`, `::1`, or a local dev server URL unless the user explicitly says the project is only for local testing. If the repo only exposes a local URL, ask for the production, staging, preview, or intended public URL. Do not guess a public domain from package names, git remotes, or environment variables. For an explicitly local-only test project, pass `--allow-local-url`.
+
+**Capture-mode decision:** if the user asks for feedback, a feedback bubble, bug reports, or feature requests, use `--capture-mode feedback`. If they ask for a waitlist, launch list, early access, or email capture, use `--capture-mode waitlist`. If they ask to set up FeedbackBasket without choosing, explain both options and ask which they want. Do not switch an existing project without confirmation because only one capture mode is active at a time.
+
 ### Feedback
 ```bash
 # Read
@@ -94,21 +96,47 @@ feedbackbasket widget script <project>
 
 # View settings
 feedbackbasket widget settings <project>
+feedbackbasket widget settings <project> --capture-mode waitlist
+feedbackbasket widget settings <project> --capture-mode feedback
 
 # Customize
 feedbackbasket widget settings <project> --color "#22c55e" --label "Send Feedback"
 feedbackbasket widget settings <project> --position bottom-left --display modal
 feedbackbasket widget settings <project> --email-required --intro "How can we improve?"
-feedbackbasket widget settings <project> --show-email --allow-attachments --guided
+feedbackbasket widget settings <project> --show-email --allow-attachments
 feedbackbasket widget settings <project> --email-read-only --hide-email-when-prefilled
+feedbackbasket widget settings <project> --error-tracking --allow-console-errors
 
 # Guided feedback types and follow-up questions
 feedbackbasket widget flow <project>
-feedbackbasket widget flow <project> --enable
-feedbackbasket widget flow <project> --reset-default --enable
+feedbackbasket widget flow <project> --enable  # only when the user chooses guided feedback
+feedbackbasket widget flow <project> --reset-default --enable  # only when the user chooses guided feedback
 feedbackbasket widget flow <project> --config ./feedback-flow.json
 ```
 
+Waitlist mode keeps the same project script and binds to the host app's own annotated form:
+
+```html
+<form data-feedbackbasket-waitlist>
+  <input name="name" autocomplete="name">
+  <input name="email" type="email" autocomplete="email" required>
+  <button type="submit">Join the waitlist</button>
+</form>
+```
+
+Email is required and name is optional. Use `data-feedbackbasket-state="loading|success|error"` for custom UI, or listen for the bubbling `feedbackbasket:waitlist:success` and `feedbackbasket:waitlist:error` events. Do not add a competing submit handler.
+
+### Waitlist Signups
+
+```bash
+feedbackbasket waitlist list <project>
+feedbackbasket waitlist list <project> --search "@example.com" --limit 50 --offset 0
+feedbackbasket waitlist list <project> --agent
+feedbackbasket waitlist export <project>
+```
+
+Agent output includes signup emails, optional names, captured/referrer pages, total counts, active capture mode, and pagination. Use `waitlist export` for the same CSV export available in the dashboard.
+
 For inline trigger mode, load the widget once and call the public API from the host app's custom button:
 
 ```html
@@ -127,9 +155,13 @@ In React:
 
 Passing the trigger element lets popup mode open beside the custom button. Calling `window.FeedbackWidget.openFeedbackForm()` with no arguments still uses the configured widget position.
 
+Use only the public `openFeedbackForm()` API from the snippet. Do not call internal or undocumented methods such as `open()`, `openModal()`, or direct modal element manipulation; those can exist in the widget bundle but are not stable integration points.
+
 `email-read-only` and `hide-email-when-prefilled` control behavior only when the host app passes a runtime `userEmail` value. Do not store visitor emails in widget settings.
 
-`widget flow --config` accepts either a `feedbackFlow` object or a JSON object with a `feedbackFlow` key. Use it when an agent needs to customize visitor choices such as Bug report, Feature request, and General feedback. Supported v1 question types are `text`, `textarea`, and `single_choice`.
+Use the basic widget experience by default: `displayMode` stays `modal`, and guided feedback stays disabled. Ask the user before switching to `popup` or enabling guided feedback. If the user does not care, keep modal + basic feedback.
+
+`widget flow --config` accepts either a `feedbackFlow` object or a JSON object with a `feedbackFlow` key. Use it only when the user wants to customize visitor choices such as Bug report, Feature request, and General feedback. Supported v1 question types are `text`, `textarea`, and `single_choice`.
 
 ### Team
 ```bash
@@ -146,14 +178,20 @@ feedbackbasket setup claude            # Install this skill for Claude Code
 
 ## Common Agent Workflows
 
-### Set up a new project end-to-end
+### Add a widget to the current app
 ```bash
+# First resolve the project for this app. Do not rely on the CLI default project.
+feedbackbasket projects list --agent
+
+# If no existing project matches the current app's real URL/name, create one after confirming the URL.
 feedbackbasket projects create "My App" --url https://myapp.com --agent
 feedbackbasket widget script "My App" --agent
 # Agent gets the embed code, adds it to the HTML
 feedbackbasket widget settings "My App" --color "#22c55e" --label "Feedback" --agent
-# Optional: enable the guided wizard with Bug, Feature, and General templates
-feedbackbasket widget flow "My App" --reset-default --enable --agent
+# Optional, when the user wants a waitlist instead of feedback capture
+# feedbackbasket widget settings "My App" --capture-mode waitlist --agent
+# Optional, only when requested: enable the guided wizard with Bug, Feature, and General templates
+# feedbackbasket widget flow "My App" --reset-default --enable --agent
 ```
 
 ### Triage new feedback
@@ -176,6 +214,39 @@ feedbackbasket feedback create "Login button is broken" \
 ```
 Agent mode returns the created feedback ID, dashboard URL, and feedback object. Created feedback is analyzed by AI and follows the project's notification settings.
 
+### File agent-found issues in FeedbackBasket
+
+When the user says "file this in FeedbackBasket", "log this bug", "create feedback for this issue", "add this to FeedbackBasket", or similar, create a concise feedback item for the issue the agent found.
+
+Before creating the item, resolve the target project:
+
+1. If the user explicitly names a FeedbackBasket project, use that project.
+2. If the current repo/app clearly matches exactly one FeedbackBasket project name or project URL from `feedbackbasket projects list --agent`, use that project.
+3. If the CLI default project clearly matches the current repo/app, use it.
+4. If multiple projects are plausible, ask the user which FeedbackBasket project to file it under.
+5. Do not silently guess the project when it is ambiguous.
+
+Keep agent-filed feedback short and dashboard-friendly:
+
+- Title: under 80 characters, action-oriented, no stack traces.
+- Content: 1 to 3 short paragraphs, ideally under 600 characters, focused on the user-visible problem, expected behavior, and actual behavior.
+- Do not paste long logs, full reasoning chains, or broad investigation notes into the body.
+- Put structured context in metadata: `source=agent`, `found_by=<agent>`, `repo=<name>`, `branch=<branch>`, `route=<path>`, `file=<path>`, `severity=<low|medium|high>`, `test=<command>`.
+
+Use:
+
+```bash
+feedbackbasket feedback create "<short title>" \
+  --content "<brief user-visible issue description>" \
+  --project <project-name-or-id> \
+  --type bug \
+  --metadata source=agent \
+  --metadata found_by=codex \
+  --agent
+```
+
+After creation, report the feedback ID and dashboard URL to the user.
+
 ### Investigate high-priority bugs
 ```bash
 feedbackbasket bugs list --severity high --agent