CLI e integracao com agentes

O Local Transcriber inclui uma ferramenta CLI e uma skill para agentes de IA de programacao como Claude Code e pi. Voce pode instalar ambos com um unico comando de menu.

Instalacao

Na barra de menus do app, va em Transcriber → Instalar CLI e skill do agente…

Essa operacao faz duas coisas:

1. CLI — cria um link simbolico de transcriber em /usr/local/bin/ (senha de administrador necessaria).
2. Skill do agente — copia o arquivo de skill para ~/.pi/agent/skills/transcriber/ e ~/.claude/skills/transcriber/.

Apos a instalacao, abra um novo terminal e execute:

transcriber help

Comandos CLI

transcriber start

Inicia uma nova gravacao. Abre o app se nao estiver em execucao.

transcriber start
# ✅ Recording started
# {"recording": true, "status": "Transcribing…", ...}

transcriber stop

Para a gravacao em andamento e inicia o pos-processamento.

transcriber stop
# ⏹  Recording stopped
# {"recording": false, "status": "Processing…", ...}

transcriber toggle

Alterna a gravacao entre ativa e inativa.

transcriber toggle

transcriber status

Mostra o status atual em formato JSON. Funciona tanto durante uma gravacao quanto em repouso.

transcriber status
# {
#   "recording": true,
#   "status": "Transcribing…",
#   "duration": "05:32",
#   "segments": 24,
#   "file": "/Users/you/Documents/MeetingTranscripts/2026-04-03-1400.md",
#   "partial": "and then we should probably…",
#   "updated_at": "2026-04-03T14:05:32Z"
# }

Campos:

Campo	Descricao
recording	Se uma gravacao esta ativa
status	Status atual: Ready, Transcribing…, Processing…, Loading models…
duration	Duracao da sessao no formato MM:SS
segments	Numero de segmentos de transcricao confirmados
file	Caminho do arquivo de transcricao .md atual
partial	Texto parcial nao confirmado (ao vivo, ainda nao finalizado)
updated_at	Timestamp ISO 8601 da ultima atualizacao de status

transcriber transcript

Imprime o arquivo de transcricao atual ou mais recente no stdout.

transcriber transcript

transcriber tail

Acompanha o arquivo de transcricao atual — mostra atualizacoes ao vivo conforme novos segmentos sao confirmados.

transcriber tail
# Tailing: /Users/you/Documents/MeetingTranscripts/2026-04-03-1400.md
# (novas linhas aparecem durante a reuniao)

transcriber open

Abre a janela do app Local Transcriber.

transcriber open

Esquema de URL

Voce tambem pode controlar o app por meio de um esquema de URL, util para atalhos, ferramentas de automacao ou scripts:

open transcriber://start    # Iniciar a gravacao
open transcriber://stop     # Parar a gravacao
open transcriber://toggle   # Alternar gravacao ativa/inativa
open transcriber://pause    # Pausar a gravacao ativa
open transcriber://resume   # Retomar a gravacao pausada

Nota: pause e resume estao disponiveis apenas pelo esquema de URL, nao pelo CLI.

Reprocessar uma gravacao

Reexecute o pos-processamento (transcricao aprimorada + diarizacao de falantes) em uma gravacao existente:

open "transcriber://reprocess?file=2026-04-03-1400"

O parametro file e o nome base do arquivo (sem extensao) da pasta de transcricoes.

Skill do agente

Apos a instalacao, agentes de IA que suportam skills (Claude Code, pi) sabem automaticamente como controlar o Local Transcriber. A skill ensina a eles como:

• Iniciar e parar gravacoes
• Verificar o status da gravacao
• Ler a transcricao ao vivo ou finalizada
• Reprocessar gravacoes existentes
• Encontrar e pesquisar arquivos de transcricao

Seu agente le a transcricao diretamente do disco — sem chave de API, sem nuvem, sem copiar e colar.

Exemplo: Claude Code

> comece a gravar minha reuniao

✅ Gravacao iniciada.

> o que foi discutido ate agora?

Pela transcricao ao vivo, a equipe discutiu…

> pare a gravacao e faca um resumo

⏹ Gravacao encerrada. Aqui esta um resumo…

Arquivo de status

O app escreve seu status atual em ~/.transcriber/status.json a cada mudanca. O CLI le esse arquivo, e seus scripts tambem podem fazer o mesmo:

cat ~/.transcriber/status.json | python3 -c "
import json, sys
d = json.load(sys.stdin)
print('Gravando' if d['recording'] else 'Inativo')
"

Log do motor

Para depuracao, acompanhe o log do motor:

tail -f ~/.transcriber/engine.log