claude-code-autoconfig 1.0.197 → 1.0.198

package/.claude/commands/disable-arcade-beeps.md

@@ -0,0 +1,10 @@
+---
+description: Turn OFF Pole Position tab status beeps
+allowed-tools: Bash
+---
+
+Run exactly this command, then reply with a single confirmation line and nothing else:
+
+```
+rm -f ~/.claude/sounds/arcade-beeps.enabled && echo "arcade beeps DISABLED."
+```

package/.claude/commands/enable-arcade-beeps.md

@@ -0,0 +1,10 @@
+---
+description: Turn ON Pole Position tab status beeps (awaiting = low tone, complete = high tone)
+allowed-tools: Bash
+---
+
+Run exactly this command, then reply with a single confirmation line and nothing else:
+
+```
+mkdir -p ~/.claude/sounds && touch ~/.claude/sounds/arcade-beeps.enabled && echo "arcade beeps ENABLED (every turn-end beeps: awaiting=low, complete=high). Disable with /disable-arcade-beeps."
+```

package/.claude/docs/autoconfig.docs.html

@@ -878,6 +878,16 @@
                                 <span class="tree-file-icon">📄</span>
                                 <span class="file">commit-and-push.md</span>
                             </div>
+                            <div class="tree-item indent-3 hidden" data-info="disable-arcade-beeps" data-parent="commands">
+                                <span class="tree-spacer"></span>
+                                <span class="tree-file-icon">📄</span>
+                                <span class="file">disable-arcade-beeps.md</span>
+                            </div>
+                            <div class="tree-item indent-3 hidden" data-info="enable-arcade-beeps" data-parent="commands">
+                                <span class="tree-spacer"></span>
+                                <span class="tree-file-icon">📄</span>
+                                <span class="file">enable-arcade-beeps.md</span>
+                            </div>
                             <div class="tree-item indent-3 hidden" data-info="extract-rules" data-parent="commands">
                                 <span class="tree-spacer"></span>
                                 <span class="tree-file-icon">📄</span>
@@ -933,6 +943,11 @@
                                 <span class="tree-folder-icon">📁</span>
                                 <span class="folder">hooks</span>
                             </div>
+                            <div class="tree-item indent-3 hidden" data-info="arcade-beeps-hook" data-parent="hooks">
+                                <span class="tree-spacer"></span>
+                                <span class="tree-file-icon">📄</span>
+                                <span class="file">arcade-beeps.js</span>
+                            </div>
                             <div class="tree-item indent-3 hidden" data-info="feedback-rule-check-hook" data-parent="hooks">
                                 <span class="tree-spacer"></span>
                                 <span class="tree-file-icon">📄</span>
@@ -1263,7 +1278,7 @@
                 title: '.claude/ Directory',
                 desc: 'Commands, rules, settings, and these docs. Keeps configuration organized as your project grows.'
             },
-                                                                                                                                                                                                                                                                                                                                                                                                            'rules': {
+                                                                                                                                                                                                                                                                                                                                                                                                                        'rules': {
                 title: 'rules/',
                 desc: 'Path-scoped context that loads when Claude works on matching files.'
             },
@@ -1298,6 +1313,16 @@
                 desc: 'Runs tests, then stages all changes, generates a conventional commit message, commits, and pushes.<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Changes committed and pushed to current branch.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>test-failure</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Tests failed — no commit made.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Runs test suite, stages all changes, creates git commit, pushes to remote</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/commit-and-push</code> <span style="opacity: 0.6;">— Run tests, commit, and push</span></div></div></div>',
                 trigger: '/commit-and-push'
             },
