verbalcoding 0.2.11 → 0.2.13

package/docs/i18n/HARNESS_HERMES.ko.md

@@ -0,0 +1,57 @@
+# Hermes Agent — 하니스 노트
+
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="HARNESSES.ko.md">하니스</a> ·
+  <a href="USAGE.ko.md">사용법</a> ·
+  <a href="CONFIGURATION.ko.md">설정</a>
+</p>
+
+Hermes Agent는 VerbalCoding의 기본 백엔드이고, 진짜 세션 재개 계약이 있는 유일한 하니스야. 턴 사이 컨텍스트가 깔끔하게 유지돼. Hermes 내장 `/voice` 슬래시 명령과의 포지셔닝 비교는 [HERMES_VOICE.ko.md](./HERMES_VOICE.ko.md).
+
+## 설치
+
+상위 Hermes Agent 설치 가이드: <https://hermes-agent.nousresearch.com>.
+
+CLI 단독 동작부터 확인해줘:
+
+```bash
+hermes chat -Q -q "hello"
+```
+
+## VerbalCoding 설정
+
+```bash
+# .env
+AGENT_BACKEND=hermes
+# 선택
+HERMES_COMMAND="hermes chat -Q -q"           # 기본값
+HERMES_HOME=/Users/you/.hermes               # 인스턴스별 Hermes 홈
+HERMES_PROJECT_CONTEXT="Project session: ..."
+HERMES_TASK_TIMEOUT_MS=0                     # 0 = 무제한
+HERMES_CHAT_TIMEOUT_MS=45000
+HERMES_WORKDIR=/Users/you/code/your-project
+```
+
+세션 파일 기본 위치는 `<repo>/.verbalcoding-session` (덮어쓰려면 `HERMES_SESSION_FILE`).
+
+## 세션 재개
+
+Hermes는 내장 어댑터 중 유일하게 세션 재개를 지원해. 턴이 성공할 때마다 새 `session_id`를 디스크에 쓰고 다음 호출에 `--resume <id>`를 앞에 붙여. `!session reset`(또는 `!reset-session`)으로 그 파일을 지울 수 있어.
+
+Hermes가 stderr에 `session_id:`를 emit하기 전에 턴이 abort되면, 어댑터가 `~/.hermes/sessions/session_<id>.json`을 직접 읽어서 마지막 어시스턴트 메시지를 복구해.
+
+## 상세 진행
+
+상세 모드에서는 어댑터가 Hermes의 `-Q` quiet 플래그를 떼서 stdout으로 `┊ <emoji> <tool>` 미리보기가 흘러나와. 이걸 한 줄짜리 진행 이벤트(파일 읽기, 웹 검색, 터미널 실행 등)로 요약해. 상세 모드가 꺼져 있으면 박스 안의 최종 답변만 음성으로 나가.
+
+## Hermes로 전환하는 음성 표현
+
+- en: `"switch to Hermes"`, `"ask Hermes ..."`
+- ko: `"헤르메스로 전환"`, `"헤르메스한테 물어봐"`
+
+## 함정
+
+- 크로스 에이전트 핸드오프 시 TTS 접두사는 로케일에 맞춰서 `"Hermes says: "` / `"헤르메스: "`로 붙어.
+- `HERMES_HOME`은 프로젝트별 격리에 가장 많이 쓰이는 노브야. 인스턴스 `.env`는 보통 `HERMES_HOME=/Users/you/.hermes/profiles/<project>` 식으로 설정.
+- 상세 모드 켜고도 Hermes가 빈 박스로 끝나는 경우(타임아웃 등), 어댑터가 포기하기 전에 세션 JSON을 긁어서 최종 답변을 찾아내.

package/docs/i18n/HARNESS_HERMES.ru.md

