Prosey

Prosey é uma ferramenta CLI para baixar e exibir transcrições de vídeos do YouTube, para que você possa obter as informações que procura sem perder horas.

Os principais casos de uso são:

• Resumir um vídeo do YouTube e exibi-lo na CLI com um único comando (mais rápido).
• Ler as legendas do vídeo, formatadas e organizadas em capítulos como no vídeo original (geralmente requer mais tempo).

Ambos os usos precisam de um assistente de IA no seu sistema (padrão: opencode, use prosey config para configurar o seu próprio).

Se detectarmos um realçador de sintaxe no seu sistema, você obterá uma saída colorida agradável.

O Prosey também pode exibir ou armazenar o formato json nativo literalmente.

Recursos

Recurso	Descrição
💡  Resumir	Busca e resume a transcrição de um vídeo
📖  Ler	Busca e exibe a transcrição formatada em Markdown
💬  Copiar	Copia um resumo para a área de transferência, pronto para colar em um chat web
📋  Download da transcrição	Busca transcrições do YouTube como texto simples ou JSON literal
🤖  Sumarização por IA	Envia transcrições para qualquer agente de IA (opencode, Claude, Copilot, Codex)
🎨  Paginador inteligente	Realce de sintaxe automático se bat, glow ou mdcat estiverem instalados (ou configure seu próprio paginador)
🛠️  Personalização	Use prosey config para acessar e editar sua configuração / personalizar os prompts
💾  Cache em disco	Transcrições e resumos são armazenados em cache no disco para releitura instantânea
📄  Formatos suportados	Texto simples e JSON

Início rápido

Experimente imediatamente com npx:

npx @tacone/prosey 771PQEDeRmw
npx @tacone/prosey https://youtu.be/771PQEDeRmw --lang es -o transcript.txt

Instalação

Instale globalmente com seu gerenciador de pacotes favorito:

npm install -g @tacone/prosey
# or
yarn global add @tacone/prosey
# or
pnpm add -g @tacone/prosey
# or
bun install -g @tacone/prosey

Em seguida, use-o em qualquer lugar:

prosey 771PQEDeRmw

A partir do código-fonte

Utiliza Bun para desenvolvimento — scripts, gerenciamento de pacotes, e execução direta do código-fonte TypeScript.

git clone https://github.com/tacone/prosey.git
cd prosey
bun install
bun run start -- 771PQEDeRmw

Uso

prosey [options] <video controls-url-or-id>
prosey read [options] <video controls-url-or-id>
prosey info [options] <video controls-url-or-id>
prosey summarize [options] <video controls-url-or-id>
prosey copy [--question <text>] <folder>
prosey index
prosey render
prosey config
prosey help

summarize é o comando padrão, portanto prosey <id> executa o resumidor de IA. Use prosey read <id> para baixar e imprimir uma transcrição com formatação detalhada.

O comando summarize obtém uma transcrição, adiciona o prompt da seção de configuração [summarize] no início e encaminha o resultado para o comando de IA configurado.

O comando read baixa a transcrição e a imprime em stdout (texto simples, markdown ou JSON). Isso é útil quando você não precisa de processamento de IA.

O comando info mostra os metadados do vídeo (título, canal, duração, visualizações).

O comando index reconstrói o índice de documentos e o abre no navegador. O índice lista todos os resumos e transcrições armazenados no diretório de dados e é reconstruído automaticamente após cada execução de summarize/transcribe. Clicar no logotipo do Prosey em qualquer página de conteúdo navega de volta para ele.

O comando render regenera todas as páginas HTML a partir do markdown em cache (sem rede nem processamento de IA) e reescreve o índice.

O comando copy copia o resumo de um documento para a área de transferência, pronto para ser colado em um chat web. Ele recebe o nome da pasta impresso no final da última execução (ou um caminho completo); --question acrescenta sua pergunta após o resumo, separada por duas linhas em branco. Apenas resumos podem ser copiados — uma pasta somente com transcrição é um erro.

As páginas de resumo trazem um link Copy na linha de metadados, à direita do tempo de leitura: ele coloca o resumo na área de transferência, pronto para colar em um chat web.

O comando config abre seu arquivo de configuração em $EDITOR para edição. Quando não há um terminal ao qual se conectar — $EDITOR não está definido, ou stdout/stdin está em pipe — o caminho do arquivo de configuração é impresso.

O comando help mostra a mensagem de ajuda, o mesmo que --help.

Exemplos

# Summarize (AI summary + formatting + syntax highlighting)
prosey 771PQEDeRmw

# Summarize (same as above)
prosey summarize 771PQEDeRmw

# Transcribe (AI summary + formatting + syntax highlighting)
prosey read 771PQEDeRmw

# Show video metadata
prosey info 771PQEDeRmw

# Edit config in $EDITOR
prosey config

# List available languages
prosey read https://youtu.be/771PQEDeRmw --list

# Specify language
prosey read https://youtu.be/771PQEDeRmw --lang es

# Display JSON (no AI transcription)
prosey read 771PQEDeRmw

# Display plain text (no AI transcription)
prosey read 771PQEDeRmw

# Save transcript to file
prosey read 771PQEDeRmw -o transcript.txt

Opções