+            'disable-arcade-beeps': {
+                title: 'disable-arcade-beeps.md',
+                desc: 'disable-arcade-beeps.md in commands/<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div>',
+                trigger: '/disable-arcade-beeps'
+            },
+            'enable-arcade-beeps': {
+                title: 'enable-arcade-beeps.md',
+                desc: 'enable-arcade-beeps.md in commands/<div style="margin-top: 12px;"><strong>Parameters</strong><div style="margin-top: 4px; opacity: 0.6;">None</div></div>',
+                trigger: '/enable-arcade-beeps'
+            },
             'extract-rules': {
                 title: 'extract-rules.md',
                 desc: 'Scan Claude artifacts and extract structured rules into .claude/rules/<div style="margin-top: 12px;"><strong>Parameters</strong><table style="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Name</th><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Type</th><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Required</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>select</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>string</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Write only specific rules by number: "1,3,5". Default: all.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>keep-sources</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>boolean</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">optional</td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Write rules but skip source cleanup (Step 8)</td></tr></table></div><div style="margin-top: 12px;"><strong>Responses</strong><table style="margin-top: 6px; border-collapse: collapse; font-size: 0.9em; text-align: left;"><tr style="text-align: left; border-bottom: 1px solid var(--border);"><th style="padding: 4px 8px 4px 0; white-space: nowrap;">Status</th><th style="padding: 4px 8px 4px 0;">Description</th></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>success</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">Rules extracted, written, and sources cleaned up.</td></tr><tr style="border-bottom: 1px solid var(--border);"><td style="padding: 4px 8px 4px 0; vertical-align: top; white-space: nowrap;"><code>no-rules</code></td><td style="padding: 4px 8px 4px 0; vertical-align: top;">No extractable rules found in scanned sources.</td></tr></table></div><div style="margin-top: 12px;"><strong>Side Effects</strong><div style="margin-top: 4px; font-size: 0.9em;">Creates .claude/rules/ files and removes extracted content from source files</div></div><div style="margin-top: 12px;"><strong>Examples</strong><div style="margin-top: 6px; background: var(--bg-elevated); border-radius: 6px; padding: 8px 12px; font-family: monospace; font-size: 0.85em;"><div><code>/extract-rules</code> <span style="opacity: 0.6;">— Scan, propose, prompt for approval, write, and clean up</span></div><div><code>/extract-rules --keep-sources</code> <span style="opacity: 0.6;">— Write rules without modifying source files</span></div><div><code>/extract-rules --select 1,3</code> <span style="opacity: 0.6;">— Write only rules #1 and #3</span></div></div></div>',
@@ -1333,6 +1358,11 @@
                 desc: 'Placeholder — drop your project\'s custom subagent definitions in this directory.',
                 trigger: 'Background agent'
             },
+            'arcade-beeps-hook': {
+                title: 'arcade-beeps.js',
+                desc: 'arcade-beeps.js in hooks/',
+                trigger: 'PostToolUse hook'
+            },
             'feedback-rule-check-hook': {
                 title: 'feedback-rule-check.js',
                 desc: 'After FEEDBACK.md is edited, notifies Claude to evaluate',
@@ -1569,7 +1599,7 @@ CRITICAL: A plausible-looking cause from code reading is NOT confirmed evidence.
 
 > Run \`/autoconfig\` to populate this based on your project.`
             },
