feat(cli): add /btw — queue a context note without firing a turn

apps/cli/src/commands.ts

@@ -1117,6 +1117,23 @@ export const PrivacySettingsCommand: SlashCommand = {
   },
 };
 
+export const BtwCommand: SlashCommand = {
+  name: '/btw',
+  description: 'Add a "by the way" note to the context (no agent turn fired).',
+  run(args, ctx) {
+    const note = args.join(' ').trim();
+    if (!note) {
+      return ['Usage: /btw <note> — queues a side-note the agent sees with your next message.'];
+    }
+    const base = ctx.history ?? [];
+    ctx.newHistory = [
+      ...base,
+      { role: 'user', content: [{ type: 'text', text: `(By the way: ${note})` }] },
+    ];
+    return [`Noted — the agent will see this with your next message.`];
+  },
+};
+
 export const BUILTIN_COMMANDS: SlashCommand[] = [
   HelpCommand,
   ClearCommand,
@@ -1152,6 +1169,7 @@ export const BUILTIN_COMMANDS: SlashCommand[] = [
   PrCommentsCommand,
   UpgradeCommand,
   PrivacySettingsCommand,
+  BtwCommand,
 ];
 
 // ──────────────────────────────────────────────────────────────────────────

apps/cli/src/parity-commands.test.ts

@@ -208,3 +208,18 @@ describe('/resume <id> (live switch)', () => {
     expect(out.join('\n')).toMatch(/Recent sessions/);
   });
 });
+
+describe('/btw', () => {
+  it('queues a context note into newHistory', async () => {
+    const c = ctx({ history: [{ role: 'user', content: [{ type: 'text', text: 'hello' }] }] });
+    const out = await reg.match('/btw')!.cmd.run(['use', 'tabs'], c);
+    expect(out.join('\n')).toMatch(/Noted/);
+    expect(c.newHistory).toHaveLength(2);
+    expect(JSON.stringify(c.newHistory)).toContain('use tabs');
+  });
+
+  it('shows usage with no note', async () => {
+    const out = await reg.match('/btw')!.cmd.run([], ctx());
+    expect(out.join('\n')).toMatch(/Usage: \/btw/);
+  });
+});

docs/BEHAVIOR_PARITY.md

@@ -41,7 +41,7 @@ Legend: `✅` matches · `🟡` matches with caveats · `🔄` deferred · `⚠
 | `/plugins`                 | ✓           | ✓                  | ✅ — lists wired plugins + contributed hook events + warnings (M5.2)                                                                 |
 | `/compact`                 | ✓           | ✓                  | ✅ — manual `/compact` + automatic threshold trigger in the agent loop                                                               |
 | `/diff`                    | ✓           | ✓                  | ✅ — git diff + untracked files in the working tree (PR #150)                                                                        |
-| `/btw`                     | ✓           | ✗                  | 🔄                                                                                                                                   |
+| `/btw`                     | ✓           | ✓                  | 🟡 — queues a "by the way" context note the agent sees with your next message (no turn fired); exact Claude Code behavior may differ |
 | `/recap`                   | ✓           | ✓                  | ✅ — provider-summarized recap of the session so far                                                                                 |
 | `/rewind`                  | ✓           | ✓                  | ✅ — 5 ops (code/conversation/both/summarize-from/up-to); `Esc Esc` bound                                                            |
 | `/voice`                   | ✓           | ✗                  | 🔄 M8                                                                                                                                |