CLI et integration avec les agents

Local Transcriber inclut un outil CLI et une competence d’agent pour les agents IA de programmation comme Claude Code et pi. Installez les deux en un seul element de menu.

Installation

Dans la barre de menus de l’app, allez dans Transcriber → Installer le CLI et la competence d’agent…

Cela effectue deux operations :

1. CLI — cree un lien symbolique de transcriber vers /usr/local/bin/ (mot de passe administrateur requis).
2. Competence d’agent — copie le fichier de competence vers ~/.pi/agent/skills/transcriber/ et ~/.claude/skills/transcriber/.

Apres l’installation, ouvrez un nouveau terminal et executez :

transcriber help

Commandes CLI

transcriber start

Demarre un nouvel enregistrement. Ouvre l’app si elle n’est pas en cours d’execution.

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

transcriber stop

Arrete l’enregistrement en cours et lance le post-traitement.

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

transcriber toggle

Bascule l’enregistrement entre active et desactive.

transcriber toggle

transcriber status

Affiche l’etat actuel au format JSON. Fonctionne qu’un enregistrement soit actif ou non.

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

Champs :

Champ	Description
recording	Si un enregistrement est actif
status	Etat actuel : Ready, Transcribing…, Processing…, Loading models…
duration	Duree de la session au format MM:SS
segments	Nombre de segments de transcription confirmes
file	Chemin vers le fichier de transcription .md actuel
partial	Texte partiel non confirme (en direct, pas encore finalise)
updated_at	Horodatage ISO 8601 de la derniere mise a jour d’etat

transcriber transcript

Affiche le fichier de transcription actuel ou le plus recent sur stdout.

transcriber transcript

transcriber tail

Suit le fichier de transcription actuel — affiche les mises a jour en direct au fur et a mesure que de nouveaux segments sont confirmes.

transcriber tail
# Tailing: /Users/you/Documents/MeetingTranscripts/2026-04-03-1400.md
# (de nouvelles lignes apparaissent au fil de la reunion)

transcriber open

Ouvre la fenetre de l’app Local Transcriber.

transcriber open

Schema d’URL

Vous pouvez egalement controler l’app via un schema d’URL, utile pour les raccourcis, les outils d’automatisation ou les scripts :

open transcriber://start    # Demarrer l'enregistrement
open transcriber://stop     # Arreter l'enregistrement
open transcriber://toggle   # Basculer l'enregistrement active/desactive
open transcriber://pause    # Mettre en pause l'enregistrement actif
open transcriber://resume   # Reprendre l'enregistrement en pause

Remarque : pause et resume sont uniquement disponibles via le schema d’URL, pas depuis le CLI.

Retraiter un enregistrement

Relancez le post-traitement (transcription amelioree + diarisation des locuteurs) sur un enregistrement existant :

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

Le parametre file est le nom de base du fichier (sans extension) de votre dossier de transcriptions.

Competence d’agent

Apres l’installation, les agents IA prenant en charge les competences (Claude Code, pi) savent automatiquement comment controler Local Transcriber. La competence leur apprend a :

• Demarrer et arreter des enregistrements
• Verifier l’etat de l’enregistrement
• Lire la transcription en direct ou terminee
• Retraiter des enregistrements existants
• Trouver et rechercher des fichiers de transcription

Votre agent lit la transcription directement depuis le disque — pas de cles API, pas de cloud, pas de copier-coller.

Exemple : Claude Code

> commence a enregistrer ma reunion

✅ Enregistrement demarre.

> qu'est-ce qui a ete discute jusqu'ici ?

D'apres la transcription en direct, l'equipe a discute…

> arrete l'enregistrement et fais un resume

⏹ Enregistrement arrete. Voici un resume…

Fichier d’etat

L’app ecrit son etat actuel dans ~/.transcriber/status.json a chaque changement. Le CLI lit ce fichier, et vos propres scripts peuvent en faire autant :

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

Journal du moteur

Pour le debogage, suivez le journal du moteur :

tail -f ~/.transcriber/engine.log