feedbackbasket-cli 0.7.0 → 0.9.0

package/README.md

@@ -22,6 +22,7 @@ feedbackbasket login --manual
 # Start exploring
 feedbackbasket projects list
 feedbackbasket feedback list
+feedbackbasket feedback create "Login button is broken" --project myapp --type bug
 feedbackbasket bugs list --severity high
 ```
 
@@ -35,6 +36,7 @@ Any AI agent with shell access (Claude Code, Codex, Cursor, OpenCode) can use th
 # Agents should use --agent flag for raw JSON output
 feedbackbasket projects list --agent
 feedbackbasket feedback list --category BUG --agent
+feedbackbasket feedback create "Login button is broken" --content "Clicking Log in does nothing in Safari." --project myapp --type bug --agent
 feedbackbasket feedback update <id> --status PLANNED --agent
 feedbackbasket widget script myproject --agent
 ```
@@ -87,9 +89,13 @@ feedbackbasket feedback show <id>                          # View detail, includ
 feedbackbasket feedback search "crash on mobile"           # Search shortcut
 
 # Write
+feedbackbasket feedback create "Title" --content "Body" --project myapp
+feedbackbasket feedback create "Login bug" --content "Clicking Log in does nothing" --project myapp --type bug --page-url https://example.com/login
 feedbackbasket feedback update <id> --status PLANNED       # Update status
 feedbackbasket feedback update <id> --category BUG         # Update category
-feedbackbasket feedback reply <id> "Thanks for reporting!" # Email the submitter
+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>                       # List sent replies
 feedbackbasket feedback note <id> "Investigating this..."  # Add internal note
 feedbackbasket feedback delete <id>                        # Delete feedback

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, BugReportParams, UserProfile, Project, Feedback, WidgetSettings } from './types.js';
+import type { ProjectsResponse, FeedbackResponse, BugReportsResponse, FeedbackParams, FeedbackCreateInput, FeedbackCreateResponse, FeedbackReplyResponse, BugReportParams, UserProfile, Project, Feedback, WidgetSettings } from './types.js';
 export declare class FeedbackBasketClient {
     private http;
     constructor(token: string, baseUrl: string);
@@ -34,6 +34,7 @@ export declare class FeedbackBasketClient {
         category?: string;
         limit?: number;
     }): Promise<FeedbackResponse>;
