NotificationSubagentStart

Subagent start voice announcement

Announces out loud via TTS when a subagent starts, to track parallel agent activity.

Use cases

Audio traceability of parallel agents
Track subagent startup without a visual interface

Providers & tags

Claude Code

#tts#subagent#voice#parallel-agents#audio

settings.json fragment

{
  "hooks": {
    "SubagentStart": [
      {
        "hooks": [
          {
            "command": "node $CLAUDE_PROJECT_DIR/.claude/hooks/subagent-start-tts.mjs",
            "type": "command"
          }
        ],
        "matcher": ""
      }
    ]
  }
}

Script · .claude/hooks/subagent-start-tts.mjs

#!/usr/bin/env node
// Annonce le démarrage d'un sous-agent par TTS (SubagentStart)
import { execSync } from 'child_process';
import { fileURLToPath } from 'url';

function defaultExec(cmd) {
  execSync(cmd, { timeout: 10_000, stdio: 'ignore', shell: true });
}

export function run({ exec = defaultExec, platform = process.platform } = {}) {
  const text = 'Sous-agent démarré';
  try {
    if (platform === 'darwin') exec(`say "${text}"`);
    else exec(`espeak "${text}" 2>/dev/null || spd-say "${text}"`);
  } catch {}
  return text;
}

/* v8 ignore next 3 */
if (process.argv[1] === fileURLToPath(import.meta.url)) {
  run();
}