@@ -0,0 +1,54 @@
+# Hermes Agent — Заметки по harness
+
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="HARNESSES.ru.md">Harness-ы</a> ·
+  <a href="USAGE.ru.md">Использование</a> ·
+  <a href="CONFIGURATION.ru.md">Настройка</a>
+</p>
+
+Hermes Agent — backend VerbalCoding по умолчанию и единственный harness с настоящим контрактом возобновления сессии: контекст между turn-ами держится чисто. Сравнение со встроенным `/voice` Hermes — в [HERMES_VOICE.ru.md](./HERMES_VOICE.ru.md).
+
+## Установка
+
+Официальный гайд: <https://hermes-agent.nousresearch.com>. Сначала проверьте CLI:
+
+```bash
+hermes chat -Q -q "hello"
+```
+
+## Настройка
+
+```bash
+# .env
+AGENT_BACKEND=hermes
+HERMES_COMMAND="hermes chat -Q -q"
+HERMES_HOME=/Users/you/.hermes
+HERMES_PROJECT_CONTEXT="Project session: ..."
+HERMES_TASK_TIMEOUT_MS=0
+HERMES_CHAT_TIMEOUT_MS=45000
+HERMES_WORKDIR=/Users/you/code/your-project
+```
+
+Файл сессии лежит в `<repo>/.verbalcoding-session` (можно переопределить через `HERMES_SESSION_FILE`).
+
+## Возобновление сессии
+
+Hermes — единственный встроенный адаптер с возобновлением. После каждого успешного turn адаптер пишет новый `session_id` на диск и добавляет `--resume <id>` к следующему вызову. `!session reset` очищает файл.
+
+Если turn был abort до того, как Hermes выдал `session_id:` в stderr, адаптер читает `~/.hermes/sessions/session_<id>.json`, чтобы восстановить последний ответ ассистента.
+
+## Подробный прогресс
+
+В подробном режиме адаптер убирает флаг `-Q`, и в stdout начинают идти превью `┊ <emoji> <tool>`. Они сводятся в однострочные события прогресса (чтение файлов, веб-поиск, терминал). Без подробного режима в голос идёт только финальный ответ в рамке.
+
+## Голосовые фразы для переключения на Hermes
+
+- en: `"switch to Hermes"`, `"ask Hermes ..."`
+- ru: `"переключись на Hermes"`, `"спроси Hermes"`
+
+## Подводные камни
+
+- TTS-префикс при handoff локализован: `"Hermes says: "` / `"Hermes: "`.
+- `HERMES_HOME` — самый частый рычаг изоляции проекта; обычно `HERMES_HOME=/Users/you/.hermes/profiles/<project>` в `.env` инстанса.
+- В подробном режиме при пустой рамке от Hermes (таймаут) адаптер залезет в JSON сессии за финальным ответом.

package/docs/i18n/HARNESS_HERMES.zh.md

@@ -0,0 +1,57 @@
+# Hermes Agent — Harness 说明
+
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="HARNESSES.zh.md">Harness</a> ·
+  <a href="USAGE.zh.md">使用</a> ·
+  <a href="CONFIGURATION.zh.md">配置</a>
+</p>
+
+Hermes Agent 是 VerbalCoding 的默认后端,也是唯一拥有真正会话续接契约的 harness。turn 之间上下文保持干净。关于 Hermes 内建 `/voice` 的对比,见 [HERMES_VOICE.zh.md](./HERMES_VOICE.zh.md)。
+
+## 安装
+
+参考上游 Hermes Agent 安装指引: <https://hermes-agent.nousresearch.com>。
+
+先确认 CLI 单独可用:
+
+```bash
+hermes chat -Q -q "hello"
+```
+
+## VerbalCoding 配置
+
+```bash
+# .env
+AGENT_BACKEND=hermes
+# 可选
+HERMES_COMMAND="hermes chat -Q -q"           # 默认
+HERMES_HOME=/Users/you/.hermes               # 每实例 Hermes 主目录
+HERMES_PROJECT_CONTEXT="Project session: ..."
+HERMES_TASK_TIMEOUT_MS=0                     # 0 = 不限
+HERMES_CHAT_TIMEOUT_MS=45000
+HERMES_WORKDIR=/Users/you/code/your-project
+```
+
+会话文件默认 `<repo>/.verbalcoding-session` (用 `HERMES_SESSION_FILE` 覆盖)。
+
+## 会话续接
+
+Hermes 是内建适配器中唯一支持会话续接的。每次成功 turn 后适配器将新 `session_id` 写入磁盘,下次调用前置 `--resume <id>`。`!session reset` (或 `!reset-session`) 清除。
+
+若 Hermes 在 stderr 输出 `session_id:` 之前被 abort,适配器会读取 `~/.hermes/sessions/session_<id>.json` 找回最后一条助手消息。
+
+## 详细进度
+
+详细模式下,适配器去掉 Hermes 的 `-Q` 静默标志,stdout 会流出 `┊ <emoji> <tool>` 预览,被汇总为一行进度事件 (文件读取、网页搜索、终端执行等)。非详细模式只把最终框内回答念出。
+
+## 切到 Hermes 的语音表述
+
+- en: `"switch to Hermes"`、`"ask Hermes ..."`
+- zh: `"切到 Hermes"`、`"问 Hermes"`
+
+## 坑
+
+- 跨代理切换时的 TTS 前缀按语言: `"Hermes says: "` / `"Hermes:"`。
+- `HERMES_HOME` 是最常用的项目级隔离开关。实例 `.env` 通常设 `HERMES_HOME=/Users/you/.hermes/profiles/<project>`。
+- 详细模式开启但 Hermes 以空框结束 (超时) 时,适配器会在放弃前抓会话 JSON 找最终回答。

