Assistant · para Mac · código aberto

Fale com o Claude Code. Ele responde falando.

Diga o nome dele e peça em voz alta. O Assistant escuta com um Whisper no seu Mac, passa o pedido para uma sessão do Claude Code aberta o dia todo e lê a resposta frase por frase, enquanto ela chega. Dá para trabalhar longe do teclado.

Grátis, sem conta e com licença MIT. Precisa do Claude Code com login. Mac com Apple Silicon e macOS 14 ou mais novo.

O painel do Assistant: o estado "Falando", uma fala ignorada, um pedido sobre os testes, a ferramenta usada, a resposta, o custo e um pedido de confirmação antes do push
O painel em localhost:4780, com uma conversa de exemplo.
O que vem no app

Uma conversa, não um ditado.

Ditado vira texto. O Assistant entende quando é com ele, faz o trabalho no seu repositório e conta o que fez.

0segundos de áudio que saem do MacA sua voz vira texto num Whisper local. Só o texto do pedido vai para o Claude Code.
6ações que esperam o seu simPush, deploy, publicar, mandar mensagem a alguém, apagar e pagar. Ler e editar arquivos locais ele faz sem perguntar.
60 spara responder sem dizer o nomeDepois que ele termina de falar, a conversa continua aberta por um minuto.
1sessão do Claude Code o dia inteiroNo mesmo dia, a mesma sessão: ela volta depois de reiniciar, e um diário curto liga um dia ao outro.
Como funciona

Diga o nome. Peça. Ouça.

Chame pelo nome

"Assistant, qual é o status do deploy?" Ou diga só "Assistant": ele toca um som e espera o pedido por 8 segundos.

Ele trabalha

Antes de usar uma ferramenta, diz o que vai fazer. Lê, procura e edita os arquivos da pasta que você escolheu, com as pastas extras que você liberar.

Ele responde falando

A resposta é falada frase por frase, enquanto chega. Diga "Assistant" no meio e ele para na hora para escutar.

O nome, as pastas, o microfone, a voz e o modelo ficam num arquivo de configuração seu, fora do código.

O que vem junto

Feito para conversar o dia inteiro.

É para mim?

Sabe quando não é com ele

Sem o nome, um modelo pequeno lê a frase e as últimas trocas e decide se você falava com ele. Não sendo, a frase vai para um rascunho: diga "pode fazer" para executar.

Interromper

Fale por cima dele

Com o app aberto, o macOS tira a voz do próprio assistente do microfone. Dá para interromper com o som saindo pelo alto-falante.

Voz

A voz que você escolher

Com uma chave da Fish Audio, cada frase sai na voz que você configurar, sintetizada à frente da que está tocando. Sem chave, fala a voz do próprio Mac.

Painel

Veja o que ele ouviu

Em localhost:4780: o que ele ouviu e o que ignorou (e por quê), as ferramentas que usou e quanto custou cada resposta. Dá para escrever em vez de falar.

Resumo falado

Voz também no Claude Code de sempre

Um hook opcional fala o resumo do fim de cada tarefa nas suas sessões comuns do Claude Code, quando a resposta traz o marcador.

Barra de menus

Sempre a um clique

O Assistant mora na barra de menus, com os ajustes de microfone, Whisper, voz, modelo, pastas e confirmações, que valem na hora.

Privacidade

O que o Assistant ouve. E o que ele manda.

Um assistente de voz escuta o tempo todo. Você tem o direito de saber o que sai do seu Mac.

O que sai, e para onde

  • O texto dos seus pedidos e os arquivos que o Claude Code lê vão para a Anthropic, pelo seu próprio Claude Code.
  • O texto de cada frase falada vai para a Fish Audio, só se você configurar a voz da Fish.
  • O microfone é a única permissão que o macOS pede.

O que fica no Mac

  • A sua voz: o áudio vira texto num Whisper local e não é enviado a ninguém.
  • As gravações, as transcrições, o histórico, o diário e a sessão, numa pasta do seu usuário.
  • O que ele ouviu e ignorou: aparece no painel e não vai para lugar nenhum.
Perguntas

Antes de instalar.

O que eu preciso ter instalado?

O Claude Code, com login feito, e três ferramentas pelo Homebrew: brew install sox whisper-cpp ffmpeg. O modelo do Whisper baixa com um script do repositório. Na primeira abertura, libere o microfone.

Quanto custa?

O app é grátis. Os pedidos usam o seu Claude Code, e o painel mostra quanto custou cada resposta. A voz da Fish Audio é opcional e usa a sua conta da Fish; sem ela, fala a voz do Mac.

Ele faz coisas sem eu pedir?

Ler, procurar e editar arquivos locais, sim, e ele diz antes o que vai fazer. Push, deploy, publicar, mandar mensagem a alguém, apagar e pagar esperam o seu sim falado naquela conversa. A lista é sua para mudar nos ajustes.

Funciona em inglês?

Ainda não de verdade: os prompts, as regras de fala e a interface estão em português. O idioma do Whisper é configurável.

O macOS vai bloquear o app?

Não. O Assistant é assinado com o Developer ID de Ciro Cesar Maciel e notarizado pela Apple: o .dmg baixado pelo navegador abre sem aviso.

Dá para ver o código?

Dá. O app inteiro é código aberto, licença MIT, em github.com/ciro-maciel/voice-assistant.

O que ele ainda não faz?

Não abre sozinho no login, e um modelo só conversa e trabalha: numa tarefa longa, ele diz o que vai fazer e fica em silêncio até terminar.

Baixar

Instale, chame pelo nome e converse.

Sempre a versão mais recente. Mac com Apple Silicon (M1 ou mais novo) e macOS 14 ou mais novo, com o Claude Code e as ferramentas do Homebrew.

O jeito mais rápido: uma linha no Terminal
curl -fsSL https://blob.ciromaciel.click/tools/voice-assistant/install.sh | bash

Baixa a versão mais recente, instala em Aplicativos e abre o Assistant. Rode de novo quando quiser atualizar. O .dmg do botão também abre sem aviso: o app é assinado e notarizado pela Apple.

Ciro Cesar Maciel

Quem faz

Feito por quem usa todo dia.

Faço software há mais de vinte anos. Hoje construo os blocos que uma ideia precisa para existir de verdade.

Uso todo dia as ferramentas que construo. Se quebrar para você, quebrou para mim antes.

Ciro Cesar Maciel

Cartas do Ciro

O que estou construindo e aprendendo, por e-mail. Você só começa a receber depois de confirmar pelo e-mail que chega na hora.

Toda carta traz o link para sair na hora. Política de privacidade.

Ciro Cesar Maciel

Construir é de todos. As ferramentas e o saber é que não eram.