Documentación

Mantén cada archivo de locale al día con tu origen.

verbatra traduce tus archivos de locale de i18n de forma incremental: envía solo las cadenas nuevas y modificadas al proveedor que configures, comprueba cada resultado y escribe los archivos de vuelta en su sitio.

npm i -D @verbatra/cli
Inicio rápidoReferencia de la CLI
~/acme-shop

An example verbatra command-line session.

  1. verbatra init
    • ✓ created verbatra.config.ts
    • source en · targets de, es, fr
    • provider gemini · key from GEMINI_API_KEY
  2. verbatra translate
    • diff en.json · 12 new · 0 changed · 108 unchanged
    • de 12 translated · 108 unchanged · 0 withheld
    • es 12 translated · 108 unchanged · 0 withheld
    • fr 12 translated · 108 unchanged · 0 withheld
    • ✓ 36 keys translated in 5.4s · 0 skipped · lock updated
  3. verbatra diff
    • en.json · 120 keys · source of truth
    • de 2 new · 1 changed · 117 up to date
    • es 0 new · 0 changed · 120 up to date
    • fr 5 new · 0 changed · 115 up to date
    • 8 keys would be sent · run verbatra translate to apply
  4. verbatra watch
    • watching en.json for changes
    • en.json changed · 1 new key
    • de 1 translated · 0 withheld
    • ✓ 3 keys translated · waiting for changes

A dónde ir ahora

Nuevo por aquíTu primera traducciónInstala la CLI, genera una configuración, define tu clave de API y traduce.Ya configuradoAñade un idiomaSuma un locale a tu configuración y deja que una sola ejecución lo complete.Por dentroCómo funcionaLa canalización: diff contra la línea base del bloqueo, traducir, verificar, escribir.Con un agente de IAConfigura con IADale a Claude Code, Cursor o cualquier agente de código un prompt listo para copiar y pegar.

Qué hace verbatra

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 marcador de posición roto se retiene y se reintenta, nunca se publica. Consulta Cómo funciona para ver la canalización completa.

verbatra lee y escribe doce formatos y traduce a través de seis proveedores detrás de una sola interfaz. Consulta Formatos y Proveedores.

Los paquetes

@verbatra/cli

El binario verbatra: diez comandos, una capa fina sobre el SDK. Empieza por aquí.

@verbatra/sdk

El motor que hay debajo: translate, watch, check, diff, doctor, y el viaje de ida y vuelta con Excel.

@verbatra/studio

Un panel local con edición integrada y una cola de revisión. El gasto de proveedor permanece desactivado hasta que lo actives.

@verbatra/mcp

Un servidor MCP por stdio que expone el estado de traducción, el glosario y las herramientas de edición a un cliente MCP.