CLI e integrazione con gli agenti

Local Transcriber include uno strumento CLI e una skill per agenti IA di programmazione come Claude Code e pi. Puoi installare entrambi con un unico comando di menu.

Installazione

Nella barra dei menu dell’app, vai su Transcriber → Installa CLI e skill agente…

Questa operazione esegue due cose:

1. CLI — crea un link simbolico di transcriber in /usr/local/bin/ (richiesta password amministratore).
2. Skill agente — copia il file di skill in ~/.pi/agent/skills/transcriber/ e ~/.claude/skills/transcriber/.

Dopo l’installazione, apri un nuovo terminale ed esegui:

transcriber help

Comandi CLI

transcriber start

Avvia una nuova registrazione. Apre l’app se non e in esecuzione.

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

transcriber stop

Interrompe la registrazione in corso e avvia il post-processing.

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

transcriber toggle

Alterna la registrazione tra attiva e disattiva.

transcriber toggle

transcriber status

Mostra lo stato attuale in formato JSON. Funziona sia durante una registrazione che a riposo.

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"
# }

Campi:

Campo	Descrizione
recording	Se una registrazione e attiva
status	Stato attuale: Ready, Transcribing…, Processing…, Loading models…
duration	Durata della sessione nel formato MM:SS
segments	Numero di segmenti di trascrizione confermati
file	Percorso del file di trascrizione .md attuale
partial	Testo parziale non confermato (in diretta, non ancora finalizzato)
updated_at	Timestamp ISO 8601 dell’ultimo aggiornamento di stato

transcriber transcript

Stampa il file di trascrizione attuale o piu recente su stdout.

transcriber transcript

transcriber tail

Segue il file di trascrizione attuale — mostra gli aggiornamenti in diretta man mano che nuovi segmenti vengono confermati.

transcriber tail
# Tailing: /Users/you/Documents/MeetingTranscripts/2026-04-03-1400.md
# (nuove righe appaiono durante la riunione)

transcriber open

Apre la finestra dell’app Local Transcriber.

transcriber open

Schema URL

Puoi anche controllare l’app tramite uno schema URL, utile per le scorciatoie, gli strumenti di automazione o gli script:

open transcriber://start    # Avvia la registrazione
open transcriber://stop     # Interrompi la registrazione
open transcriber://toggle   # Alterna registrazione attiva/disattiva
open transcriber://pause    # Metti in pausa la registrazione attiva
open transcriber://resume   # Riprendi la registrazione in pausa

Nota: pause e resume sono disponibili solo tramite lo schema URL, non dal CLI.

Rielaborare una registrazione

Riesegui il post-processing (trascrizione migliorata + diarizzazione dei parlanti) su una registrazione esistente:

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

Il parametro file e il nome base del file (senza estensione) dalla cartella delle trascrizioni.

Skill agente

Dopo l’installazione, gli agenti IA che supportano le skill (Claude Code, pi) sanno automaticamente come controllare Local Transcriber. La skill insegna loro a:

• Avviare e interrompere registrazioni
• Verificare lo stato della registrazione
• Leggere la trascrizione in diretta o completata
• Rielaborare registrazioni esistenti
• Trovare e cercare file di trascrizione

Il tuo agente legge la trascrizione direttamente dal disco — nessuna chiave API, nessun cloud, nessun copia e incolla.

Esempio: Claude Code

> inizia a registrare la mia riunione

✅ Registrazione avviata.

> cosa e stato discusso finora?

Dalla trascrizione in diretta, il team ha discusso…

> interrompi la registrazione e fai un riepilogo

⏹ Registrazione interrotta. Ecco un riepilogo…

File di stato

L’app scrive il proprio stato attuale in ~/.transcriber/status.json ad ogni cambiamento. Il CLI legge questo file, e anche i tuoi script possono fare lo stesso:

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

Log del motore

Per il debug, segui il log del motore:

tail -f ~/.transcriber/engine.log