verbalcoding 0.2.11 → 0.2.13

package/docs/i18n/CONFIGURATION.es.md

@@ -1,5 +1,30 @@
 # Configuración de VerbalCoding
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="README.es.md">Centro de documentación</a> ·
+  <a href="FRESH_INSTALL.es.md">Fresh Install</a> ·
+  <a href="USAGE.es.md">Usage</a> ·
+  <a href="CONFIGURATION.es.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.es.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.es.md">Multi-Instance</a>
+</p>
+
+> Ruta rápida: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Flujo setup actualizado
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+No edites `.env` manualmente: usa `vc setup token` para guardar `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID` y `vc setup channels` para guardar `AUTO_JOIN_VOICE_CHANNELS`. Si Docker muestra `Cannot perform IP discovery - socket closed`, usa `network_mode: "host"` en Linux Compose y elimina `ports:`.
+
 ## Asistente de configuración
 
 La configuración de la aplicación/bot de Discord no se vuelve a explicar desde cero aquí de forma intencionada. Usa estas guías originales para los pasos del lado de Discord y luego vuelve a la configuración de VerbalCoding:

package/docs/i18n/CONFIGURATION.fr.md

@@ -1,5 +1,30 @@
 # Configuration de VerbalCoding
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="README.fr.md">Centre de documentation</a> ·
+  <a href="FRESH_INSTALL.fr.md">Fresh Install</a> ·
+  <a href="USAGE.fr.md">Usage</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.fr.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.fr.md">Multi-Instance</a>
+</p>
+
+> Chemin rapide: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Flux setup actuel
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+Ne modifiez pas `.env` à la main : utilisez `vc setup token` pour enregistrer `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`, et `vc setup channels` pour `AUTO_JOIN_VOICE_CHANNELS`. Si Docker affiche `Cannot perform IP discovery - socket closed`, utilisez `network_mode: "host"` avec Compose sous Linux et supprimez `ports:`.
+
 ## Assistant de configuration
 
 La configuration du bot/de l'application Discord n'est volontairement pas réexpliquée depuis zéro ici. Utilisez ces guides amont pour les étapes côté Discord, puis revenez à la configuration de VerbalCoding :

package/docs/i18n/CONFIGURATION.ja.md

@@ -1,5 +1,30 @@
 # VerbalCoding 設定
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="README.ja.md">ドキュメントハブ</a> ·
+  <a href="FRESH_INSTALL.ja.md">Fresh Install</a> ·
+  <a href="USAGE.ja.md">Usage</a> ·
+  <a href="CONFIGURATION.ja.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ja.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ja.md">Multi-Instance</a>
+</p>
+
+> 最短経路: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 最新の setup フロー
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+手動で `.env` を編集せず、`vc setup token` で `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`、`vc setup channels` で `AUTO_JOIN_VOICE_CHANNELS` を保存してください。Docker で `Cannot perform IP discovery - socket closed` が出る場合、Linux Compose サービスに `network_mode: "host"` を使い、`ports:` を削除します。
+
 ## セットアップウィザード
 
 Discord ボット/アプリケーションのセットアップ手順は、ここでは最初から説明し直しません。Discord 側の手順には次の上流ガイドを使い、その後 VerbalCoding のセットアップに戻ってください:

package/docs/i18n/CONFIGURATION.ko.md

@@ -1,5 +1,30 @@
 # VerbalCoding 설정
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="README.ko.md">문서 허브</a> ·
+  <a href="FRESH_INSTALL.ko.md">Fresh Install</a> ·
+  <a href="USAGE.ko.md">Usage</a> ·
+  <a href="CONFIGURATION.ko.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ko.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ko.md">Multi-Instance</a>
+</p>
+
+> 빠른 경로: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 최신 setup 흐름
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+수동 `.env` 편집 대신 `vc setup token`으로 `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`를 저장하고, `vc setup channels`로 `AUTO_JOIN_VOICE_CHANNELS`를 저장하세요. Docker에서 `Cannot perform IP discovery - socket closed`가 보이면 Linux Compose 서비스에 `network_mode: "host"`를 사용하고 `ports:`를 제거하세요.
+
 ## 설정 마법사
 
 Discord 봇/애플리케이션 설정은 여기서 처음부터 다시 설명하지 않습니다. Discord 쪽 단계는 다음 업스트림 가이드를 사용한 뒤 VerbalCoding 설정으로 돌아오세요:

