feat(cli): add a non-interrupting btw command

Author: c8dhjp4tyv-bit

cli/src/commands/__tests__/command-args.test.ts

@@ -1,6 +1,7 @@
-import { describe, test, expect, mock } from 'bun:test'
+import { afterEach, describe, test, expect, mock } from 'bun:test'
 
 import { useFeedbackStore } from '../../state/feedback-store'
+import { useChatStore } from '../../state/chat-store'
 import {
   registerActiveRun,
   stopActiveRun,
@@ -178,6 +179,7 @@ describe('command factory pattern', () => {
       // mode:* commands also accept args now
       const expectedWithArgs = [
         'feedback',
+        'btw',
         'bash',
         'image',
         'publish',
@@ -346,4 +348,85 @@ describe('command factory pattern', () => {
       expect(result).toEqual({ openFeedbackMode: true })
     })
   })
+
+  describe('/btw command', () => {
+    afterEach(() => {
+      useChatStore.getState().clearPendingAttachments()
+    })
+
+    test('queues the note and pending attachments while a turn is active', () => {
+      const btwCmd = COMMAND_REGISTRY.find((c) => c.name === 'btw')
+      expect(btwCmd).toBeDefined()
+
+      const attachment = {
+        kind: 'text' as const,
+        id: 'note.txt',
+        content: 'remember the edge case',
+        preview: 'remember the edge case',
+        charCount: 22,
+      }
+      useChatStore.getState().clearPendingAttachments()
+      useChatStore.getState().addPendingAttachment(attachment)
+
+      const addToQueue = mock(() => {})
+      const sendMessage = mock(async () => {})
+      const setInputFocused = mock(() => {})
+      const params = createMockParams({
+        inputValue: '/btw remember the edge case',
+        isStreaming: true,
+        addToQueue,
+        sendMessage,
+        setInputFocused,
+      })
+
+      btwCmd!.handler(params, 'remember the edge case')
+
+      expect(addToQueue).toHaveBeenCalledWith(
+        expect.stringContaining('remember the edge case'),
+        [attachment],
+      )
+      expect(sendMessage).not.toHaveBeenCalled()
+      expect(setInputFocused).toHaveBeenCalledWith(true)
+      expect(useChatStore.getState().pendingAttachments).toEqual([])
+    })
+
+    test('sends the note immediately when the CLI is idle', () => {
+      const btwCmd = COMMAND_REGISTRY.find((c) => c.name === 'btw')
+      expect(btwCmd).toBeDefined()
+
+      const addToQueue = mock(() => {})
+      const sendMessage = mock(async () => {})
+      const params = createMockParams({
+        inputValue: '/btw check the parser',
+        addToQueue,
+        sendMessage,
+      })
+
+      btwCmd!.handler(params, 'check the parser')
+
+      expect(sendMessage).toHaveBeenCalledWith({
+        content: expect.stringContaining('check the parser'),
+        agentMode: 'DEFAULT',
+      })
+      expect(addToQueue).not.toHaveBeenCalled()
+    })
+
+    test('shows usage instead of sending an empty note', () => {
+      const btwCmd = COMMAND_REGISTRY.find((c) => c.name === 'btw')
+      expect(btwCmd).toBeDefined()
+
+      const setMessages = mock(() => {})
+      const sendMessage = mock(async () => {})
+      const params = createMockParams({
+        inputValue: '/btw',
+        setMessages,
+        sendMessage,
+      })
+
+      btwCmd!.handler(params, '')
+
+      expect(setMessages).toHaveBeenCalled()
+      expect(sendMessage).not.toHaveBeenCalled()
+    })
+  })
 })

cli/src/commands/__tests__/prompt-builders.test.ts