-                                                                                                                                                                                                                                                                                                                                                                                                            'autoconfig-update': {
+                                                                                                                                                                                                                                                                                                                                                                                                                        'autoconfig-update': {
                 filename: 'autoconfig-update.md',
                 content: `<!-- @applied
 -->
@@ -1656,6 +1686,32 @@ Use conventional commits: \`type(scope): description\`
 Types: feat, fix, docs, style, refactor, test, chore
 
 Keep the subject line under 50 chars. Add body if the change needs explanation.`
+            },
+            'disable-arcade-beeps': {
+                filename: 'disable-arcade-beeps.md',
+                content: `---
+description: Turn OFF Pole Position tab status beeps
+allowed-tools: Bash
+---
+
+Run exactly this command, then reply with a single confirmation line and nothing else:
+
+\`\`\`
+rm -f ~/.claude/sounds/arcade-beeps.enabled && echo "arcade beeps DISABLED."
+\`\`\``
+            },
+            'enable-arcade-beeps': {
+                filename: 'enable-arcade-beeps.md',
+                content: `---
+description: Turn ON Pole Position tab status beeps (awaiting = low tone, complete = high tone)
+allowed-tools: Bash
+---
+
+Run exactly this command, then reply with a single confirmation line and nothing else:
+
+\`\`\`
+mkdir -p ~/.claude/sounds && touch ~/.claude/sounds/arcade-beeps.enabled && echo "arcade beeps ENABLED (every turn-end beeps: awaiting=low, complete=high). Disable with /disable-arcade-beeps."
+\`\`\``
             },
             'extract-rules': {
                 filename: 'extract-rules.md',
@@ -1837,6 +1893,39 @@ claude-code-autoconfig ships this folder empty so you can populate it with agent
 
 See Anthropic's subagents docs for the file format:
 https://docs.anthropic.com/en/docs/claude-code/sub-agents`
+            },
+            'arcade-beeps-hook': {
+                filename: 'arcade-beeps.js',
+                content: `#!/usr/bin/env node
+/**
+ * arcade-beeps — optional Pole-Position status cues for the Claude Code tab.
+ * Companion to terminal-title.js. Registered (settings.json) on Stop + Notification.
+ *
+ * OFF unless the enable flag exists:  ~/.claude/sounds/arcade-beeps.enabled
+ *   toggle via  /enable-arcade-beeps   /disable-arcade-beeps
+ * The flag is GLOBAL (homedir), so one toggle covers every project you've installed into.
+ *
+ * Mapping (matches the ◐/✻ tab glyph that terminal-title.js paints on the SAME event):
+ *   Stop, turn ended on a question   -> ◐ awaiting  -> get-ready tick (pp3-getready-G4.wav, G4/384Hz)
+ *   Stop, turn ended normally         -> ✻ complete  -> GO beep        (pp3-go-F#5.wav, F#5/759Hz)
+ *   Notification (permission_prompt) -> ◐ awaiting  -> get-ready tick
+ *
+ * Tones are an extracted+smoothed take on the Pole Position race-start cue (arcade-ping
+ * envelope). LOWER tick = awaiting, HIGHER GO = complete.
+ *
+ * Assets resolve relative to THIS file (../sounds) so a per-project CCA install finds its own
+ * copy at <project>/.claude/sounds — no dependency on a global sounds dir.
+ *
+ * Playback is cross-platform and best-effort: PowerShell SoundPlayer on Windows, afplay on
+ * macOS, paplay||aplay on Linux. If none is present the hook simply stays silent — never errors.
+ *
+ * Playback BLOCKS (spawnSync) so the sound finishes inside the hook's lifetime — a detached
+ * fire-and-forget child can be killed by the hook runner's job/process-group cleanup before it
+ * plays. Blocking costs ~0.5s on turn-end but is reliable. Still fail-safe: wrapped so it never
+ * throws into the turn, and every path ends in exit(0).
+ *
+ * State detection reuses terminal-title.js's exported inspectLastResponse (lazy-required only
+ * when enabled) so sound and glyph agree. A tiny inline '?' check is the fallback.`
             },
             'feedback-rule-check-hook': {
                 filename: 'feedback-rule-check.js',
@@ -2082,6 +2171,10 @@ Claude reads this file but must never write to it. When Claude discovers project
           {
             "type": "command",
             "command": "node .claude/hooks/terminal-title.js"
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/arcade-beeps.js"
           }
         ]
       }
@@ -2093,6 +2186,10 @@ Claude reads this file but must never write to it. When Claude discovers project
           {
             "type": "command",
             "command": "node .claude/hooks/terminal-title.js"
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/arcade-beeps.js"
           }
         ]
       }