package/docs/i18n/HARNESS_OPENCLAW.es.md

@@ -0,0 +1,41 @@
+# OpenClaw — Notas del Harness
+
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="HARNESSES.es.md">Harnesses</a> ·
+  <a href="USAGE.es.md">Uso</a> ·
+  <a href="CONFIGURATION.es.md">Configuración</a>
+</p>
+
+OpenClaw es un agente de codificación de terminal open source. VerbalCoding lo invoca con `openclaw run`.
+
+## Instalación
+
+```bash
+openclaw run "hello"
+```
+
+## Configuración
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+OPENCLAW_COMMAND="openclaw run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Frases de voz para cambiar a OpenClaw
+
+- en: `"switch to OpenClaw"`, `"switch to open claw"`
+- es: `"cambia a OpenClaw"`
+
+Alias: `openclaw`, `open claw`.
+
+## Trampas
+
+- **Sin reanudación por defecto.** Añade la flag adecuada en `OPENCLAW_COMMAND` si tu build la soporta.
+- **Progreso detallado.** Igual que OpenCode: keywords + posible LLM summarizer.
+- **Colisión de nombres.** Los alias `openclaw` y la etiqueta `OpenClaw` se distinguen claramente de `claude` / `claude code`; el modo strict del router no los confunde.

package/docs/i18n/HARNESS_OPENCLAW.fr.md

@@ -0,0 +1,41 @@
+# OpenClaw — Notes Harness
+
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="HARNESSES.fr.md">Harnesses</a> ·
+  <a href="USAGE.fr.md">Utilisation</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a>
+</p>
+
+OpenClaw est un agent terminal open source. VerbalCoding l'invoque via `openclaw run`.
+
+## Installation
+
+```bash
+openclaw run "hello"
+```
+
+## Configuration
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+OPENCLAW_COMMAND="openclaw run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Phrases vocales pour basculer vers OpenClaw
+
+- en: `"switch to OpenClaw"`, `"switch to open claw"`
+- fr: `"passe à OpenClaw"`
+
+Alias : `openclaw`, `open claw`.
+
+## Pièges
+
+- **Pas de reprise par défaut.** Ajoutez le flag adéquat à `OPENCLAW_COMMAND` si la build le supporte.
+- **Progression verbeuse.** Identique à OpenCode.
+- **Collision de noms.** Les alias `openclaw` et l'étiquette `OpenClaw` se distinguent clairement de `claude` / `claude code` ; le mode strict du routeur ne les confond pas.

package/docs/i18n/HARNESS_OPENCLAW.ja.md

