CLI und Agenten-Integration

Local Transcriber enthält ein CLI-Tool und einen Agent-Skill für KI-Coding-Agenten wie Claude Code und pi. Installiere beides mit einem einzigen Menüpunkt.

Installation

Gehe in der Menüleiste der App zu Transcriber → CLI und Agent-Skill installieren…

Das macht zwei Dinge:

1. CLI — erstellt einen Symlink von transcriber nach /usr/local/bin/ (erfordert Admin-Passwort).
2. Agent-Skill — kopiert die Skill-Datei nach ~/.pi/agent/skills/transcriber/ und ~/.claude/skills/transcriber/.

Nach der Installation öffne ein neues Terminal und führe aus:

transcriber help

CLI-Befehle

transcriber start

Startet eine neue Aufnahme. Öffnet die App, falls sie nicht läuft.

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

transcriber stop

Stoppt die aktuelle Aufnahme und startet die Nachbearbeitung.

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

transcriber toggle

Schaltet die Aufnahme zwischen an und aus um.

transcriber toggle

transcriber status

Gibt den aktuellen Status als JSON aus. Funktioniert sowohl bei aktiver Aufnahme als auch ohne.

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

Felder:

Feld	Beschreibung
recording	Ob eine Aufnahme aktiv ist
status	Aktueller Status: Ready, Transcribing…, Processing…, Loading models…
duration	Sitzungsdauer als MM:SS
segments	Anzahl der bestätigten Transkriptionssegmente
file	Pfad zur aktuellen .md-Transkriptionsdatei
partial	Unbestätigter Teiltext (live, noch nicht finalisiert)
updated_at	ISO-8601-Zeitstempel der letzten Statusaktualisierung

transcriber transcript

Gibt die aktuelle oder letzte Transkriptionsdatei auf stdout aus.

transcriber transcript

transcriber tail

Folgt der aktuellen Transkriptionsdatei — zeigt Live-Updates, wenn neue Segmente bestätigt werden.

transcriber tail
# Tailing: /Users/you/Documents/MeetingTranscripts/2026-04-03-1400.md
# (neue Zeilen erscheinen, während das Meeting fortschreitet)

transcriber open

Öffnet das Local-Transcriber-App-Fenster.

transcriber open

URL-Schema

Du kannst die App auch über ein URL-Schema steuern, nützlich für Kurzbefehle, Automatisierungstools oder Skripte:

open transcriber://start    # Aufnahme starten
open transcriber://stop     # Aufnahme stoppen
open transcriber://toggle   # Aufnahme an/aus umschalten
open transcriber://pause    # Aktive Aufnahme pausieren
open transcriber://resume   # Pausierte Aufnahme fortsetzen

Hinweis: pause und resume sind nur über das URL-Schema verfügbar, nicht über das CLI.

Aufnahme erneut verarbeiten

Führe die Nachbearbeitung (verbesserte Transkription + Sprecherdiarisierung) erneut auf einer bestehenden Aufnahme aus:

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

Der Parameter file ist der Basisdateiname (ohne Erweiterung) aus deinem Transkriptionsordner.

Agent-Skill

Nach der Installation wissen KI-Agenten, die Skills unterstützen (Claude Code, pi), automatisch, wie sie Local Transcriber steuern können. Der Skill lehrt sie:

• Aufnahmen zu starten und zu stoppen
• Den Aufnahmestatus zu prüfen
• Die Live- oder fertige Transkription zu lesen
• Bestehende Aufnahmen erneut zu verarbeiten
• Transkriptionsdateien zu finden und zu durchsuchen

Dein Agent liest die Transkription direkt von der Festplatte — keine API-Schlüssel, keine Cloud, kein Kopieren und Einfügen.

Beispiel: Claude Code

> starte die Aufnahme meines Meetings

✅ Aufnahme gestartet.

> was wurde bisher besprochen?

Basierend auf der Live-Transkription hat das Team diskutiert…

> stoppe die Aufnahme und fasse zusammen

⏹ Aufnahme gestoppt. Hier ist eine Zusammenfassung…

Statusdatei

Die App schreibt ihren aktuellen Status bei jeder Änderung in ~/.transcriber/status.json. Das CLI liest diese Datei, und deine eigenen Skripte können das auch:

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

Engine-Log

Zum Debugging kannst du das Engine-Log verfolgen:

tail -f ~/.transcriber/engine.log