package/docs/i18n/CONFIGURATION.ru.md

@@ -1,5 +1,30 @@
 # Конфигурация VerbalCoding
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="README.ru.md">Центр документации</a> ·
+  <a href="FRESH_INSTALL.ru.md">Fresh Install</a> ·
+  <a href="USAGE.ru.md">Usage</a> ·
+  <a href="CONFIGURATION.ru.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ru.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ru.md">Multi-Instance</a>
+</p>
+
+> Быстрый путь: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Актуальный setup-процесс
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+Не редактируйте `.env` вручную: используйте `vc setup token` для `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID` и `vc setup channels` для `AUTO_JOIN_VOICE_CHANNELS`. Если Docker показывает `Cannot perform IP discovery - socket closed`, в Linux Compose используйте `network_mode: "host"` и удалите `ports:`.
+
 ## Мастер настройки
 
 Настройка Discord-бота/приложения намеренно не объясняется здесь с нуля. Используйте эти исходные руководства для шагов на стороне Discord, затем вернитесь к настройке VerbalCoding:

package/docs/i18n/CONFIGURATION.zh.md

@@ -1,5 +1,30 @@
 # VerbalCoding 配置
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="README.zh.md">文档中心</a> ·
+  <a href="FRESH_INSTALL.zh.md">Fresh Install</a> ·
+  <a href="USAGE.zh.md">Usage</a> ·
+  <a href="CONFIGURATION.zh.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.zh.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.zh.md">Multi-Instance</a>
+</p>
+
+> 最快路径: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 最新 setup 流程
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+不要手动编辑 `.env`；使用 `vc setup token` 保存 `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`，使用 `vc setup channels` 保存 `AUTO_JOIN_VOICE_CHANNELS`。如果 Docker 中出现 `Cannot perform IP discovery - socket closed`，请在 Linux Compose 服务中使用 `network_mode: "host"` 并移除 `ports:`。
+
 ## 设置向导
 
 这里有意不从头重新解释 Discord 机器人/应用设置。请先使用这些上游指南完成 Discord 侧步骤，然后回到 VerbalCoding 设置：

package/docs/i18n/FRESH_INSTALL.es.md

@@ -1,5 +1,30 @@
 # Instalación limpia
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="README.es.md">Centro de documentación</a> ·
+  <a href="FRESH_INSTALL.es.md">Fresh Install</a> ·
+  <a href="USAGE.es.md">Usage</a> ·
+  <a href="CONFIGURATION.es.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.es.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.es.md">Multi-Instance</a>
+</p>
+
+> Ruta rápida: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Flujo setup actualizado
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+No edites `.env` manualmente: usa `vc setup token` para guardar `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID` y `vc setup channels` para guardar `AUTO_JOIN_VOICE_CHANNELS`. Si Docker muestra `Cannot perform IP discovery - socket closed`, usa `network_mode: "host"` en Linux Compose y elimina `ports:`.
+
 Esta guía es para una instalación pública limpia. Evita suposiciones locales y usa el instalador para inicializar todo lo posible.
 
 ## 1. Instala la CLI
@@ -19,7 +44,7 @@ npx verbalcoding setup --yes
 Si usaste `npm install -g`, continúa con:
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 Ruta de clonación de GitHub para colaboradores:
@@ -35,7 +60,7 @@ cd VerbalCoding
 En una instalación npm, no ejecutes `./scripts/install.sh` directamente; no hay un checkout del repositorio en tu directorio actual. Usa en su lugar el wrapper CLI empaquetado:
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 `vc setup` ejecuta el `scripts/install.sh` incluido dentro del paquete npm instalado. Usa `./scripts/install.sh --yes` solo cuando estés dentro de un clon de GitHub:

package/docs/i18n/FRESH_INSTALL.fr.md

@@ -1,5 +1,30 @@
 # Installation propre
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="README.fr.md">Centre de documentation</a> ·
+  <a href="FRESH_INSTALL.fr.md">Fresh Install</a> ·
+  <a href="USAGE.fr.md">Usage</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.fr.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.fr.md">Multi-Instance</a>
+</p>
+
+> Chemin rapide: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Flux setup actuel
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+Ne modifiez pas `.env` à la main : utilisez `vc setup token` pour enregistrer `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`, et `vc setup channels` pour `AUTO_JOIN_VOICE_CHANNELS`. Si Docker affiche `Cannot perform IP discovery - socket closed`, utilisez `network_mode: "host"` avec Compose sous Linux et supprimez `ports:`.
+
 Ce guide couvre une installation publique propre. Il évite les hypothèses propres à une machine locale et utilise l'installateur pour amorcer autant d'éléments que possible.
 
 ## 1. Installer la CLI
@@ -19,7 +44,7 @@ npx verbalcoding setup --yes
 Si vous avez utilisé `npm install -g`, continuez avec :
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 Chemin de clonage GitHub pour les contributeurs :
@@ -35,7 +60,7 @@ cd VerbalCoding
 Pour une installation npm, n'exécutez pas `./scripts/install.sh` directement : il n'y a pas de checkout du dépôt dans votre répertoire courant. Utilisez plutôt l'enveloppe CLI empaquetée :
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 `vc setup` exécute le `scripts/install.sh` inclus dans le paquet npm installé. N'utilisez `./scripts/install.sh --yes` que lorsque vous êtes dans un clone GitHub :

package/docs/i18n/FRESH_INSTALL.ja.md

@@ -1,5 +1,30 @@
 # 新規インストール
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="README.ja.md">ドキュメントハブ</a> ·
+  <a href="FRESH_INSTALL.ja.md">Fresh Install</a> ·
+  <a href="USAGE.ja.md">Usage</a> ·
+  <a href="CONFIGURATION.ja.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ja.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ja.md">Multi-Instance</a>
+</p>
+
+> 最短経路: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 最新の setup フロー
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+手動で `.env` を編集せず、`vc setup token` で `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`、`vc setup channels` で `AUTO_JOIN_VOICE_CHANNELS` を保存してください。Docker で `Cannot perform IP discovery - socket closed` が出る場合、Linux Compose サービスに `network_mode: "host"` を使い、`ports:` を削除します。
+
 このガイドは、クリーンな公開インストール向けです。ローカル環境だけに依存する前提を避け、インストーラーで可能な限りブートストラップします。
 
 ## 1. CLI をインストールする
@@ -19,7 +44,7 @@ npx verbalcoding setup --yes
 `npm install -g` を使った場合は、続けて次を実行します:
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 コントリビューター向けの GitHub クローン手順:
@@ -35,7 +60,7 @@ cd VerbalCoding
 npm インストールでは、現在のディレクトリにリポジトリのチェックアウトがないため、`./scripts/install.sh` を直接実行しないでください。代わりにパッケージ済み CLI ラッパーを使います:
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 `vc setup` は、インストール済み npm パッケージ内の `scripts/install.sh` を実行します。`./scripts/install.sh --yes` は GitHub クローン内にいる場合だけ使ってください:

package/docs/i18n/FRESH_INSTALL.ko.md

