GUIA

Texto para fala no Codex, no Cursor e no VS Code

Agentes de código trabalham por minutos, e um aviso falado avisa quando terminam sem você olhar para a tela. Alguns editores também leem as respostas em voz alta.

Este guia cobre VS Code, Codex CLI e Cursor, com uma voz grátis e offline feita pelo motor SuperClonica.

Gere a voz uma vez

Instale o motor grátis (python -m pip install superclonica-cpu) e gere um clipe curto com qualquer uma das cerca de 190 vozes: superclonica --text "Done!" --voice F2 --lang en --output done.wav. Coloque-o numa pasta sounds no seu diretório pessoal. Os exemplos tocam com afplay no macOS; no Linux use paplay e, no Windows, um pequeno script que toque o arquivo WAV.

VS Code: ler as respostas do chat

Com a extensão VS Code Speech, cada resposta do chat tem um ícone de alto-falante que a lê em voz alta, e Esc interrompe. A configuração accessibility.voice.autoSynthesize (desligada por padrão) lê as respostas sozinha quando você perguntou por voz. Versões recentes também têm um Voice Mode experimental (agents.voice.enabled) que lê as respostas do agente e escuta os pedidos seguintes.

Codex CLI: um som ao fim de cada turno

O Codex roda o programa indicado em notify no ~/.codex/config.toml quando um turno termina; a configuração é ignorada no config do próprio projeto. O Codex acrescenta um argumento JSON, então chame o player por um shell: notify = ["sh", "-c", "afplay $HOME/sounds/done.wav", "codex"]. O JSON traz last-assistant-message, então um pequeno script também pode narrar a própria resposta com o motor e tocá-la.

Cursor: um hook stop

O Cursor lê hooks de ~/.cursor/hooks.json (ou .cursor/hooks.json num projeto). O evento stop dispara quando o agente termina, com o status completed, aborted ou error na entrada padrão: {"version": 1, "hooks": {"stop": [{"command": "afplay ~/sounds/done.wav"}]}}. Um script pode conferir o status e tocar outro clipe em caso de erro.

Narrar texto sob pedido com MCP

Para um agente narrar texto com voz de personagem ou de narrador quando você pedir, conecte o servidor MCP da SuperClonica em https://superclonica.com/mcp com uma chave de API grátis. Ele funciona no VS Code, no Cursor e no Claude Code e devolve um link para o arquivo de áudio.