@@ -1,12 +1,19 @@
 import { describe, expect, test } from 'bun:test'
 
 import {
+  buildBtwPrompt,
   buildPlanPrompt,
   buildReviewPrompt,
   buildReviewPromptFromArgs,
 } from '../prompt-builders'
 
 describe('prompt-builders base prompts', () => {
+  test('/btw keeps the note and removes command whitespace', () => {
+    expect(buildBtwPrompt('  remember to run tests  ')).toBe(
+      'The user has an additional thought for the current task. Consider it without abandoning the original request:\n\nremember to run tests',
+    )
+  })
+
   // These used to branch on whether the user had connected a ChatGPT account,
   // delegating the deep-thinking step to @thinker-gpt if so. That integration
   // is gone, so there is one branch: the user's selected model does the work.

cli/src/commands/command-registry.ts

@@ -9,7 +9,12 @@ import {
   collectProcessDiagnostics,
   formatProcessDiagnostics,
 } from './process-diagnostics'
-import { buildInterviewPrompt, buildPlanPrompt, buildReviewPromptFromArgs } from './prompt-builders'
+import {
+  buildBtwPrompt,
+  buildInterviewPrompt,
+  buildPlanPrompt,
+  buildReviewPromptFromArgs,
+} from './prompt-builders'
 import { runBashCommand } from './router'
 import { handleUsageCommand } from './usage'
 import { returnToFreebuffLanding } from '../hooks/use-freebuff-session'
@@ -592,6 +597,46 @@ const ALL_COMMANDS: CommandDefinition[] = [
       return { openReviewScreen: true }
     },
   }),
+  defineCommandWithArgs({
+    name: 'btw',
+    handler: (params, args) => {
+      const trimmedArgs = args.trim()
+      const rawInput = params.inputValue.trim()
+
+      params.saveToHistory(rawInput)
+      clearInput(params)
+
+      if (!trimmedArgs) {
+        params.setMessages((prev) => [
+          ...prev,
+          getSystemMessage('Usage: /btw <additional thought>'),
+        ])
+        return
+      }
+
+      const btwPrompt = buildBtwPrompt(trimmedArgs)
+      const isBusy =
+        params.isStreaming ||
+        params.streamMessageIdRef.current ||
+        params.isChainInProgressRef.current
+
+      if (isBusy) {
+        const pendingAttachments = capturePendingAttachments()
+        params.addToQueue(btwPrompt, pendingAttachments)
+        params.setInputFocused(true)
+        params.inputRef.current?.focus()
+        return
+      }
+
+      params.sendMessage({
+        content: btwPrompt,
+        agentMode: params.agentMode,
+      })
+      setTimeout(() => {
+        params.scrollToLatest()
+      }, 0)
+    },
+  }),
   defineCommand({
     // No `/q` alias: that one already quits the CLI, and a queue editor is not
     // worth the chance of a mis-fired exit.

cli/src/commands/prompt-builders.ts

@@ -1,5 +1,5 @@
 /**
- * Centralized prompt builders for /plan and /review commands.
+ * Centralized prompt builders for /plan, /review, and /btw commands.
  * This ensures consistent behavior regardless of entry path. Both run on the
  * user's currently selected model.
  */
@@ -10,6 +10,17 @@ const PLAN_BASE_PROMPT =
 const REVIEW_BASE_PROMPT =
   'Please gather all relevant context and then carefully review:'
 
+const BTW_BASE_PROMPT =
+  'The user has an additional thought for the current task. Consider it without abandoning the original request:'
+
+/** Build the prompt sent by `/btw` without the command syntax. */
+export function buildBtwPrompt(input: string): string {
+  const trimmedInput = input.trim()
+  return trimmedInput
+    ? `${BTW_BASE_PROMPT}\n\n${trimmedInput}`
+    : BTW_BASE_PROMPT
+}
+
 /**
  * Build a plan prompt from user input.
  * @param input - The user's plan request (e.g., "add OAuth login")
@@ -97,4 +108,3 @@ export function buildReviewPromptFromArgs(input: string): string {
   // Use the same format as preset scopes for consistency
   return `${REVIEW_BASE_PROMPT} ${trimmedInput}`
 }
-

cli/src/data/slash-commands.ts

@@ -114,6 +114,12 @@ const ALL_SLASH_COMMANDS: SlashCommand[] = [
     label: 'review',
     description: 'Review code changes',
   },
+  {
+    id: 'btw',
+    label: 'btw',
+    description:
+      'Queue an additional thought without interrupting the current task',
+  },
   {
     id: 'queue',
     label: 'queue',