package/.claude/hooks/arcade-beeps.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+/**
+ * arcade-beeps — optional Pole-Position status cues for the Claude Code tab.
+ * Companion to terminal-title.js. Registered (settings.json) on Stop + Notification.
+ *
+ * OFF unless the enable flag exists:  ~/.claude/sounds/arcade-beeps.enabled
+ *   toggle via  /enable-arcade-beeps   /disable-arcade-beeps
+ * The flag is GLOBAL (homedir), so one toggle covers every project you've installed into.
+ *
+ * Mapping (matches the ◐/✻ tab glyph that terminal-title.js paints on the SAME event):
+ *   Stop, turn ended on a question   -> ◐ awaiting  -> get-ready tick (pp3-getready-G4.wav, G4/384Hz)
+ *   Stop, turn ended normally         -> ✻ complete  -> GO beep        (pp3-go-F#5.wav, F#5/759Hz)
+ *   Notification (permission_prompt) -> ◐ awaiting  -> get-ready tick
+ *
+ * Tones are an extracted+smoothed take on the Pole Position race-start cue (arcade-ping
+ * envelope). LOWER tick = awaiting, HIGHER GO = complete.
+ *
+ * Assets resolve relative to THIS file (../sounds) so a per-project CCA install finds its own
+ * copy at <project>/.claude/sounds — no dependency on a global sounds dir.
+ *
+ * Playback is cross-platform and best-effort: PowerShell SoundPlayer on Windows, afplay on
+ * macOS, paplay||aplay on Linux. If none is present the hook simply stays silent — never errors.
+ *
+ * Playback BLOCKS (spawnSync) so the sound finishes inside the hook's lifetime — a detached
+ * fire-and-forget child can be killed by the hook runner's job/process-group cleanup before it
+ * plays. Blocking costs ~0.5s on turn-end but is reliable. Still fail-safe: wrapped so it never
+ * throws into the turn, and every path ends in exit(0).
+ *
+ * State detection reuses terminal-title.js's exported inspectLastResponse (lazy-required only
+ * when enabled) so sound and glyph agree. A tiny inline '?' check is the fallback.
+ *
+ * Diagnostic log (bounded ~64KB) at ~/.claude/hooks/.titles/arcade-beeps.log records every
+ * invocation + choice, so we can prove whether the hook fires on a real Stop.
+ */
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const ASSET_DIR = path.join(__dirname, '..', 'sounds');           // wavs ship beside the hook
+const FLAG = path.join(os.homedir(), '.claude', 'sounds', 'arcade-beeps.enabled'); // global toggle
+const LOG = path.join(os.homedir(), '.claude', 'hooks', '.titles', 'arcade-beeps.log');
+const DEBUG = process.env.ARCADE_BEEPS_DEBUG === '1';
+
+function logLine(msg) {
+  try {
+    try { if (fs.statSync(LOG).size > 64 * 1024) fs.renameSync(LOG, `${LOG}.1`); } catch (_) { /* none yet */ }
+    fs.appendFileSync(LOG, `${new Date().toISOString()}  ${msg}\n`);
+  } catch (_) { /* logging must never throw */ }
+}
+
+function enabled() { try { return fs.existsSync(FLAG); } catch (_) { return false; } }
+function delay(ms) { return new Promise(r => setTimeout(r, ms)); }
+
+// Pick a blocking audio player for the current OS. Returns [cmd, args].
+function playerFor(wav) {
+  if (process.platform === 'win32') {
+    return ['powershell', ['-NoProfile', '-Command', `(New-Object Media.SoundPlayer '${wav}').PlaySync()`]];
+  }
+  if (process.platform === 'darwin') {
+    return ['afplay', [wav]];
+  }
+  // linux / other: prefer paplay (PulseAudio/PipeWire), fall back to aplay (ALSA)
+  return ['sh', ['-c', `paplay "${wav}" 2>/dev/null || aplay "${wav}" 2>/dev/null`]];
+}
+
+function play(wavName, why) {
+  if (DEBUG) process.stderr.write(`arcade-beeps: chose ${wavName} (${why})\n`);
+  logLine(`play ${wavName} (${why})`);
+  try {
+    const wav = path.join(ASSET_DIR, wavName);
+    if (!fs.existsSync(wav)) { logLine(`MISSING ${wav}`); return; }
+    // Block until the sound finishes so it can't be reaped with the hook process.
+    const [cmd, cmdArgs] = playerFor(wav);
+    spawnSync(cmd, cmdArgs, { stdio: 'ignore', windowsHide: true });
+  } catch (e) { logLine(`play-error ${e && e.message}`); }
+}
+
+// Fallback: does the last visible assistant text end on a question? (Mirrors terminal-title.js's regex.)
+function endsOnQuestionInline(transcriptPath) {
+  try {
+    const lines = fs.readFileSync(transcriptPath, 'utf8').split('\n');
+    for (let i = lines.length - 1; i >= 0; i--) {
+      const l = lines[i].trim(); if (!l) continue;
+      let o; try { o = JSON.parse(l); } catch (_) { continue; }
+      if (!o || o.type !== 'assistant' || !o.message) continue;
+      const c = o.message.content; let t = '';
+      if (typeof c === 'string') t = c;
+      else if (Array.isArray(c)) t = c.filter(b => b && b.type === 'text' && typeof b.text === 'string').map(b => b.text).join('\n');
+      if (t.trim()) return /\?[\s)*_"]*(\([^()]*\)[\s.*_"]*)?$/.test(t);
+    }
+  } catch (_) { /* ignore */ }
+  return false;
+}
+
+async function main(input) {
+  let data = {};
+  try { data = JSON.parse(input); } catch (_) { /* ignore */ }
+  const event = data.hook_event_name || '?';
+  const en = enabled();
+  logLine(`invoked event=${event} enabled=${en ? 1 : 0}`);
+  if (!en) return;                               // opt-in only
+
+  if (event === 'Notification') { play('pp3-getready-G4.wav', 'notification'); return; }
+  if (event !== 'Stop') return;
+
+  // awaiting (question) vs complete — same signals terminal-title.js uses, so the tone matches the glyph.
+  const sid = data.session_id || '';
+  const askFile = path.join(os.homedir(), '.claude', 'hooks', '.titles', `${sid}.ask`);
+  let pending = false;
+  try { pending = fs.existsSync(askFile); } catch (_) { /* ignore */ }
+
+  if (!pending) {
+    let inspect = null;
+    try { ({ inspectLastResponse: inspect } = require('./terminal-title.js')); } catch (_) { /* fallback below */ }
+    if (inspect) {
+      let q = inspect(data.transcript_path);
+      let n = 0;
+      while (!q.ends && (q.suspectRace || !q.found) && n < 5) { await delay(120); q = inspect(data.transcript_path); n++; }
+      pending = q.ends;
+    } else {
+      pending = endsOnQuestionInline(data.transcript_path);
+    }
+  }
+
+  play(pending ? 'pp3-getready-G4.wav' : 'pp3-go-F#5.wav', pending ? 'awaiting' : 'complete');
+}
+
+if (require.main === module) {
+  let input = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', c => (input += c));
+  process.stdin.on('end', async () => { try { await main(input); } catch (_) { /* ignore */ } process.exit(0); });
+}
+
+module.exports = { endsOnQuestionInline };

