CLI e integración con agentes

Local Transcriber incluye una herramienta CLI y una habilidad de agente para agentes de IA de codificación como Claude Code y pi. Instala ambos con un solo elemento del menú.

Instalación

En la barra de menú de la app, ve a Transcriber → Instalar CLI y Habilidad de Agente…

Esto hace dos cosas:

1. CLI — crea un enlace simbólico de transcriber a /usr/local/bin/ (requiere contraseña de administrador).
2. Habilidad de agente — copia el archivo de habilidad a ~/.pi/agent/skills/transcriber/ y ~/.claude/skills/transcriber/.

Después de instalar, abre una nueva terminal y ejecuta:

transcriber help

Comandos CLI

transcriber start

Inicia una nueva grabación. Abre la app si no está ejecutándose.

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

transcriber stop

Detiene la grabación actual y comienza el post-procesamiento.

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

transcriber toggle

Alterna la grabación entre encendido y apagado.

transcriber toggle

transcriber status

Imprime el estado actual como JSON. Funciona tanto si hay una grabación activa como si no.

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

Campos:

Campo	Descripción
recording	Si hay una grabación activa
status	Estado actual: Ready, Transcribing…, Processing…, Loading models…
duration	Duración de la sesión como MM:SS
segments	Número de segmentos de transcripción confirmados
file	Ruta al archivo de transcripción .md actual
partial	Texto parcial no confirmado (en vivo, aún no finalizado)
updated_at	Marca de tiempo ISO 8601 de la última actualización de estado

transcriber transcript

Imprime el archivo de transcripción actual o más reciente en stdout.

transcriber transcript

transcriber tail

Sigue el archivo de transcripción actual — muestra actualizaciones en vivo a medida que se confirman nuevos segmentos.

transcriber tail
# Tailing: /Users/you/Documents/MeetingTranscripts/2026-04-03-1400.md
# (aparecen nuevas líneas a medida que avanza la reunión)

transcriber open

Abre la ventana de la app Local Transcriber.

transcriber open

Esquema de URL

También puedes controlar la app vía esquema de URL, útil para atajos, herramientas de automatización o scripts:

open transcriber://start    # Iniciar grabación
open transcriber://stop     # Detener grabación
open transcriber://toggle   # Alternar grabación encendido/apagado
open transcriber://pause    # Pausar grabación activa
open transcriber://resume   # Reanudar grabación pausada

Nota: pause y resume solo están disponibles vía esquema de URL, no desde el CLI.

Reprocesar una grabación

Vuelve a ejecutar el post-procesamiento (transcripción mejorada + diarización de hablantes) en una grabación existente:

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

El parámetro file es el nombre base del archivo (sin extensión) de tu carpeta de transcripciones.

Habilidad de agente

Después de instalar, los agentes de IA que soportan habilidades (Claude Code, pi) automáticamente saben cómo controlar Local Transcriber. La habilidad les enseña a:

• Iniciar y detener grabaciones
• Verificar el estado de la grabación
• Leer la transcripción en vivo o completada
• Reprocesar grabaciones existentes
• Encontrar y buscar archivos de transcripción

Tu agente lee la transcripción directamente desde el disco — sin claves API, sin nube, sin copiar y pegar.

Ejemplo: Claude Code

> empieza a grabar mi reunión

✅ Grabación iniciada.

> ¿qué se ha discutido hasta ahora?

Basándome en la transcripción en vivo, el equipo discutió…

> detén la grabación y resume

⏹ Grabación detenida. Aquí tienes un resumen…

Archivo de estado

La app escribe su estado actual en ~/.transcriber/status.json con cada cambio. El CLI lee este archivo, y tus propios scripts también pueden:

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

Log del motor

Para depuración, sigue el log del motor:

tail -f ~/.transcriber/engine.log