Desenvolvedores
Dite o prompt.Digite o código.
O teclado não deixou de importar. O que mudou foi o que passa por ele. Um desenvolvedor trabalhando com um agente de código digita hoje mais texto do que código em um dia, e texto é a parte que a voz faz mais rápido.
A resposta curta
Sim, ditado vale a pena para quem programa, e não é para o código. É para a prosa em volta do código, que hoje é a maior parte do dia: o prompt para o agente, a descrição do pull request, a mensagem de commit, o comentário na issue, a resposta no Slack. Dite tudo o que tiver mais de uma linha e continue digitando identificadores, caminhos e comandos. Os nomes de função ditos em voz alta voltam como palavras comuns, e o agente que lê quase sempre entende qual era a função.
Onde a voz ganha
Cinco coisas que você escreve todo dia, e de que lado da linha cada uma fica.
Digitar é barato para uma linha e caro para um parágrafo, então uma mensagem digitada sai curta, fosse curto o tamanho certo ou não. Falar é barato para um parágrafo. Essa diferença decide todas as linhas abaixo.
| O texto | Digitado, normalmente | Ditado |
|---|---|---|
| Um prompt para um agente de código | Três linhas secas, porque digitar um parágrafo dá trabalho. O agente preenche os buracos com chutes, e os três turnos seguintes vão para corrigir os chutes. | Quarenta segundos de contexto: o que você já tentou, o que viu, o que não pode mudar. Um prompt melhor de graça, porque falar é mais fácil do que digitar. |
| A descrição de um pull request | O título, e "ver commits". | Por que a mudança existe, o que mudou e por onde começar a ler. Dito uma vez, em menos tempo do que o revisor gasta no diff. |
| Uma mensagem de commit | "fix", "wip", "ajustes". | A frase que você diria para o colega do lado, que é o que uma mensagem de commit sempre deveria ter sido. |
| Um bug report ou um comentário na issue | Mais curto do que o problema. Os passos para reproduzir são a parte que fica de fora. | Passos, esperado, obtido, enquanto ainda está fresco. A parte que ficava de fora é a parte que vale a pena ter. |
| O código em si | Sim. | Não. Sintaxe, identificadores e caminhos se digitam. Ferramentas de ditado são ferramentas de prosa, e esta página fala isso com clareza porque a ferramenta que ela vende é uma delas. |
A linha não fica entre trabalho e conversa. Fica entre texto que tem sintaxe e texto que não tem. Um prompt não tem, então se dita. Um caminho tem, então se digita.
A lista real
O que dá errado de verdade quando um desenvolvedor dita.
Os identificadores voltam como palavras
Você fala getUserById e a transcrição lê "get user by ID". O snake case perde os underscores, um caminho de arquivo perde as barras, e uma sigla que ninguém fora do seu time publicou perde para a palavra comum que soar mais parecida. Reconhecer é prever, e um nome que o modelo nunca viu não tem nada segurando ele.
Símbolos se falam, não se digitam
Pontuação falada funciona: ponto, vírgula, novo parágrafo. Uma flag de comando falada não. Fale "dash dash force" e você recebe essas três palavras, porque não existe gramática de ditado para código e nenhuma empresa pequena vai inventar uma. Tudo o que tem sintaxe pertence ao teclado.
A ferramenta fixa um idioma e a sua frase tem dois
A frase técnica de quem programa no Brasil já é bilíngue, e vai além do substantivo emprestado: commitei, deployei, buildar, mergear são verbos de verdade no dia a dia. Uma ferramenta que decide o idioma por ditado empurra a metade minoritária para a majoritária, e o passo de limpeza que "corrige" esses verbos para um português de dicionário estraga a frase duas vezes. O sotaque nunca foi o problema.
O passo de limpeza arruma as coisas erradas
Tudo o que transforma uma transcrição crua em texto limpo é um modelo de linguagem, e um modelo de linguagem com liberdade para reescrever expande "repo" para "repositório", formaliza o verbo que você inventou e transforma uma nota rápida para um agente em um memorando. Prosa técnica só sobrevive a um passo de limpeza que esteja proibido de mexer nas suas palavras.
Os dois primeiros pertencem ao modelo de voz e à falta de uma gramática para código. Nenhum aplicativo pequeno muda isso. Os dois últimos são decisões de produto, e são os que valem na hora de escolher.
A solução
Como ditar para um agente de código.
Cinco hábitos, cinco minutos, em qualquer ferramenta de ditado. Nenhum pede para você falar código. Eles colocam a linha no lugar certo e deixam o agente fazer a parte que um modelo de voz não consegue.
- 01
Coloque a linha na caixa do prompt
Dite na caixa do agente, no formulário do pull request, na mensagem de commit, na issue, no Slack. Digite no editor. Suas mãos estão no teclado de qualquer jeito, então o identificador não custa nada para digitar e custa muito para falar.
- 02
Descreva o símbolo em vez de soletrar
Fale "a função que carrega o usuário a partir da sessão", não "get user by ID". Um agente de código liga uma descrição ao símbolo certo com muito mais confiança do que um modelo de voz liga um som a camel case. A coisa em que o ditado é pior é a coisa em que o agente é melhor.
- 03
Fale a forma em voz alta
"Novo parágrafo", depois "primeiro, segundo, terceiro". Um bom passo de limpeza transforma uma enumeração falada em lista e uma mudança de assunto em parágrafo, e um prompt com estrutura recebe uma resposta melhor do que as mesmas palavras em um bloco só.
- 04
Se corrija em voz alta e siga em frente
"O vermelho, quer dizer, o azul." "Esquece isso." Um passo de limpeza que resolve correções faladas fica só com a versão que você queria. Parar para apagar é o hábito que faz o ditado parecer lento, e é um hábito de teclado, não de fala.
- 05
Corrija os três nomes no final e envie
Deixe os identificadores saírem errados enquanto você fala. Quando a transcrição chega, a hesitação e os começos falsos já se foram, então só sobram dois ou três nomes para ajustar. Trinta segundos, e o prompt continua três vezes mais longo do que o que você teria digitado.
Se depois do quinto passo o resultado ainda parece uma transcrição, o problema é o passo de limpeza da ferramenta, e essa é a única coisa desta lista que nenhum hábito resolve.
O que construímos
Segure uma tecla, fale com o agente.
O Sonira cola onde está o cursor. Essa é a integração inteira: o terminal rodando o Claude Code, o painel de chat do Cursor, a caixa do pull request no GitHub, o editor da mensagem de commit, o Slack. Não existe lista de aplicativos suportados nem plugin para instalar, porque colar é a única coisa que todo aplicativo já aceita.
O passo que limpa a transcrição foi escrito para fazer uma lista curta de coisas e parar. Pontuação. Muletas e começos falsos fora. "Esquece isso" e "quer dizer" resolvidos para a versão que você queria. "Novo parágrafo" e uma enumeração falada viram parágrafo e lista. Nada traduzido, nada reescrito, nada formalizado, então "repo" continua "repo", "commitei" continua "commitei", e uma frase com dois idiomas fica com os dois.
O que ele não faz: ainda não existe vocabulário próprio, então um identificador sai como palavras na primeira vez e você corrige na mão. Não existe modo de código e não vai existir. E a leitura em voz alta lê uma seleção de texto real, então um painel de terminal que desenha a própria seleção, o Claude Code dentro do tmux por exemplo, não dá nada para ela ler.
Nota honesta: a versão que está neste site é a atual. A leitura em voz alta está lá.
Segurar uma tecla. Falar. As palavras aparecem onde está o cursor.
O agente é o corretor
A falha mais antiga do ditado encontrou o único leitor que não se importa.
Reconhecimento de voz sempre perdeu nos nomes, e por vinte anos a solução foi parar e digitar. Um agente de código muda a conta. Ele lê "get user by ID" contra o código e acha getUserById, porque ligar uma descrição solta a um símbolo exato é o trabalho dele. A palavra errada deixa de ser erro e vira uma busca.
O que o agente não consegue consertar é um prompt magro. Ele só trabalha com o contexto que você deu, e contexto digitado é magro porque digitar dá trabalho. O ditado engorda o prompt de graça. Esse é o argumento inteiro para ditar para um agente, e não tem nada a ver com o código.
Revisar de ouvido
Uma resposta longa de um agente é uma parede de prosa plausível, e plausível é exatamente o que o olho pula. Selecione no navegador ou no editor e mande ler em voz alta. O passo errado que você deixaria passar lendo costuma soar errado, e é uma das razões de termos construído voz para fora além de voz para dentro.
Bom saber
Perguntas, respondidas.
- 01Dá para escrever código por voz?
- Não com um aplicativo de ditado, e não bem com nada mais. Ditado é para prosa: o prompt, o pull request, a mensagem de commit, a issue, a mensagem para um colega. Código tem sintaxe e um modelo de voz não tem gramática para ela. Coloque a linha aí e o ditado para de decepcionar.
- 02Funciona dentro do terminal?
- Sim, se a ferramenta colar no cursor em vez de digitar em um aplicativo específico. O Sonira cola, então o Terminal, o iTerm e o prompt de um agente de código rodando dentro deles recebem o texto. Um ditado longo chega como uma colagem só, que algumas ferramentas de terminal mostram como um bloco colado até você enviar.
- 03Ele vai acertar os nomes das minhas funções?
- Na primeira vez, não. Um nome que o modelo nunca viu volta como as palavras comuns mais próximas, e o Sonira ainda não tem vocabulário próprio. Descreva a função em vez de nomear e deixe o agente resolver, ou ajuste os dois ou três nomes depois que a transcrição chegar.
- 04Eu falo "commitei" e "deployar". Isso quebra alguma coisa?
- Só em uma ferramenta que fixa um idioma por ditado ou que formaliza o que você disse. O Sonira não fixa nada e o passo de limpeza é proibido de mudar o seu registro, então "commitei", "deployar" e "fazer o merge" ficam exatamente como você falou. Tem um guia separado sobre frases que carregam dois idiomas.
- 05Ele reescreve o meu prompt no caminho?
- Não. O passo de limpeza é proibido por escrito de traduzir, reescrever ou formalizar. Ele tira hesitação e começos falsos, resolve correções faladas, aplica a formatação ditada, e para. Um prompt sai do jeito que você falou, com pontuação.
- 06Por que não o ditado grátis que já vem no Mac?
- Teste ele primeiro. É grátis e para uma mensagem curta dá conta. Transcrição crua imprime a sua hesitação, e um prompt de quarenta segundos tem muita. Um passo de limpeza que tira as muletas sem tocar nas palavras é a diferença entre uma transcrição e uma mensagem, e é a principal coisa que uma ferramenta paga acrescenta.
Dite o prompt. Digite o código.
Grátis enquanto estamos em beta.
Quando a própria frase carrega dois idiomas
Dita em inglês com sotaque? Leia o guia do sotaque.
Nunca ditou? Comece pelo guia do Mac.