@@ -1,5 +1,30 @@
 # 새로 설치하기
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="README.ko.md">문서 허브</a> ·
+  <a href="FRESH_INSTALL.ko.md">Fresh Install</a> ·
+  <a href="USAGE.ko.md">Usage</a> ·
+  <a href="CONFIGURATION.ko.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ko.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ko.md">Multi-Instance</a>
+</p>
+
+> 빠른 경로: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 최신 setup 흐름
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+수동 `.env` 편집 대신 `vc setup token`으로 `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`를 저장하고, `vc setup channels`로 `AUTO_JOIN_VOICE_CHANNELS`를 저장하세요. Docker에서 `Cannot perform IP discovery - socket closed`가 보이면 Linux Compose 서비스에 `network_mode: "host"`를 사용하고 `ports:`를 제거하세요.
+
 이 가이드는 깨끗한 공개 설치를 위한 문서입니다. 로컬 환경에만 맞춘 가정을 피하고, 설치 프로그램으로 가능한 한 많은 부분을 부트스트랩합니다.
 
 ## 1. CLI 설치
@@ -19,7 +44,7 @@ npx verbalcoding setup --yes
 `npm install -g`를 사용했다면 다음을 계속 실행하세요:
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 기여자를 위한 GitHub 클론 경로:
@@ -35,7 +60,7 @@ cd VerbalCoding
 npm 설치에서는 현재 디렉터리에 저장소 체크아웃이 없으므로 `./scripts/install.sh`를 직접 실행하지 마세요. 대신 패키지된 CLI 래퍼를 사용하세요:
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 `vc setup`은 설치된 npm 패키지 안의 `scripts/install.sh`를 실행합니다. GitHub 클론 안에 있을 때만 `./scripts/install.sh --yes`를 사용하세요:

package/docs/i18n/FRESH_INSTALL.ru.md

@@ -1,5 +1,30 @@
 # Чистая установка
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="README.ru.md">Центр документации</a> ·
+  <a href="FRESH_INSTALL.ru.md">Fresh Install</a> ·
+  <a href="USAGE.ru.md">Usage</a> ·
+  <a href="CONFIGURATION.ru.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.ru.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.ru.md">Multi-Instance</a>
+</p>
+
+> Быстрый путь: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## Актуальный setup-процесс
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+Не редактируйте `.env` вручную: используйте `vc setup token` для `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID` и `vc setup channels` для `AUTO_JOIN_VOICE_CHANNELS`. Если Docker показывает `Cannot perform IP discovery - socket closed`, в Linux Compose используйте `network_mode: "host"` и удалите `ports:`.
+
 Это руководство предназначено для чистой публичной установки. Оно избегает локальных предположений и использует установщик, чтобы подготовить как можно больше компонентов.
 
 ## 1. Установите CLI
@@ -19,7 +44,7 @@ npx verbalcoding setup --yes
 Если вы использовали `npm install -g`, продолжите так:
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 Путь через клон GitHub для контрибьюторов:
@@ -35,7 +60,7 @@ cd VerbalCoding
 При установке через npm не запускайте `./scripts/install.sh` напрямую: в текущем каталоге нет checkout репозитория. Вместо этого используйте упакованную CLI-обёртку:
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 `vc setup` запускает `scripts/install.sh`, включённый в установленный npm-пакет. Используйте `./scripts/install.sh --yes` только внутри GitHub-клона:

package/docs/i18n/FRESH_INSTALL.zh.md

@@ -1,5 +1,30 @@
 # 全新安装
 
+<!-- readme-glow-up:intro -->
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="README.zh.md">文档中心</a> ·
+  <a href="FRESH_INSTALL.zh.md">Fresh Install</a> ·
+  <a href="USAGE.zh.md">Usage</a> ·
+  <a href="CONFIGURATION.zh.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.zh.md">Troubleshooting</a> ·
+  <a href="MULTI_INSTANCE.zh.md">Multi-Instance</a>
+</p>
+
+> 最快路径: `npm install -g verbalcoding@latest → vc setup → vc doctor → vc start`
+<!-- /readme-glow-up:intro -->
+
+## 最新 setup 流程
+
+```bash
+npm install -g verbalcoding@latest
+vc setup
+vc doctor
+vc start
+```
+
+不要手动编辑 `.env`；使用 `vc setup token` 保存 `DISCORD_BOT_TOKEN`/`DISCORD_CLIENT_ID`，使用 `vc setup channels` 保存 `AUTO_JOIN_VOICE_CHANNELS`。如果 Docker 中出现 `Cannot perform IP discovery - socket closed`，请在 Linux Compose 服务中使用 `network_mode: "host"` 并移除 `ports:`。
+
 本指南用于干净的公开安装。它避免依赖本地专用假设，并使用安装器尽可能完成引导。
 
 ## 1. 安装 CLI