@@ -0,0 +1,44 @@
+# OpenClaw — ハーネスノート
+
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="HARNESSES.ja.md">ハーネス</a> ·
+  <a href="USAGE.ja.md">使い方</a> ·
+  <a href="CONFIGURATION.ja.md">設定</a>
+</p>
+
+OpenClaw はオープンソースのターミナルコーディングエージェント。VerbalCoding は `openclaw run` で呼び出します。
+
+## インストール
+
+上流 OpenClaw インストールガイドに従い、確認:
+
+```bash
+openclaw run "hello"
+```
+
+## VerbalCoding 設定
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+# 任意
+OPENCLAW_COMMAND="openclaw run"             # 既定
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## OpenClaw へ切り替える音声表現
+
+- en: `"switch to OpenClaw"`, `"ask OpenClaw ..."`, `"switch to open claw"`
+- ja: `"OpenClaw に切り替えて"`
+
+エイリアス: `openclaw`, `open claw`。
+
+## 罠
+
+- **既定コマンドはセッション再開なし。** ビルドが resume フラグをサポートしていれば `OPENCLAW_COMMAND` に追加。
+- **詳細進捗。** OpenCode と同じく、`SMART_PROGRESS_API_KEY` なしではキーワードベースのラベルにフォールバック。
+- **名前衝突。** パーサのエイリアス `openclaw` とラベル `OpenClaw` は `claude` / `claude code` と明確に区別。strict モードのルータが両者を混同しません。

package/docs/i18n/HARNESS_OPENCLAW.ko.md

@@ -0,0 +1,44 @@
+# OpenClaw — 하니스 노트
+
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="HARNESSES.ko.md">하니스</a> ·
+  <a href="USAGE.ko.md">사용법</a> ·
+  <a href="CONFIGURATION.ko.md">설정</a>
+</p>
+
+OpenClaw는 오픈소스 터미널 코딩 에이전트. VerbalCoding은 `openclaw run`으로 호출해.
+
+## 설치
+
+상위 OpenClaw 설치 가이드를 따르고 확인:
+
+```bash
+openclaw run "hello"
+```
+
+## VerbalCoding 설정
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+# 선택
+OPENCLAW_COMMAND="openclaw run"             # 기본값
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## OpenClaw로 전환하는 음성 표현
+
+- en: `"switch to OpenClaw"`, `"ask OpenClaw ..."`, `"switch to open claw"`
+- ko: `"openclaw로 전환"`
+
+매처가 받는 별칭: `openclaw`, `open claw`.
+
+## 함정
+
+- **기본 명령에는 세션 재개 없음.** 빌드가 resume 플래그를 지원하면 `OPENCLAW_COMMAND`에 추가.
+- **상세 진행.** OpenCode와 동일 — `SMART_PROGRESS_API_KEY`가 없으면 키워드 기반 라벨로 fallback.
+- **이름 혼동.** 파서 별칭 `openclaw`와 사용자용 라벨 `OpenClaw`는 `claude` / `claude code`와 명확히 구분돼. strict 모드 라우터가 둘을 혼동하지 않아.

package/docs/i18n/HARNESS_OPENCLAW.ru.md

@@ -0,0 +1,41 @@
+# OpenClaw — Заметки по harness
+
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="HARNESSES.ru.md">Harness-ы</a> ·
+  <a href="USAGE.ru.md">Использование</a> ·
+  <a href="CONFIGURATION.ru.md">Настройка</a>
+</p>
+
+OpenClaw — open-source терминальный кодинг-агент. VerbalCoding вызывает его через `openclaw run`.
+
+## Установка
+
+```bash
+openclaw run "hello"
+```
+
+## Настройка
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+OPENCLAW_COMMAND="openclaw run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Голосовые фразы для переключения на OpenClaw
+
+- en: `"switch to OpenClaw"`, `"switch to open claw"`
+- ru: `"переключись на OpenClaw"`
+
+Алиасы: `openclaw`, `open claw`.
+
+## Подводные камни
+
+- **По умолчанию нет возобновления.** Если сборка поддерживает — добавьте флаг в `OPENCLAW_COMMAND`.
+- **Подробный прогресс.** Как у OpenCode.
+- **Коллизия имён.** Алиас `openclaw` и метка `OpenClaw` чётко отделены от `claude` / `claude code`; strict-режим маршрутизатора их не путает.

package/docs/i18n/HARNESS_OPENCLAW.zh.md

