Documentación
Configura verbatra y mantén cada locale al día.
Guías y referencia para la CLI, el SDK, Studio y el servidor MCP: empieza con el inicio rápido o deja que tu agente de código configure verbatra.
Empieza por tu objetivo
Elige lo que quieres hacer; cada tarjeta abre la página que lo explica.
Elige tu stack
Una tarjeta marcada con Inicio rápido abre una guía paso a paso para ese stack; cualquier otra tarjeta abre su comando init y su estructura de archivos.
Cada ejecución es un diff, no una reescritura.
Qué pasa cuando ejecutas verbatra translate.
Mantener a mano un locale de origen significa que todos los demás archivos de locale se desfasan: las claves nuevas faltan en los destinos, las cadenas editadas dejan atrás traducciones obsoletas y las claves eliminadas se quedan como huérfanas. verbatra cierra esa brecha comparando cada destino contra un archivo de bloqueo confirmado, verbatra.lock.json, y enviando al proveedor que configures solo lo que cambió; una segunda ejecución sin nada nuevo que traducir no hace ni una llamada al proveedor. Cada resultado se comprueba antes de escribirse, así que un placeholder roto se retiene y se reintenta, nunca se publica. Consulta Cómo funciona para ver la canalización completa.
1. Comprueba
verbatra checkcompara el origen, los destinos y el archivo de bloqueo. No llama a ningún proveedor ni necesita clave.2. Traduce
verbatra translateenvía solo las claves que faltan o cambiaron y rechaza cualquier resultado con placeholders que no coinciden, marcado en línea roto o sintaxis ICU no válida.3. Bloquea en CI
La GitHub Action ejecuta
checken cada pull request y la hace fallar mientras un locale no esté sincronizado.
verbatra lee y escribe los formatos habituales de archivos de locale, de JSON y YAML a XLIFF, gettext y los catálogos de Android y Apple, y traduce a través de cualquier proveedor compatible, sea un LLM o un servicio de traducción automática, detrás de una sola interfaz (o de ninguno, para un flujo solo humano), y un formato que no trae de serie se puede añadir como adaptador personalizado. Las listas completas están en Formatos y Proveedores.
Los paquetes
Un motor, cuatro formas de manejarlo.
El binario verbatra: todos los comandos, de init y extract a translate, check, export y studio, como una capa fina sobre el SDK. Empieza por aquí.
El motor que hay debajo: translate, watch, check, diff, doctor, extract, pseudolocalización, generación de tipos y los ciclos de ida y vuelta con Excel y TMX, todo desde código.
Un panel local con edición in situ, una cola de revisión, un Overview de cobertura y ejecuciones y herramientas para agentes de navegador. El gasto de proveedor permanece desactivado hasta que lo actives.
Un servidor MCP por stdio que expone el estado de traducción, el glosario y las herramientas de edición a Claude Code, Cursor o cualquier cliente MCP.