@@ -19,7 +44,7 @@ npx verbalcoding setup --yes
 如果你使用了 `npm install -g`，继续运行：
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 贡献者的 GitHub 克隆路径：
@@ -35,7 +60,7 @@ cd VerbalCoding
 通过 npm 安装时，当前目录中没有仓库检出，因此不要直接运行 `./scripts/install.sh`。请改用打包好的 CLI 包装器：
 
 ```bash
-vc setup --yes
+vc setup
 ```
 
 `vc setup` 会运行已安装 npm 包内部的 `scripts/install.sh`。只有在 GitHub 克隆目录中时才使用 `./scripts/install.sh --yes`：

package/docs/i18n/HARNESSES.es.md

@@ -0,0 +1,58 @@
+# Harnesses de agentes de codificación
+
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="README.es.md">Centro de documentación</a> ·
+  <a href="USAGE.es.md">Uso</a> ·
+  <a href="CONFIGURATION.es.md">Configuración</a> ·
+  <a href="TROUBLESHOOTING.es.md">Resolución de problemas</a>
+</p>
+
+VerbalCoding es agnóstico al agente. Lanza el CLI de codificación que tengas instalado una vez por turno de voz, le pasa la transcripción como prompt y reproduce la respuesta. Elige **uno** como predeterminado; el enrutamiento por voz te permite alcanzar los demás dentro de la sesión.
+
+| Harness | Comando por defecto | Reanudación de sesión | Documento específico |
+|---|---|---|---|
+| Hermes Agent | `hermes chat -Q -q` | ✅ (`--resume <id>`) | [HERMES_VOICE.es.md](./HERMES_VOICE.es.md) · [HARNESS_HERMES.es.md](./HARNESS_HERMES.es.md) |
+| Claude Code | `claude -p` | ❌ | [HARNESS_CLAUDE.es.md](./HARNESS_CLAUDE.es.md) |
+| Codex | `codex exec` | ❌ (captura del último mensaje) | [HARNESS_CODEX.es.md](./HARNESS_CODEX.es.md) |
+| Gemini CLI | `gemini -p` | ❌ | [HARNESS_GEMINI.es.md](./HARNESS_GEMINI.es.md) |
+| OpenCode | `opencode run` | ❌ | [HARNESS_OPENCODE.es.md](./HARNESS_OPENCODE.es.md) |
+| OpenClaw | `openclaw run` | ❌ | [HARNESS_OPENCLAW.es.md](./HARNESS_OPENCLAW.es.md) |
+| Aider | `aider --no-pretty --yes-always --message` | ❌ | [HARNESS_AIDER.es.md](./HARNESS_AIDER.es.md) |
+| Cursor CLI | `cursor-agent --print --prompt` | ❌ | [HARNESS_CURSOR.es.md](./HARNESS_CURSOR.es.md) |
+
+## Elige tu agente por defecto
+
+`vc setup` autodetecta los binarios instalados y te deja elegir. Configuración no interactiva:
+
+```bash
+# .env o instance .env
+AGENT_BACKEND=claude              # hermes | claude | codex | gemini | opencode | openclaw | aider | cursor | custom
+```
+
+Cada harness lee su comando de la env del mismo nombre (`HERMES_COMMAND`, `CLAUDE_COMMAND`, etc.). Las envs compartidas (`AGENT_LABEL`, `AGENT_COMMAND`, `AGENT_SESSION_FILE`, `AGENT_WORKDIR`, `AGENT_PROJECT_CONTEXT`, `AGENT_TASK_TIMEOUT_MS`, `AGENT_CHAT_TIMEOUT_MS`, `AGENT_VERBOSE_PROGRESS`) sobreescriben los valores por defecto de cada harness.
+
+## Enrutamiento entre harnesses por voz
+
+Una vez configurado, puedes alcanzar cualquier harness **instalado** sin reiniciar:
+
+- `"ask Codex what it thinks"` — ruta de un solo turno; el siguiente turno vuelve al predeterminado.
+- `"switch to Aider"` — ruta sticky hasta que digas `"back to default"`.
+- Slot `which_agent` del modo plan — el propio agente propone qué backend ejecuta el siguiente plan.
+
+La capa de enrutamiento verifica si el binario está en `PATH` (resolviendo rutas relativas contra el workdir de la sesión de proyecto activa). Si no está instalado, el puente pregunta `"¿Quieres que use el agente por defecto?"` — responde `"yes"` para hacer fallback o `"no"` para cancelar.
+
+Alias reconocidos: `claude` / `claude code`, `codex`, `gemini` / `gemini cli`, `opencode`, `openclaw`, `aider`, `cursor` / `cursor cli`, `hermes`.
+
+## Semánticas compartidas
+
+Todo adaptador respeta:
+
+- **Modo plan por voz** — `"plan it first"` narra un plan, edita por voz, `"approve"` ejecuta contra el harness elegido.
+- **Barge-in** — el corte interrumpe el TTS actual y aborta la tarea del agente. El enrutamiento sticky sobrevive a interrupciones; solo las rutas de un turno se limpian.
+- **Progreso detallado** — `AGENT_VERBOSE_PROGRESS=1` imprime eventos de progreso. Con `SMART_PROGRESS_API_KEY`, un LLM los resume en una frase por lote.
+- **Notificación push** — `NOTIFY_PROVIDER=ntfy|pushover` + `NOTIFY_MIN_TASK_MS` envía push cuando una tarea larga termina y el canal de voz está vacío. Debounce por cuerpo + `NOTIFY_DEBOUNCE_MS`.
+- **Estado por canal** — cada canal de voz mantiene su propio enrutamiento, estado de plan y buffer de elocuciones recientes.
+- **Sesiones de proyecto** — `!session new <name> <workdir>` vincula un canal a un proyecto; los adaptadores (harness, sesión) se cachean y se invalidan al rebind.
+
+Detalles de instalación, autenticación y pitfalls por harness en sus docs respectivos. Referencia completa de env: `docs/CONFIGURATION.es.md`.

