Prosey

Prosey è uno strumento CLI per scaricare e visualizzare le trascrizioni video da YouTube, così puoi ottenere le informazioni che cerchi senza perdere ore.

I casi d'uso principali sono:

• Riassumere un video di YouTube e visualizzarlo nella CLI con un singolo comando (più rapido).
• Leggere i sottotitoli del video, formattati e organizzati in capitoli come il video originale (spesso richiede più tempo).

Entrambi gli usi richiedono un assistente AI sul tuo sistema (predefinito: opencode, usa prosey config per configurare il tuo).

Se rileviamo un evidenziatore di sintassi sul tuo sistema, otterrai un bell'output colorato.

Prosey può anche produrre o memorizzare il formato json nativo così com'è.

Funzionalità

Funzionalità	Descrizione
💡  Riassumi	Recupera e riassume la trascrizione di un video
📖  Leggi	Recupera e visualizza la trascrizione formattata in Markdown
💬  Copia	Copia un riassunto negli appunti, pronto da incollare in una chat web
📋  Download trascrizione	Recupera le trascrizioni di YouTube come testo semplice o JSON così com'è
🤖  Riassunto AI	Invia le trascrizioni a qualsiasi agente AI (opencode, Claude, Copilot, Codex)
🎨  Pager intelligente	Evidenziazione della sintassi automatica se bat, glow o mdcat sono installati (o configura il tuo pager)
🛠️  Personalizzazione	Usa prosey config per accedere e modificare la tua configurazione / personalizzare i prompt
💾  Cache su disco	Le trascrizioni e i riassunti vengono memorizzati nella cache su disco per una rilettura istantanea
📄  Formati supportati	Testo semplice e JSON

Avvio rapido

Provalo subito con npx:

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

Installazione

Installa globalmente con il tuo gestore di pacchetti preferito:

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

Poi usalo ovunque:

prosey 771PQEDeRmw

Dal sorgente

Utilizza Bun per lo sviluppo — script, gestione dei pacchetti ed esecuzione diretta del codice sorgente TypeScript.

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

Utilizzo

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 è il comando predefinito, quindi prosey <id> esegue il riepilogatore AI. Usa prosey read <id> per scaricare e stampare una trascrizione con formattazione ricca.

Il comando summarize recupera una trascrizione, antepone il prompt dalla sezione di configurazione [summarize] e invia il risultato al comando AI configurato.

Il comando read scarica la trascrizione e la stampa su stdout (testo semplice, markdown o JSON). È utile quando non hai bisogno dell'elaborazione AI.

Il comando info mostra i metadati del video (titolo, canale, durata, visualizzazioni).

Il comando index ricostruisce l'indice dei documenti e lo apre nel browser. L'indice elenca ogni riepilogo e trascrizione memorizzati nella directory dei dati ed è ricostruito automaticamente dopo ogni esecuzione di summarize/transcribe. Facendo clic sul logo Prosey in qualsiasi pagina di contenuto si torna ad esso.

Il comando render rigenera ogni pagina HTML dal markdown in cache (nessuna elaborazione di rete o AI) e riscrive l'indice.

Il comando copy copia il riepilogo di un documento negli appunti, pronto per essere incollato in una chat web. Accetta il nome della cartella stampato alla fine dell'ultima esecuzione (o un percorso completo); --question aggiunge la tua domanda dopo il riepilogo, separata da due righe vuote. È possibile copiare solo i riepiloghi — una cartella con sola trascrizione è un errore.

Le pagine di riepilogo riportano un link Copy sulla riga dei metadati, a destra del tempo di lettura: mette il riepilogo negli appunti, pronto per essere incollato in una chat web.

Il comando config apre il tuo file di configurazione in $EDITOR per la modifica. Quando non c'è un terminale a cui collegarsi — $EDITOR non è impostato, oppure stdout/stdin è in pipe — viene invece stampato il percorso del file di configurazione.

Il comando help mostra il messaggio di aiuto, come --help.

Esempi

# 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

Opzioni