verbatra studio

Démarre Verbatra Studio, un tableau de bord web local au-dessus de ton projet verbatra : l'état des traductions, la file de révision, l'activité des exécutions et tes paramètres résolus, le tout en direct sur les fichiers du disque. Modifier tes propres fichiers de locale fonctionne d'emblée ; seule la dépense fournisseur est optionnelle, derrière --allow-spend. Avant de démarrer, studio charge .env.local puis .env depuis le répertoire de travail et résout ta config une fois ; une erreur de config sort avec 2 avant qu'aucun serveur ne démarre.

Synopsis

verbatra studio [flags]

Options

Quand l'option --allow-spend est absente, Studio lit la variable d'environnement VERBATRA_STUDIO_ALLOW_SPEND à la place : 1, true, yes ou on (insensible à la casse) compte comme activé. L'option CLI l'emporte toujours sur la variable d'environnement. Sans l'une ni l'autre, Studio ne contacte jamais de fournisseur ; la modification locale n'a besoin d'aucune option.

--expose-agent-tools se résout de la même façon à partir de VERBATRA_STUDIO_AGENT_TOOLS, avec le même ensemble de valeurs admises et la même règle : l'option CLI l'emporte sur la variable. Elle est désactivée par défaut. Pour qu'un agent puisse dépenser, il faut à la fois cette option et --allow-spend ; aucune des deux options n'implique l'autre. Voir Piloter Studio avec un agent de navigateur pour le catalogue d'outils et le modèle de sécurité.

L'URL affichée

Studio n'écoute que sur 127.0.0.1. Une fois à l'écoute, il affiche une ligne sur stdout :

Verbatra Studio running at http://127.0.0.1:5849/?token=<token>

Ouvre exactement cette URL : le token dans la chaîne de requête initialise ta session de navigateur, et toute requête sans lui est rejetée. Rien n'est affiché avant que le port soit lié avec succès, donc un démarrage échoué ne divulgue jamais d'URL ni de token.

Installation

@verbatra/studio est un paquet à part, atteint via un import dynamique pour que le reste de la CLI fonctionne sans lui. S'il n'est pas installé, verbatra studio sort avec 2 et :

Verbatra Studio requires @verbatra/studio. Install it with: pnpm add -D @verbatra/studio

Cette commande pnpm installe correctement mais sort en 1 avec ERR_PNPM_IGNORED_BUILDS, et laisse un pnpm-workspace.yaml sans réponse qui fait échouer de la même façon les commandes pnpm suivantes ; la correction, à faire une seule fois, est dans le Dépannage. npm et yarn installent le paquet sans cela.

Exemples

# start Verbatra Studio on the default port
verbatra studio

# enable the provider-calling actions, on a specific port
verbatra studio --allow-spend --port 6000

Codes de sortie

Voir aussi

• Réviser les traductions dans Studio parcourt la page Traductions, la file de révision et la retraduction avec --allow-spend.
• Piloter Studio avec un agent de navigateur couvre --expose-agent-tools et la surface d'outils WebMCP.
• verbatra check et verbatra diff sont les mêmes calculs que Studio affiche en direct.