@@ -0,0 +1,42 @@
+# OpenClaw — Harness 说明
+
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="HARNESSES.zh.md">Harness</a> ·
+  <a href="USAGE.zh.md">使用</a> ·
+  <a href="CONFIGURATION.zh.md">配置</a>
+</p>
+
+OpenClaw 是开源终端编码代理。VerbalCoding 通过 `openclaw run` 驱动。
+
+## 安装
+
+```bash
+openclaw run "hello"
+```
+
+## VerbalCoding 配置
+
+```bash
+# .env
+AGENT_BACKEND=openclaw
+# 可选
+OPENCLAW_COMMAND="openclaw run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## 切到 OpenClaw 的语音表述
+
+- en: `"switch to OpenClaw"`、`"switch to open claw"`
+- zh: `"切到 OpenClaw"`
+
+别名: `openclaw`、`open claw`。
+
+## 坑
+
+- **默认命令无会话续接。** 若构建支持 resume,加入 `OPENCLAW_COMMAND`。
+- **详细进度。** 与 OpenCode 相同 — 无 `SMART_PROGRESS_API_KEY` 时回退到关键字标签。
+- **名称冲突。** 解析器别名 `openclaw` 与用户标签 `OpenClaw` 与 `claude` / `claude code` 明确区分,strict 模式不会混淆。

package/docs/i18n/HARNESS_OPENCODE.es.md

@@ -0,0 +1,41 @@
+# OpenCode — Notas del Harness
+
+<p align="center">
+  <a href="../../README.es.md">README</a> ·
+  <a href="HARNESSES.es.md">Harnesses</a> ·
+  <a href="USAGE.es.md">Uso</a> ·
+  <a href="CONFIGURATION.es.md">Configuración</a>
+</p>
+
+OpenCode es un agente de codificación de terminal open source. VerbalCoding lo invoca con `opencode run`.
+
+## Instalación
+
+```bash
+opencode run "hello"
+```
+
+## Configuración
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+OPENCODE_COMMAND="opencode run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Frases de voz para cambiar a OpenCode
+
+- en: `"switch to OpenCode"`, `"switch to open code"`
+- es: `"cambia a OpenCode"`
+
+Alias: `opencode`, `open code`.
+
+## Trampas
+
+- **Sin reanudación por defecto.** Si tu build soporta resume, añádelo: `OPENCODE_COMMAND="opencode run --resume"`.
+- **Selección de modelo.** Añade `--model` u otras flags en `OPENCODE_COMMAND`.
+- **Progreso detallado.** Coincidencia por keywords sobre stdout/stderr (lectura, búsqueda, terminal). Sin `SMART_PROGRESS_API_KEY`, fallback a labels raw.

package/docs/i18n/HARNESS_OPENCODE.fr.md

@@ -0,0 +1,41 @@
+# OpenCode — Notes Harness
+
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="HARNESSES.fr.md">Harnesses</a> ·
+  <a href="USAGE.fr.md">Utilisation</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a>
+</p>
+
+OpenCode est un agent terminal open source. VerbalCoding l'invoque via `opencode run`.
+
+## Installation
+
+```bash
+opencode run "hello"
+```
+
+## Configuration
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+OPENCODE_COMMAND="opencode run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Phrases vocales pour basculer vers OpenCode
+
+- en: `"switch to OpenCode"`, `"switch to open code"`
+- fr: `"passe à OpenCode"`
+
+Alias : `opencode`, `open code`.
+
+## Pièges
+
+- **Pas de reprise par défaut.** Si votre build supporte resume, ajoutez le flag dans `OPENCODE_COMMAND`.
+- **Choix de modèle.** Ajoutez `--model` ou autres flags dans `OPENCODE_COMMAND`.
+- **Progression verbeuse.** Matching par mots-clés sur stdout/stderr ; sans `SMART_PROGRESS_API_KEY`, fallback sur les labels bruts.

package/docs/i18n/HARNESS_OPENCODE.ja.md

@@ -0,0 +1,44 @@
+# OpenCode — ハーネスノート
+
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="HARNESSES.ja.md">ハーネス</a> ·
+  <a href="USAGE.ja.md">使い方</a> ·
+  <a href="CONFIGURATION.ja.md">設定</a>
+</p>
+
+OpenCode はオープンソースのターミナルコーディングエージェント。VerbalCoding は `opencode run` で呼び出します。
+
+## インストール
+
+上流 OpenCode インストールガイドに従い、確認:
+
+```bash
+opencode run "hello"
+```
+
+## VerbalCoding 設定
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+# 任意
+OPENCODE_COMMAND="opencode run"             # 既定
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## OpenCode へ切り替える音声表現
+
+- en: `"switch to OpenCode"`, `"ask OpenCode ..."`, `"switch to open code"`
+- ja: `"OpenCode に切り替えて"`
+
+エイリアス: `opencode`, `open code`。
+
+## 罠
+
+- **既定コマンドはセッション再開なし。** OpenCode ビルドが resume フラグをサポートしていれば `OPENCODE_COMMAND="opencode run --resume"` のように付与 (アダプタは prompt を最後の positional 引数として渡す)。
+- **モデル選択。** OpenCode ビルドが `--model` フラグを要求するなら `OPENCODE_COMMAND` に追加。
+- **詳細進捗。** stdout/stderr のイベントをキーワードでマッチ (ファイル読み込み、Web 検索、ターミナル等)。`SMART_PROGRESS_API_KEY` なしでは raw ラベルにフォールバック。

package/docs/i18n/HARNESS_OPENCODE.ko.md

@@ -0,0 +1,44 @@
+# OpenCode — 하니스 노트
+
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="HARNESSES.ko.md">하니스</a> ·
+  <a href="USAGE.ko.md">사용법</a> ·
+  <a href="CONFIGURATION.ko.md">설정</a>
+</p>
+
+OpenCode는 오픈소스 터미널 코딩 에이전트. VerbalCoding은 `opencode run`으로 호출해.
+
+## 설치
+
+상위 OpenCode 설치 가이드를 따르고 확인:
+
+```bash
+opencode run "hello"
+```
+
+## VerbalCoding 설정
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+# 선택
+OPENCODE_COMMAND="opencode run"             # 기본값
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## OpenCode로 전환하는 음성 표현
+
+- en: `"switch to OpenCode"`, `"ask OpenCode ..."`, `"switch to open code"`
+- ko: `"opencode로 전환"`, `"오픈코드로 전환"`
+
+매처가 받는 별칭: `opencode`, `open code`.
+
+## 함정
+
+- **기본 명령에는 세션 재개 없음.** 사용 중인 OpenCode 빌드가 resume 플래그를 지원하면 `OPENCODE_COMMAND="opencode run --resume"`처럼 붙여줘 (어댑터는 prompt를 마지막 positional 인자로 넘김).
+- **모델 선택.** OpenCode 빌드가 `--model` 플래그를 요구하면 `OPENCODE_COMMAND`에 그대로 추가.
+- **상세 진행.** stdout/stderr에 나오는 이벤트가 키워드 매칭으로 잡혀 (파일 읽기, 웹 검색, 터미널). `SMART_PROGRESS_API_KEY`가 없으면 bridge가 raw 라벨로 fallback.

package/docs/i18n/HARNESS_OPENCODE.ru.md

@@ -0,0 +1,41 @@
+# OpenCode — Заметки по harness
+
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="HARNESSES.ru.md">Harness-ы</a> ·
+  <a href="USAGE.ru.md">Использование</a> ·
+  <a href="CONFIGURATION.ru.md">Настройка</a>
+</p>
+
+OpenCode — open-source терминальный кодинг-агент. VerbalCoding вызывает его через `opencode run`.
+
+## Установка
+
+```bash
+opencode run "hello"
+```
+
+## Настройка
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+OPENCODE_COMMAND="opencode run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Голосовые фразы для переключения на OpenCode
+
+- en: `"switch to OpenCode"`, `"switch to open code"`
+- ru: `"переключись на OpenCode"`
+
+Алиасы: `opencode`, `open code`.
+
+## Подводные камни
+
+- **По умолчанию нет возобновления.** Если ваша сборка поддерживает resume — добавьте флаг в `OPENCODE_COMMAND`.
+- **Выбор модели.** Добавляйте `--model` и прочие флаги прямо в `OPENCODE_COMMAND`.
+- **Подробный прогресс.** Матчинг по ключевым словам по stdout/stderr; без `SMART_PROGRESS_API_KEY` fallback на сырые лейблы.