Opciones del CLI

Uso

yaku [opciones] [texto]

El texto puede proporcionarse como argumentos posicionales, mediante -f (archivos) o canalizado a través de stdin. Consulte Entrada y salida para detalles.

Opciones de traducción

Opción	Tipo	Predeterminado	Descripción
--to	string	config default-target	Requerido. Código de idioma destino (ej., zh-TW, ja, es).
--from	string	autodetección	Código de idioma de origen. Omita para que el LLM lo detecte automáticamente.
--mode	string	translate	translate — traducir al idioma destino. polish — refinar escritura que ya está en el idioma destino. Ver Modo pulir.
--context	string		Indicación de dominio para el LLM (ej., "documentación de Kubernetes", "correo formal"). Ayuda a resolver términos ambiguos.

Opciones de entrada / salida

Opción	Corta	Tipo	Predeterminado	Descripción
--file	-f	string[]		Ruta(s) de archivo(s) de entrada. Repita para múltiples archivos: -f a.md -f b.md.
--output	-o	string	stdout	Escribir texto traducido a un archivo en lugar de stdout.
--format		string	autodetección	Forzar formato de entrada: text, md, json, yaml. Se autodetecta desde la extensión del archivo -f cuando se omite.

Opciones de backend

Opción	Tipo	Predeterminado	Descripción
--backend	string	hosted	Backend LLM: hosted, gemini, openai, anthropic. Ver Backends.
--model	string	predeterminado del backend	Sobrescribir el nombre del modelo (ej., gemini-2.5-flash, gpt-4o, claude-sonnet-4-5-20250514).
--api-base	string		URL base de API para cualquier backend local. Comúnmente usado con proveedores compatibles con OpenAI (ej., https://api.groq.com/openai/v1).

Opciones de glosario

Opción	Tipo	Predeterminado	Descripción
--glossary	string	autodetección	Ruta a un archivo de glosario YAML. Sobrescribe la autodetección. Ver Glosario.
--no-glossary	bool	false	Omitir la carga del glosario completamente, incluso si existe un archivo de glosario en las ubicaciones predeterminadas.

Opciones de prompt

Opción	Tipo	Predeterminado	Descripción
--prompt	string	integrado	Ruta a un archivo de prompt de sistema personalizado. Reemplaza todo el prompt integrado. Ver Prompts personalizados.

Opciones de diagnóstico

Opción	Tipo	Predeterminado	Descripción
--verbose	bool	false	Mostrar nombre del modelo, conteo de tokens y tiempo transcurrido en stderr después de la traducción.

Ejemplo de salida de --verbose (en stderr):

Model: gemini-2.5-flash | Tokens: 42 in / 38 out | Time: 1.2s

Subcomandos

yaku config

Gestione el archivo de configuración en ~/.config/yaku/config.yaml.

Comando	Descripción
yaku config set <clave> <valor>	Establecer un valor de configuración.
yaku config get <clave>	Leer un valor de configuración (solo archivo, sin capa de env).
yaku config path	Mostrar la ruta del archivo de configuración.

Consulte Configuración para todas las claves disponibles.

yaku login

Autentíquese con el servicio alojado usando un flujo de autorización de dispositivo basado en navegador. Abre su navegador con un código de autorización prellenado — solo inicie sesión y haga clic en Aprobar. Las credenciales se almacenan en ~/.config/yaku/.credentials.

yaku login
# Abre su navegador para completar la autenticación

yaku logout

Revoque su sesión en el servidor y elimine las credenciales locales. Si el servidor no es accesible, las credenciales se conservan para que pueda reintentar.

yaku logout

# Forzar eliminación de credenciales locales incluso si la revocación del servidor falla
yaku logout --force

Opción	Descripción
--force	Eliminar credenciales locales independientemente de si el servidor confirmó la revocación. La sesión puede permanecer válida en el servidor hasta que expire.

yaku whoami

Muestre el estado de autenticación actual consultando el servicio alojado.

yaku whoami
# Logged in as Jane Doe ([email protected], github)

Si no ha iniciado sesión:

Not logged in (using anonymous quota)

Si la sesión ha expirado o es inválida:

Session expired or invalid. Run yaku login to re-authenticate.

Si el servidor no es accesible:

hosted service unreachable. Check your network connection

yaku quota

Muestre su cuota de uso actual para el servicio alojado. Muestra su nivel de plan, conteos de solicitudes diarias y mensuales, y el límite de caracteres por solicitud. Cuando usa un backend local, reporta que no aplica cuota.

Consulte Servicio alojado y planes para niveles de plan y límites.

yaku version

Muestre la versión del CLI.

yaku version
# yaku v0.1.0