+    createFeedback(data: FeedbackCreateInput): Promise<FeedbackCreateResponse>;
     getWidgetSettings(projectId: string): Promise<{
         projectId: string;
         projectName: string;
@@ -60,16 +61,10 @@ export declare class FeedbackBasketClient {
         content: string;
         createdAt: string;
     }>;
-    sendReply(feedbackId: string, content: string, replyToEmail?: string): Promise<{
-        reply: {
-            id: string;
-            content: string;
-            replyToEmail: string;
-            sentBy: string;
-            createdAt: string;
-        };
-        sentTo: string;
-    }>;
+    sendReply(feedbackId: string, content: string, opts?: {
+        replyToEmail?: string;
+        destinations?: Array<'email' | 'widget'>;
+    }): Promise<FeedbackReplyResponse>;
     listReplies(feedbackId: string): Promise<{
         replies: Array<{
             id: string;
@@ -78,6 +73,7 @@ export declare class FeedbackBasketClient {
             sentBy: string;
             createdAt: string;
         }>;
+        messages?: NonNullable<FeedbackReplyResponse['message']>[];
         total: number;
     }>;
     deleteFeedback(id: string): Promise<{

package/dist/src/client.js

@@ -50,6 +50,9 @@ export class FeedbackBasketClient {
     async searchFeedback(query, opts = {}) {
         return this.getFeedback({ search: query, ...opts });
     }
+    async createFeedback(data) {
+        return this.request('POST', '/feedback', data);
+    }
     // Widget
     async getWidgetSettings(projectId) {
         return this.request('GET', `/projects/${encodeURIComponent(projectId)}/widget`);
@@ -67,8 +70,11 @@ export class FeedbackBasketClient {
     async createNote(feedbackId, content) {
         return this.request('POST', `/feedback/${encodeURIComponent(feedbackId)}/notes`, { content });
     }
-    async sendReply(feedbackId, content, replyToEmail) {
+    async sendReply(feedbackId, content, opts = {}) {
         const body = { content };
+        if (opts.destinations)
+            body.destinations = opts.destinations;
+        const replyToEmail = opts.replyToEmail;
         if (replyToEmail)
             body['replyToEmail'] = replyToEmail;
         return this.request('POST', `/feedback/${encodeURIComponent(feedbackId)}/replies`, body);

package/dist/src/commands/feedback-create.d.ts

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

package/dist/src/commands/feedback-create.js

@@ -0,0 +1,120 @@
+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 { brand } from '../output/theme.js';
+import { resolveProject } from '../resolve.js';
+const validTypes = new Set(['bug', 'feature', 'general']);
+const validCategories = new Set(['BUG', 'FEATURE_REQUEST', 'IMPROVEMENT', 'QUESTION']);
+const validStatuses = new Set(['OPEN', 'UNDER_REVIEW', 'PLANNED', 'IN_PROGRESS', 'COMPLETE', 'CLOSED']);
+export function createFeedbackCreateCommand(getWriter) {
+    return new Command('create')
+        .argument('<title>', 'Short title or summary for the feedback')
+        .description('Create a new feedback item')
+        .requiredOption('--project <id-or-name>', 'Project ID or name')
+        .option('--content <body>', 'Longer feedback body')
+        .option('--type <type>', 'Feedback type (bug, feature, general)')
+        .option('--category <category>', 'Category (BUG, FEATURE_REQUEST, IMPROVEMENT, QUESTION)')
+        .option('--status <status>', 'Initial status (OPEN, UNDER_REVIEW, PLANNED, IN_PROGRESS, COMPLETE, CLOSED)')
+        .option('--email <email>', 'Submitter email')
+        .option('--page-url <url>', 'Page URL where the feedback applies')
+        .option('--metadata <key=value>', 'Metadata key/value pair (repeatable)', collectMetadata, [])
+        .action(async (title, opts) => {
+        const writer = getWriter();
+        const client = requireClient();
+        if (opts.type && !validTypes.has(opts.type)) {
+            throw errUsage('Invalid type. Must be one of: bug, feature, general', 'Example: feedbackbasket feedback create "Login is broken" --project myapp --type bug');
+        }
+        if (opts.category && !validCategories.has(opts.category)) {
+            throw errUsage('Invalid category. Must be one of: BUG, FEATURE_REQUEST, IMPROVEMENT, QUESTION');
+        }
+        if (opts.status && !validStatuses.has(opts.status)) {
+            throw errUsage('Invalid status. Must be one of: OPEN, UNDER_REVIEW, PLANNED, IN_PROGRESS, COMPLETE, CLOSED');
+        }
+        const project = await resolveProject(client, opts.project);
+        const content = composeContent(title, opts.content);
+        const metadata = parseMetadata(opts.metadata ?? []);
+        const result = await client.createFeedback({
+            projectId: project.id,
+            content,
+            type: opts.type,
+            category: opts.category,
+            status: opts.status,
+            email: opts.email,
+            pageUrl: opts.pageUrl,
+            metadata,
+        });
+        if (!writer.isMachineOutput()) {
+            console.log(`  ${brand.success('[OK]')} Feedback created: ${brand.bold(result.id)}`);
+            console.log(`    ${brand.muted('Project:')} ${project.name}`);
+            console.log(`    ${brand.muted('URL:')} ${result.url}`);
+            console.log();
+        }
+        writer.ok(result, {
+            summary: `Created feedback ${result.id}`,
+            breadcrumbs: [
+                { action: 'View feedback', cmd: `feedbackbasket feedback show ${result.id}` },
+                { action: 'Update status', cmd: `feedbackbasket feedback update ${result.id} --status UNDER_REVIEW` },
+                { action: 'List project feedback', cmd: `feedbackbasket feedback list --project ${project.id}` },
+            ],
+        });
+    });
+}
+function requireClient() {
+    const manager = new AuthManager();
+    const token = manager.resolveToken();
+    if (!token)
+        throw errAuth();
+    const config = loadConfig();
+    return new FeedbackBasketClient(token, config.baseUrl);
+}
+function composeContent(title, body) {
+    const cleanTitle = title.trim();
+    const cleanBody = body?.trim();
+    const content = cleanBody ? `${cleanTitle}\n\n${cleanBody}` : cleanTitle;
+    if (!content) {
+        throw errUsage('Feedback title is required');
+    }
+    if (content.length > 2000) {
+        throw errUsage('Feedback content must be 2000 characters or less');
+    }
+    return content;
+}
+function collectMetadata(value, previous) {
+    return previous.concat(value);
+}
+function parseMetadata(entries) {
+    if (entries.length === 0)
+        return undefined;
+    const metadata = {};
+    for (const entry of entries) {
+        const separator = entry.indexOf('=');
+        if (separator <= 0) {
+            throw errUsage(`Invalid metadata "${entry}"`, 'Use --metadata key=value, for example --metadata source=codex');
+        }
+        const key = entry.slice(0, separator).trim();
+        const rawValue = entry.slice(separator + 1).trim();
+        if (!key) {
+            throw errUsage('Metadata keys cannot be empty');
+        }
+        metadata[key] = parseMetadataValue(rawValue);
+    }
+    return metadata;
+}
+function parseMetadataValue(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value === 'null')
+        return null;
+    if (value !== '' && Number.isFinite(Number(value)))
+        return Number(value);
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}

package/dist/src/commands/feedback-reply.js

@@ -4,79 +4,84 @@ import { AuthManager } from '../auth/manager.js';
 import { loadConfig } from '../config/config.js';
 import { errAuth, errUsage } from '../output/errors.js';
 import { brand } from '../output/theme.js';
-import { ask, confirm } from '../prompt.js';
+import { ask } from '../prompt.js';
+const deliveryOptions = new Set(['email', 'widget', 'both']);
 export function createFeedbackReplyCommand(getWriter) {
     return new Command('reply')
         .argument('<id>', 'Feedback ID to reply to')
         .argument('[content]', 'Reply content (or use --content)')
-        .description('Send an email reply to the feedback submitter')
+        .description('Reply to feedback by email, widget thread, or both')
         .option('--content <text>', 'Reply content (alternative to positional argument)')
-        .option('--reply-to <email>', 'Reply-to email (overrides project default)')
+        .option('--delivery <delivery>', 'Reply delivery (email, widget, both)', 'email')
+        .option('--reply-to <email>', 'Reply-to email for email delivery')
         .action(async (id, contentArg, opts) => {
         const writer = getWriter();
         const content = contentArg ?? opts.content;
+        const delivery = opts.delivery;
         if (!content) {
-            throw errUsage('Reply content is required', 'Example: feedbackbasket feedback reply <id> "Thanks for reporting this!"');
+            throw errUsage('Reply content is required', 'Example: feedbackbasket feedback reply <id> "Thanks for reporting this!" --delivery widget');
+        }
+        if (!deliveryOptions.has(delivery)) {
+            throw errUsage('Delivery must be email, widget, or both', 'Example: feedbackbasket feedback reply <id> "Thanks!" --delivery both --reply-to support@example.com');
         }
         const client = requireClient();
-        let replyTo = opts.replyTo;
-        // If no --reply-to flag, check if we need to resolve one interactively
-        if (!replyTo) {
-            const feedback = await client.getFeedbackById(id);
+        const feedback = await client.getFeedbackById(id);
+        const destinations = delivery === 'both'
+            ? ['email', 'widget']
+            : [delivery];
+        const sendsEmail = destinations.includes('email');
+        const sendsWidget = destinations.includes('widget');
+        let replyTo = opts.replyTo ?? feedback.project.replyToEmail ?? undefined;
+        if (sendsEmail) {
             if (!feedback.email) {
-                throw errUsage('This feedback has no email address — cannot send a reply.');
+                throw errUsage('This feedback has no email address; use --delivery widget if it has a widget thread.');
             }
-            const projectReplyTo = feedback.project.replyToEmail;
-            if (!projectReplyTo) {
+            if (!replyTo) {
                 const isInteractive = !writer.isMachineOutput() && process.stdin.isTTY;
-                if (isInteractive) {
-                    // Get user's email as suggestion
-                    const manager = new AuthManager();
-                    const creds = manager.getCredentials();
-                    const accountEmail = creds?.email;
-                    console.log();
-                    console.log(brand.warning('  No reply-to email configured for this project.'));
-                    console.log(brand.muted('  The recipient will see this as the sender address.'));
-                    console.log();
-                    if (accountEmail) {
-                        const useAccount = await confirm(`  Use ${brand.bold(accountEmail)}?`);
-                        if (useAccount) {
-                            replyTo = accountEmail;
-                        }
-                        else {
-                            replyTo = await ask('  Enter reply-to email: ');
-                            if (!replyTo || !replyTo.includes('@')) {
-                                console.log(brand.muted('  Cancelled.'));
-                                return;
-                            }
-                        }
-                    }
-                    else {
-                        replyTo = await ask('  Enter reply-to email: ');
-                        if (!replyTo || !replyTo.includes('@')) {
-                            console.log(brand.muted('  Cancelled.'));
-                            return;
-                        }
-                    }
-                    console.log();
-                    console.log(brand.muted(`  Tip: Set a default with: feedbackbasket projects update ${feedback.project.name} --reply-to ${replyTo}`));
-                    console.log();
+                if (!isInteractive) {
+                    throw errUsage('No reply-to email configured for this project.', 'Ask the human which reply-to email to use, then pass --reply-to <email> or set a project default.');
                 }
-                else {
-                    // Agent mode — must pass --reply-to or set project default
-                    throw errUsage('No reply-to email configured for this project.', `Pass --reply-to <email> or set a default: feedbackbasket projects update <project> --reply-to <email>`);
+                console.log();
+                console.log(brand.warning('  No reply-to email configured for this project.'));
+                console.log(brand.muted('  The recipient will see this as the sender address.'));
+                console.log();
+                replyTo = await ask('  Enter reply-to email: ');
+                if (!replyTo || !replyTo.includes('@')) {
+                    console.log(brand.muted('  Cancelled.'));
+                    return;
                 }
+                console.log();
+                console.log(brand.muted(`  Tip: Set a default with: feedbackbasket projects update ${feedback.project.name} --reply-to ${replyTo}`));
+                console.log();
             }
         }
-        const result = await client.sendReply(id, content, replyTo);
+        if (sendsWidget && !feedback.hasWidgetAccess) {
+            throw errUsage('This feedback is not connected to a widget thread.', 'Use --delivery email for feedback with an email address, or ask the human how they want to respond.');
+        }
+        const result = await client.sendReply(id, content, {
+            replyToEmail: replyTo,
+            destinations,
+        });
         if (!writer.isMachineOutput()) {
-            console.log(`  ${brand.success('✓')} Reply sent to ${brand.bold(result.sentTo)}`);
-            console.log(`    ${brand.muted('From:')} ${result.reply.replyToEmail}`);
-            console.log(`    ${brand.muted('By:')}   ${result.reply.sentBy}`);
+            if (result.sentTo) {
+                console.log(`  ${brand.success('[OK]')} Email reply sent to ${brand.bold(result.sentTo)}`);
+                if (result.reply) {
+                    console.log(`    ${brand.muted('From:')} ${result.reply.replyToEmail}`);
+                    console.log(`    ${brand.muted('By:')}   ${result.reply.sentBy}`);
+                }
+            }
+            if (result.message) {
+                console.log(`  ${brand.success('[OK]')} Widget reply posted`);
+                console.log(`    ${brand.muted('By:')}   ${result.message.sentByName ?? 'CLI'}`);
+            }
             console.log();
         }
         writer.ok(result, {
-            summary: `Reply sent to ${result.sentTo}`,
+            summary: delivery === 'both'
+                ? 'Reply sent by email and widget'
+                : delivery === 'widget'
+                    ? 'Widget reply posted'
+                    : `Reply sent to ${result.sentTo}`,
             breadcrumbs: [
                 { action: 'View replies', cmd: `feedbackbasket feedback replies ${id}` },
                 { action: 'Update status', cmd: `feedbackbasket feedback update ${id} --status COMPLETE` },
@@ -93,8 +98,10 @@ export function createFeedbackRepliesCommand(getWriter) {
         const writer = getWriter();
         const client = requireClient();
         const result = await client.listReplies(id);
+        const messages = result.messages ?? [];
+        const visibleWidgetMessages = messages.filter((item) => !item.replyId);
         if (!writer.isMachineOutput()) {
-            if (result.replies.length === 0) {
+            if (result.total === 0) {
                 console.log(brand.muted('  No replies sent yet.'));
                 console.log();
             }
@@ -102,7 +109,8 @@ export function createFeedbackRepliesCommand(getWriter) {
                 console.log(brand.bold(`${result.total} repl${result.total === 1 ? 'y' : 'ies'} for feedback ${id}`));
                 console.log();
                 for (const r of result.replies) {
-                    console.log(`  ${brand.success('→')} ${brand.bold(r.sentBy)} ${brand.muted(r.createdAt)}`);
+                    console.log(`  ${brand.success('->')} ${brand.bold(r.sentBy)} ${brand.muted(r.createdAt)}`);
+                    console.log(`    ${brand.muted('Delivery:')} email`);
                     console.log(`    ${brand.muted('Reply-to:')} ${r.replyToEmail}`);
                     console.log();
                     for (const line of r.content.split('\n')) {
@@ -110,12 +118,22 @@ export function createFeedbackRepliesCommand(getWriter) {
                     }
                     console.log();
                 }
+                for (const message of visibleWidgetMessages) {
+                    console.log(`  ${brand.success('->')} ${brand.bold(message.sentByName ?? 'CLI')} ${brand.muted(message.createdAt)}`);
+                    console.log(`    ${brand.muted('Delivery:')} widget`);
+                    console.log();
+                    for (const line of message.content.split('\n')) {
+                        console.log(`    ${line}`);
+                    }
+                    console.log();
+                }
             }
         }
-        writer.ok(result.replies, {
+        writer.ok({ replies: result.replies, messages }, {
             summary: `${result.total} repl${result.total === 1 ? 'y' : 'ies'}`,
             breadcrumbs: [
-                { action: 'Send a reply', cmd: `feedbackbasket feedback reply ${id} "<content>"` },
+                { action: 'Send an email reply', cmd: `feedbackbasket feedback reply ${id} "<content>" --delivery email` },
+                { action: 'Post a widget reply', cmd: `feedbackbasket feedback reply ${id} "<content>" --delivery widget` },
                 { action: 'View feedback', cmd: `feedbackbasket feedback show ${id}` },
             ],
         });

package/dist/src/commands/feedback.js

@@ -17,6 +17,7 @@ async function resolveProjectId(client, optProject, all) {
 }
 import { createFeedbackUpdateCommand } from './feedback-update.js';
 import { createFeedbackNoteCommand } from './feedback-note.js';
+import { createFeedbackCreateCommand } from './feedback-create.js';
 import { createFeedbackDeleteCommand } from './feedback-delete.js';
 import { createFeedbackBulkUpdateCommand } from './feedback-bulk-update.js';
 import { createFeedbackExportCommand } from './feedback-export.js';
@@ -25,6 +26,7 @@ export function createFeedbackCommand(getWriter) {
     const feedback = new Command('feedback')
         .description('View and manage feedback');
     // Write subcommands
+    feedback.addCommand(createFeedbackCreateCommand(getWriter));
     feedback.addCommand(createFeedbackUpdateCommand(getWriter));
     feedback.addCommand(createFeedbackNoteCommand(getWriter));
     feedback.addCommand(createFeedbackReplyCommand(getWriter));
@@ -184,6 +186,7 @@ function renderFeedbackDetail(item) {
         ['OS', item.os],
         ['Device', item.device],
         ['Language', item.language],
+        ['Widget Thread', item.hasWidgetAccess ? 'Yes' : null],
         ['Created', item.createdAt],
     ];
     for (const [label, value] of fields) {

package/dist/src/help.js

@@ -57,6 +57,7 @@ export function renderRootHelp() {
     // Examples
     lines.push(section('  EXAMPLES'));
     lines.push(`${INDENT}${brand.muted('$')} feedbackbasket projects list`);
+    lines.push(`${INDENT}${brand.muted('$')} feedbackbasket feedback create "Login bug" --project myapp --type bug`);
     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`);

package/dist/src/types.d.ts

@@ -2,6 +2,7 @@ export type FeedbackStatus = 'OPEN' | 'UNDER_REVIEW' | 'PLANNED' | 'IN_PROGRESS'
 export type FeedbackCategory = 'BUG' | 'FEATURE_REQUEST' | 'IMPROVEMENT' | 'QUESTION';
 export type Sentiment = 'POSITIVE' | 'NEGATIVE' | 'NEUTRAL';
 export type Severity = 'high' | 'medium' | 'low';
+export type ReplyDelivery = 'email' | 'widget' | 'both';
 export type FeedbackFlowQuestionType = 'text' | 'textarea' | 'single_choice';
 export interface FeedbackFlowQuestion {
     id: string;
@@ -84,6 +85,7 @@ export interface Feedback {
     os?: string | null;
     device?: string | null;
     language?: string | null;
+    hasWidgetAccess?: boolean;
     attachments?: FeedbackAttachment[];
     project: {
         id: string;
@@ -126,6 +128,40 @@ export interface FeedbackResponse {
     feedback: Feedback[];
     pagination: Pagination;
 }
+export interface FeedbackCreateInput {
+    projectId: string;
+    content: string;
+    type?: 'bug' | 'feature' | 'general';
+    category?: FeedbackCategory;
+    status?: FeedbackStatus;
+    email?: string;
+    pageUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface FeedbackCreateResponse {
+    id: string;
+    url: string;
+    feedback: Feedback;
+}
+export interface FeedbackReplyResponse {
+    reply: {
+        id: string;
+        content: string;
+        replyToEmail: string;
+        sentBy: string;
+        createdAt: string;
+    } | null;
+    message: {
+        id: string;
+        content: string;
+        delivery: 'WIDGET' | 'EMAIL' | 'BOTH';
+        sentByName: string | null;
+        replyId: string | null;
+        createdAt: string;
+    } | null;
+    sentTo: string | null;
+    destinations: Array<'email' | 'widget'>;
+}
 export interface BugReportsResponse {
     bugReports: BugReport[];
     stats: {

package/dist/src/version.d.ts

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

package/dist/src/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feedbackbasket-cli",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Command-line interface for FeedbackBasket — manage feedback from your terminal",
   "type": "module",
   "main": "dist/src/cli.js",

package/skills/feedbackbasket/SKILL.md

@@ -62,14 +62,17 @@ feedbackbasket feedback show <id>
 feedbackbasket feedback search "crash on mobile" --project <id> --limit 10
 
 # Write
+feedbackbasket feedback create "Login button is broken" --content "Clicking Log in does nothing in Safari." --project <id> --type bug
+feedbackbasket feedback create "Feature idea" --content "Let users export saved views." --project <id> --type feature --metadata source=agent
 feedbackbasket feedback update <id> --status PLANNED --category BUG --sentiment NEGATIVE
 feedbackbasket feedback note <id> "Investigating — appears related to auth flow"
 feedbackbasket feedback delete <id> --yes
 feedbackbasket feedback bulk-update --status CLOSED --ids id1,id2,id3
 
-# Reply to submitter via email
-feedbackbasket feedback reply <id> "Thanks for reporting — we pushed a fix!"
-feedbackbasket feedback reply <id> "<content>" --reply-to vlad@example.com  # override reply-to
+# Reply to submitter by email, widget thread, or both
+feedbackbasket feedback reply <id> "Thanks for reporting — we pushed a fix!" --delivery email --reply-to support@example.com
+feedbackbasket feedback reply <id> "<content>" --delivery widget
+feedbackbasket feedback reply <id> "<content>" --delivery both --reply-to support@example.com
 feedbackbasket feedback replies <id>                                          # list past replies
 
 # Export
@@ -143,6 +146,18 @@ feedbackbasket feedback update <id> --status UNDER_REVIEW --agent
 feedbackbasket feedback note <id> "Reviewing — appears related to auth flow" --agent
 ```
 
+### Capture new feedback without leaving the terminal
+```bash
+feedbackbasket feedback create "Login button is broken" \
+  --content "Clicking Log in does nothing in Safari." \
+  --project myapp \
+  --type bug \
+  --page-url https://example.com/login \
+  --metadata source=agent \
+  --agent
+```
+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.
+
 ### Investigate high-priority bugs
 ```bash
 feedbackbasket bugs list --severity high --agent
@@ -152,18 +167,22 @@ feedbackbasket feedback show <id> --agent
 
 ### Close the loop — reply to the submitter
 ```bash
-# Agent reads context, drafts its own reply, sends it
-feedbackbasket feedback show <id> --agent                    # read context + project.replyToEmail
-feedbackbasket feedback reply <id> "<drafted response>" --agent
+# Agent reads context, asks which delivery method to use, then sends it
+feedbackbasket feedback show <id> --agent                    # read email, hasWidgetAccess, project.replyToEmail
+feedbackbasket feedback reply <id> "<drafted response>" --delivery widget --agent
+feedbackbasket feedback reply <id> "<drafted response>" --delivery email --reply-to support@example.com --agent
+feedbackbasket feedback reply <id> "<drafted response>" --delivery both --reply-to support@example.com --agent
 feedbackbasket feedback update <id> --status COMPLETE --agent
 feedbackbasket feedback note <id> "Replied via CLI" --agent
 ```
-**Important:** If `feedback show` returns `project.replyToEmail: null`, the agent MUST either:
-1. Pass `--reply-to <email>` with an explicit address, OR
-2. Ask the human which reply-to email to use (the account owner's email is a reasonable default, but requires user confirmation), OR
-3. Set a project default first: `feedbackbasket projects update <project> --reply-to <email>`
-
-Never silently guess a reply-to address — it becomes the "From" address the customer sees.
+**Important reply safety rules:**
+- Before replying, the agent MUST inspect `feedback show --agent`, then ask the human which delivery method to use: `email`, `widget`, or `both`, unless the human already specified it in the current conversation.
+- If `feedback show` returns `email: null`, do not use `--delivery email` or `--delivery both`. If `hasWidgetAccess: true`, use `--delivery widget`; otherwise ask the human how they want to respond.
+- If `hasWidgetAccess: false`, do not use `--delivery widget` or `--delivery both`.
+- If the delivery includes email and `project.replyToEmail: null`, the agent MUST ask the human which reply-to email to use before sending. Do not use the account owner's email, token owner's email, or any remembered address without explicit confirmation in the current conversation.
+- After the human confirms a reply-to address, pass it explicitly with `--reply-to <email>`, or set a project default first with `feedbackbasket projects update <project> --reply-to <email>`.
+
+Never silently guess a reply-to address. It becomes the "From" address the customer sees.
 
 ### Export for analysis
 ```bash