package/.claude/settings.json

@@ -42,6 +42,10 @@
           {
             "type": "command",
             "command": "node .claude/hooks/terminal-title.js"
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/arcade-beeps.js"
           }
         ]
       }
@@ -53,6 +57,10 @@
           {
             "type": "command",
             "command": "node .claude/hooks/terminal-title.js"
+          },
+          {
+            "type": "command",
+            "command": "node .claude/hooks/arcade-beeps.js"
           }
         ]
       }

package/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## v1.0.198
+- feat(arcade-beeps): ship opt-in Pole Position status beeps via CCA
+
 ## v1.0.197
 - perf(terminal-title): deliver the directive once per session; dedupe user/project hooks
 
@@ -145,6 +148,3 @@
 ## v1.0.149
 - style: consolidate inside-Claude message to two lines
 
-## v1.0.148
-- fix: refine inside-Claude error wording
-

package/README.md

@@ -61,7 +61,8 @@ your-project/
     ├── hooks/                         # Hook scripts
     │   ├── format.js                  #   Auto-format on Write/Edit
     │   ├── terminal-title.js          #   Use-case terminal tab titles + live state
-    │   └── terminal-title.directive.md # Injected title directive (tunable wording)
+    │   ├── terminal-title.directive.md # Injected title directive (tunable wording)
+    │   └── arcade-beeps.js            #   Optional Pole Position status beeps (opt-in)
     ├── docs/                          # Interactive documentation
     │   └── autoconfig.docs.html       #   Open with /show-docs
     ├── updates/                       # Pending config updates
@@ -70,6 +71,9 @@ your-project/
     │   └── readme-sync.md             #   Sync README & docs before publish
     ├── scripts/                       # Utility scripts
     │   └── sync-docs.js               #   Regenerate interactive HTML docs