package/docs/i18n/HARNESSES.fr.md

@@ -0,0 +1,58 @@
+# Harnesses d'agents de codage
+
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="README.fr.md">Docs hub</a> ·
+  <a href="USAGE.fr.md">Utilisation</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a> ·
+  <a href="TROUBLESHOOTING.fr.md">Dépannage</a>
+</p>
+
+VerbalCoding est agnostique : il pilote le CLI de codage installé chez vous, un appel par tour vocal, en lui passant la transcription comme prompt et en jouant la réponse. Choisissez **un** agent par défaut ; le routage par voix permet d'atteindre les autres en cours de session.
+
+| Harness | Commande par défaut | Reprise de session | Doc dédiée |
+|---|---|---|---|
+| Hermes Agent | `hermes chat -Q -q` | ✅ (`--resume <id>`) | [HERMES_VOICE.fr.md](./HERMES_VOICE.fr.md) · [HARNESS_HERMES.fr.md](./HARNESS_HERMES.fr.md) |
+| Claude Code | `claude -p` | ❌ | [HARNESS_CLAUDE.fr.md](./HARNESS_CLAUDE.fr.md) |
+| Codex | `codex exec` | ❌ (capture du dernier message) | [HARNESS_CODEX.fr.md](./HARNESS_CODEX.fr.md) |
+| Gemini CLI | `gemini -p` | ❌ | [HARNESS_GEMINI.fr.md](./HARNESS_GEMINI.fr.md) |
+| OpenCode | `opencode run` | ❌ | [HARNESS_OPENCODE.fr.md](./HARNESS_OPENCODE.fr.md) |
+| OpenClaw | `openclaw run` | ❌ | [HARNESS_OPENCLAW.fr.md](./HARNESS_OPENCLAW.fr.md) |
+| Aider | `aider --no-pretty --yes-always --message` | ❌ | [HARNESS_AIDER.fr.md](./HARNESS_AIDER.fr.md) |
+| Cursor CLI | `cursor-agent --print --prompt` | ❌ | [HARNESS_CURSOR.fr.md](./HARNESS_CURSOR.fr.md) |
+
+## Choisir l'agent par défaut
+
+`vc setup` détecte les binaires installés et propose un choix. Sans interaction :
+
+```bash
+# .env ou instance .env
+AGENT_BACKEND=claude              # hermes | claude | codex | gemini | opencode | openclaw | aider | cursor | custom
+```
+
+Chaque harness lit sa commande dans l'env homonyme (`HERMES_COMMAND`, `CLAUDE_COMMAND`, etc.). Les envs partagées (`AGENT_LABEL`, `AGENT_COMMAND`, `AGENT_SESSION_FILE`, `AGENT_WORKDIR`, `AGENT_PROJECT_CONTEXT`, `AGENT_TASK_TIMEOUT_MS`, `AGENT_CHAT_TIMEOUT_MS`, `AGENT_VERBOSE_PROGRESS`) surchargent les valeurs par défaut.
+
+## Routage entre harnesses par voix
+
+Une fois configuré, vous atteignez n'importe quel harness **installé** sans redémarrer :
+
+- `"ask Codex what it thinks"` — routage à un tour ; le tour suivant revient au défaut.
+- `"switch to Aider"` — routage sticky jusqu'à `"back to default"`.
+- Slot `which_agent` du mode plan — l'agent propose lui-même quel backend exécute le plan.
+
+Le routeur vérifie la présence du binaire dans `PATH` (les chemins relatifs sont résolus contre le workdir de la session projet active). Sinon, il demande `"Utiliser l'agent par défaut à la place ?"` — `"yes"` pour le fallback, `"no"` pour annuler.
+
+Alias reconnus : `claude` / `claude code`, `codex`, `gemini` / `gemini cli`, `opencode`, `openclaw`, `aider`, `cursor` / `cursor cli`, `hermes`.
+
+## Sémantique partagée
+
+Tous les adaptateurs respectent :
+
+- **Mode plan vocal** — `"plan it first"` narre un plan, édition vocale, `"approve"` exécute via le harness choisi.
+- **Barge-in** — l'interruption coupe le TTS courant et abort la tâche de l'agent. Le routage sticky survit aux interruptions ; seuls les routages à un tour sont effacés.
+- **Progression verbeuse** — `AGENT_VERBOSE_PROGRESS=1` affiche les événements ; avec `SMART_PROGRESS_API_KEY`, un LLM les résume.
+- **Push notification** — `NOTIFY_PROVIDER=ntfy|pushover` + `NOTIFY_MIN_TASK_MS` envoie un push quand une tâche longue se termine et que le canal vocal est vide ; debounce par corps + `NOTIFY_DEBOUNCE_MS`.
+- **État par canal** — chaque canal vocal Discord conserve son routage, son état de plan, son buffer d'énoncés.
+- **Sessions projet** — `!session new <name> <workdir>` lie un canal à un projet ; les adaptateurs (harness, session) sont cachés et invalidés au rebind.
+
+Détails d'installation et pièges par harness dans leurs docs respectifs. Référence env complète : `docs/CONFIGURATION.fr.md`.