피드로 돌아가기
Dev.toDevOps
원문 읽기
Lifecycle Hooks와 OS TTS 연동을 통한 Agent 비동기 상태 알림 시스템 구축
Text-to-Speech for Claude Code — Hear What the Agent Is Doing
AI 요약
Context
Claude Code Agent의 장기 실행 작업 시 터미널 상시 모니터링에 따른 생산성 저하 발생. Agent의 작업 완료 및 의사결정 요청 시점을 실시간으로 인지하기 위한 오디오 피드백 인터페이스 부재.
Technical Solution
- Lifecycle Event 기반의 Hook 아키텍처를 활용한 이벤트 드리븐 알림 체계 설계
- Notification Hook을 통한 JSON 페이로드의 message 필드 추출 및 OS 수준의 TTS(say, spd-say) 파이프라인 연결
- Stop Hook을 통한 JSONL 형식의 Transcript 파일에서 최신 Assistant 텍스트 블록을 필터링하는 jq 쿼리 최적화
- 과도한 음성 출력을 방지하기 위한 head -c 600 기반의 텍스트 길이 제한(Length Capping) 적용
- 로컬 스피커와 Slack 오디오 파일 업로드를 분리한 다중 엔드포인트 알림 라우팅 구조 설계
- Markdown 및 Code Block 등 오디오 노이즈를 제거하기 위한 텍스트 전처리 필터링 전략 채택
실천 포인트
- CLI 도구의 Lifecycle Hook을 활용하여 외부 알림 시스템(TTS, Messanger)과 연동하는 이벤트 파이프라인 구축 검토 - JSONL 등 대용량 로그 파일에서 최신 상태값만 추출하기 위한 효율적인 jq 필터링 패턴 적용 - TTS 시스템 도입 시 텍스트 길이 제한 및 특수문자(Markdown) 제거 전처리 단계 필수 포함