+    ├── sounds/                        # Status-cue audio for arcade-beeps
+    │   ├── pp3-getready-G4.wav        #   Awaiting tone (get-ready tick)
+    │   └── pp3-go-F#5.wav             #   Complete tone (GO beep)
     ├── .mcp.json                      # MCP server configs (empty placeholder)
     └── settings.json                  # Permissions & security
 ```
@@ -110,6 +114,8 @@ Autoconfig is **self-configuring**. Run `/autoconfig` and Claude:
 | `/gls` | Views latest screenshot for visual context |
 | `/validate-cca-install` | Validates installation against latest published version |
 | `/extract-rules` | Scan Claude artifacts and extract structured rules |
+| `/enable-arcade-beeps` | Turn on opt-in Pole Position status beeps |
+| `/disable-arcade-beeps` | Turn off the status beeps |
 
 ### Updates
 
@@ -135,6 +141,10 @@ Autoconfig writes a debug methodology to Claude's persistent memory (`MEMORY.md`
 
 Run several Claude Code sessions at once and the tabs all look alike. Autoconfig retitles each tab as `{scope} — {what you're working on}` with a live state indicator — ⬤ working, ◐ waiting on you, ✻ idle — so you can tell sessions apart at a glance. Claude updates the title itself as the work shifts; nothing to configure.
 
+### Status Beeps (opt-in)
+
+Prefer your ears to your eyes? Run `/enable-arcade-beeps` for Pole Position–style tab cues that mirror the title glyph: a low get-ready tick when a session is **waiting on you** and a higher GO tone when it **finishes**. Cross-platform (Windows / macOS / Linux) and off by default — toggle back off any time with `/disable-arcade-beeps`.
+
 ### Team Feedback
 
 When Claude makes a mistake, add an entry to `.claude/feedback/FEEDBACK.md`:

package/bin/cli.js

@@ -27,7 +27,7 @@ const WINDOWS_RESERVED = ['CON', 'PRN', 'AUX', 'NUL', 'COM1', 'COM2', 'COM3', 'C
   'LPT6', 'LPT7', 'LPT8', 'LPT9'];
 
 // Files/folders installed by autoconfig - don't backup these
-const AUTOCONFIG_FILES = ['commands', 'docs', 'agents', 'migration', 'hooks', 'scripts', 'rules', 'feedback', 'settings.json', 'settings.local.json', '.mcp.json', '.autoconfig-version', '.autoconfig-plugins.json'];
+const AUTOCONFIG_FILES = ['commands', 'docs', 'agents', 'migration', 'hooks', 'scripts', 'sounds', 'rules', 'feedback', 'settings.json', 'settings.local.json', '.mcp.json', '.autoconfig-version', '.autoconfig-plugins.json'];
 
 function isReservedName(name) {
   const baseName = name.replace(/\.[^.]*$/, '').toUpperCase();
@@ -775,7 +775,7 @@ if (fs.existsSync(feedbackSrc)) {
 // (copyDirIfMissing), BUT the cca-managed title-hook files are ALWAYS refreshed so bug-fixes
 // reach existing installs — without this, copyDirIfMissing leaves stale hooks in place forever
 // (same always-overwrite rationale as scripts/ below). --force already overwrites everything.
-const MANAGED_HOOKS = ['terminal-title.js', 'terminal-title.directive.md'];
+const MANAGED_HOOKS = ['terminal-title.js', 'terminal-title.directive.md', 'arcade-beeps.js'];
 if (fs.existsSync(hooksSrc)) {
   const copyFn = forceMode ? copyDir : copyDirIfMissing;
   copyFn(hooksSrc, path.join(claudeDest, 'hooks'));
@@ -793,6 +793,12 @@ if (fs.existsSync(scriptsSrc)) {
   copyDir(scriptsSrc, path.join(claudeDest, 'scripts'));
 }
 
+// Copy sounds directory (binary status-cue assets for arcade-beeps; always overwrite)
+const soundsSrc = path.join(packageDir, '.claude', 'sounds');
+if (fs.existsSync(soundsSrc)) {
+  copyDir(soundsSrc, path.join(claudeDest, 'sounds'));
+}
+
 // Note: updates directory is no longer copied to user projects.
 // Update files are only used by --pull-updates (for /autoconfig-update).
 // On fresh install, all updates are pre-marked as applied and the content

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-autoconfig",
-  "version": "1.0.197",
+  "version": "1.0.198",
   "description": "Intelligent, self-configuring setup for Claude Code. One command analyzes your project, configures Claude, and shows you what it did.",
   "author": "ADAC 1001 <info@adac1001.com>",
   "license": "MIT",