verbalcoding 0.2.5 → 0.2.7

package/docs/i18n/README.fr.md

@@ -1,91 +1,66 @@
 # VerbalCoding
 
-<p align="center">
-  <strong>Pilotez vos agents de code CLI à la voix dans Discord, comme au téléphone.</strong>
-</p>
-
-<p align="center">
-  <a href="../../README.md">English</a> ·
-  <a href="README.ko.md">한국어</a> ·
-  <a href="README.ja.md">日本語</a> ·
-  <a href="README.zh.md">中文</a> ·
-  <a href="README.es.md">Español</a> ·
-  <a href="README.fr.md">Français</a> ·
-  <a href="README.ru.md">Русский</a>
-</p>
-
-<p align="center">
-  <img alt="Node.js" src="https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js&logoColor=white">
-  <img alt="Discord" src="https://img.shields.io/badge/Discord-voice%20bridge-5865F2?logo=discord&logoColor=white">
-  <img alt="STT" src="https://img.shields.io/badge/STT-whisper.cpp-7C3AED">
-  <img alt="TTS" src="https://img.shields.io/badge/TTS-Edge%20%7C%20OpenVoice%20%7C%20Supertonic%20%7C%20SpeechSwift-0EA5E9">
-</p>
-
-<p align="center">
-  <img src="../assets/figures/verbalcoding-flow.svg" alt="VerbalCoding voice-to-agent flow" width="860">
-</p>
+**Parlez à vos agents de code en CLI via la voix Discord, comme lors d’un appel.**
+
+[English](../../README.md) · [한국어](README.ko.md) · [日本語](README.ja.md) · [中文](README.zh.md) · [Español](README.es.md) · [Français](README.fr.md) · [Русский](README.ru.md)
+
+![VerbalCoding voice-to-agent flow](../assets/figures/verbalcoding-flow.svg)
 
 ## Why
 
-VerbalCoding transforme un salon vocal Discord en interface mains libres pour agents de code. Dictez une demande, laissez le CLI travailler, puis écoutez une réponse concise — avec transcription texte, événements de progression et garde-fous pour éviter de lire de longs blocs de code ou logs.
+VerbalCoding transforme un salon vocal Discord en interface mains libres pour agents de programmation. Vous dictez une demande, l’agent CLI travaille, puis vous recevez une réponse vocale concise avec transcription texte et événements de progression.
 
-## Points forts
+## Highlights
 
-| Fonction | Pourquoi c’est utile |
+| Feature | What it means |
 |---|---|
-| Contrôle vocal d’abord | Pilotez Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw ou un CLI personnalisé à la voix. |
-| Boucle vocale locale | Voix Discord → STT `whisper.cpp` → agent → lecture TTS par segments. |
-| Contexte partagé voix + texte | Les tours vocaux et `!ask` peuvent réutiliser la même session d’agent compatible. |
-| Interruption et sensibilité | Interrompez naturellement la lecture et basculez entre sensibilité normale ou conservatrice. |
-| Préréglages vocaux multilingues | `vc language ko/en/auto` change ensemble STT, langue de progression et voix TTS. |
-| Isolation par projet | Un bot, profil Hermes, session, mémoire et logs par salon/projet. |
+| Voice-first agent control | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, or a custom CLI harness. |
+| Local-first speech loop | Discord voice capture → `whisper.cpp` STT → agent → chunked TTS playback. |
+| Shared voice + text context | Voice turns and `!ask` text commands can reuse the same supported agent session. |
+| Barge-in and sensitivity modes | Interrupt playback naturally and switch between normal and conservative/noisy modes. |
+| Multilingual voice presets | `vc language ko/en/auto` changes STT, progress language, and TTS voice together. |
+| Multi-room project isolation | Run one bot per project room with isolated Hermes profiles, sessions, memory, and logs. |
 
-## Démarrage rapide
+## Quick Start
 
 ```bash
-git clone git@github.com:ca1773130n/VerbalCoding.git
-cd VerbalCoding
-./scripts/install.sh
+npm install -g verbalcoding
+vc setup --yes
 vc doctor
-./run.sh
+vc start
 ```
 
-## Fonctionnement
-
-```mermaid
-flowchart LR
-  A[Discord voice] --> B["@discordjs/voice"]
-  B --> C[PCM cleanup + gates]
-  C --> D["whisper.cpp STT"]
-  D --> E["CLI agent adapter"]
-  E --> F["Concise answer"]
-  F --> G["Chunked TTS"]
-  G --> H["Discord playback"]
+Run without a permanent global install:
+
+```bash
+npx verbalcoding setup --yes
+vc doctor
+vc start
 ```
 
-## Backends d’agents pris en charge
+Contributor clone path:
+
+```bash
+git clone https://github.com/ca1773130n/VerbalCoding.git
+cd VerbalCoding
+./scripts/install.sh --yes
+vc doctor
+./run.sh
+```
 
-| Backend | Default command | Session support |
-|---|---:|---|
-| Hermes Agent | `hermes chat -Q -q` | Resume, verbose progress, cancellation, final-answer recovery |
-| Claude Code | `claude -p` | CLI session file support through adapter defaults |
-| Codex CLI | `codex exec` | CLI session file support through adapter defaults |
-| Gemini CLI | `gemini -p` | CLI session file support through adapter defaults |
-| OpenCode | `opencode run` | CLI session file support through adapter defaults |
-| OpenClaw | `openclaw run` | CLI session file support through adapter defaults |
-| Custom | `AGENT_COMMAND` | Bring your own non-interactive command |
+`vc setup --yes` and `./scripts/install.sh --yes` bootstrap npm dependencies, `ffmpeg`, `whisper-cli`, the default whisper.cpp model, a local Edge TTS helper, and the short `vc` command where possible.
 
-## En savoir plus
+## Guides
 
-| Guide | What you get |
+| Guide | Link |
 |---|---|
-| [Fresh Install](../FRESH_INSTALL.md) | Installation propre, téléchargement du modèle, premier lancement |
-| [Usage Guide](../USAGE.md) | Commandes CLI, commandes Discord, progression, métriques de latence |
-| [Configuration](../CONFIGURATION.md) | .env, backends agent, MCP, TTS et notes d’exploitation |
-| [Multi-Instance](../MULTI_INSTANCE.md) | Un salon vocal Discord permanent par projet |
-| [Release Notes](../RELEASE.md) | Fonctionnalités actuelles et checklist pré-release |
+| Installation propre | [FRESH_INSTALL.fr.md](FRESH_INSTALL.fr.md) |
+| Guide d’utilisation | [USAGE.fr.md](USAGE.fr.md) |
+| Configuration | [CONFIGURATION.fr.md](CONFIGURATION.fr.md) |
+| Multi-instance | [MULTI_INSTANCE.fr.md](MULTI_INSTANCE.fr.md) |
+| Notes de version | [RELEASE.fr.md](RELEASE.fr.md) |
 
-## Mini carte des commandes
+## Command map
 
 ```bash
 vc status
@@ -94,28 +69,17 @@ vc bot invite CLIENT_ID
 vc instance setup NAME
 vc instance start NAME
 vc doctor
+vc start
 ```
 
-## Prérequis
+Discord commands:
 
-| Layer | Default |
-|---|---|
-| Runtime | Node.js 20+, npm |
-| Audio | `ffmpeg` |
-| STT | `whisper.cpp` / `whisper-cli` |
-| Discord | Bot token, Message Content intent, voice permissions |
-| Agent | At least one authenticated CLI harness, Hermes Agent by default |
-| Platform focus | macOS / Apple Silicon currently gets the most testing |
-
-## Contribuer
-
-```bash
-node --check app-node/main.mjs
-npm test
-bash -n run.sh scripts/install.sh
-vc doctor
+```text
+!join        !ask <prompt>       !verbose on/off
+!latency     !sensitivity normal !sensitivity conservative
+!session new <name> <workdir> [context] --voice <voice-channel>
 ```
 
-## Statut
+## Requirements
 
-VerbalCoding is public-release oriented but still early. Demo video/GIF, broader Linux notes, and a formal license file are still TODOs.
+Node.js 20+, npm, `ffmpeg`, `whisper.cpp` / `whisper-cli`, Edge TTS CLI, a Discord bot token with Message Content intent and voice permissions, and at least one authenticated CLI agent backend.

package/docs/i18n/README.ja.md

@@ -1,91 +1,66 @@
 # VerbalCoding
 
-<p align="center">
-  <strong>Discord音声でCLIコーディングエージェントと通話するように作業できます。</strong>
-</p>
-
-<p align="center">
-  <a href="../../README.md">English</a> ·
-  <a href="README.ko.md">한국어</a> ·
-  <a href="README.ja.md">日本語</a> ·
-  <a href="README.zh.md">中文</a> ·
-  <a href="README.es.md">Español</a> ·
-  <a href="README.fr.md">Français</a> ·
-  <a href="README.ru.md">Русский</a>
-</p>
-
-<p align="center">
-  <img alt="Node.js" src="https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js&logoColor=white">
-  <img alt="Discord" src="https://img.shields.io/badge/Discord-voice%20bridge-5865F2?logo=discord&logoColor=white">
-  <img alt="STT" src="https://img.shields.io/badge/STT-whisper.cpp-7C3AED">
-  <img alt="TTS" src="https://img.shields.io/badge/TTS-Edge%20%7C%20OpenVoice%20%7C%20Supertonic%20%7C%20SpeechSwift-0EA5E9">
-</p>
-
-<p align="center">
-  <img src="../assets/figures/verbalcoding-flow.svg" alt="VerbalCoding voice-to-agent flow" width="860">
-</p>
+**Discord 音声で CLI コーディングエージェントと電話のように作業できます。**
+
+[English](../../README.md) · [한국어](README.ko.md) · [日本語](README.ja.md) · [中文](README.zh.md) · [Español](README.es.md) · [Français](README.fr.md) · [Русский](README.ru.md)
+
+![VerbalCoding voice-to-agent flow](../assets/figures/verbalcoding-flow.svg)
 
 ## Why
 
-VerbalCodingはDiscordの音声チャンネルを、コーディングエージェントのハンズフリー操作面に変えます。声で依頼し、CLIエージェントに作業させ、要点だけを音声で受け取れます。テキスト記録、進捗イベント、コードやログを読み上げすぎないガードも備えています。
+VerbalCoding は Discord の音声チャンネルを、コーディングエージェント向けのハンズフリー操作面に変えます。声で依頼し、CLI エージェントに作業させ、短い音声回答・文字起こし・進捗イベントを受け取れます。
 
-## ハイライト
+## Highlights
 
-| できること | うれしい理由 |
+| Feature | What it means |
 |---|---|
-| 音声ファーストのAgent操作 | Hermes Agent、Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw、カスタムCLIを声で操作できます。 |
-| ローカル優先の音声ループ | Discord音声キャプチャ → `whisper.cpp` STT → Agent → 分割TTS再生。 |
-| 音声とテキストの共有コンテキスト | 対応Agentでは音声ターンと`!ask`テキストコマンドが同じセッションを再利用できます。 |
-| 割り込みと感度モード | 再生中に自然に割り込み、通常/保守的な感度を切り替えられます。 |
-| 多言語音声プリセット | `vc language ko/en/auto`でSTT、進捗言語、TTS音声をまとめて変更できます。 |
-| プロジェクト別マルチルーム分離 | プロジェクトごとにBot、Hermesプロファイル、セッション、メモリ、ログを分離します。 |
+| Voice-first agent control | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, or a custom CLI harness. |
+| Local-first speech loop | Discord voice capture → `whisper.cpp` STT → agent → chunked TTS playback. |
+| Shared voice + text context | Voice turns and `!ask` text commands can reuse the same supported agent session. |
+| Barge-in and sensitivity modes | Interrupt playback naturally and switch between normal and conservative/noisy modes. |
+| Multilingual voice presets | `vc language ko/en/auto` changes STT, progress language, and TTS voice together. |
+| Multi-room project isolation | Run one bot per project room with isolated Hermes profiles, sessions, memory, and logs. |
 
-## クイックスタート
+## Quick Start
 
 ```bash
-git clone git@github.com:ca1773130n/VerbalCoding.git
-cd VerbalCoding
-./scripts/install.sh
+npm install -g verbalcoding
+vc setup --yes
 vc doctor
-./run.sh
+vc start
 ```
 
-## 仕組み
-
-```mermaid
-flowchart LR
-  A[Discord voice] --> B["@discordjs/voice"]
-  B --> C[PCM cleanup + gates]
-  C --> D["whisper.cpp STT"]
-  D --> E["CLI agent adapter"]
-  E --> F["Concise answer"]
-  F --> G["Chunked TTS"]
-  G --> H["Discord playback"]
+Run without a permanent global install:
+
+```bash
+npx verbalcoding setup --yes
+vc doctor
+vc start
 ```
 
-## 対応エージェントバックエンド
+Contributor clone path:
+
+```bash
+git clone https://github.com/ca1773130n/VerbalCoding.git
+cd VerbalCoding
+./scripts/install.sh --yes
+vc doctor
+./run.sh
+```
 
-| Backend | Default command | Session support |
-|---|---:|---|
-| Hermes Agent | `hermes chat -Q -q` | Resume, verbose progress, cancellation, final-answer recovery |
-| Claude Code | `claude -p` | CLI session file support through adapter defaults |
-| Codex CLI | `codex exec` | CLI session file support through adapter defaults |
-| Gemini CLI | `gemini -p` | CLI session file support through adapter defaults |
-| OpenCode | `opencode run` | CLI session file support through adapter defaults |
-| OpenClaw | `openclaw run` | CLI session file support through adapter defaults |
-| Custom | `AGENT_COMMAND` | Bring your own non-interactive command |
+`vc setup --yes` and `./scripts/install.sh --yes` bootstrap npm dependencies, `ffmpeg`, `whisper-cli`, the default whisper.cpp model, a local Edge TTS helper, and the short `vc` command where possible.
 
-## 詳しく見る
+## Guides
 
-| Guide | What you get |
+| Guide | Link |
 |---|---|
-| [Fresh Install](../FRESH_INSTALL.md) | クリーンなクローンからのセットアップ、モデル取得、初回起動 |
-| [Usage Guide](../USAGE.md) | CLIコマンド、Discordコマンド、進捗モード、レイテンシ指標 |
-| [Configuration](../CONFIGURATION.md) | .env、エージェントバックエンド、MCP、TTSバックエンド、運用メモ |
-| [Multi-Instance](../MULTI_INSTANCE.md) | プロジェクトごとに常駐Discord音声ルームを用意 |
-| [Release Notes](../RELEASE.md) | 現在の機能とリリース前チェックリスト |
+| 新規インストール | [FRESH_INSTALL.ja.md](FRESH_INSTALL.ja.md) |
+| 使い方ガイド | [USAGE.ja.md](USAGE.ja.md) |
+| 設定 | [CONFIGURATION.ja.md](CONFIGURATION.ja.md) |
+| マルチインスタンス | [MULTI_INSTANCE.ja.md](MULTI_INSTANCE.ja.md) |
+| リリースノート | [RELEASE.ja.md](RELEASE.ja.md) |
 
-## 小さなコマンド表
+## Command map
 
 ```bash
 vc status
@@ -94,28 +69,17 @@ vc bot invite CLIENT_ID
 vc instance setup NAME
 vc instance start NAME
 vc doctor
+vc start
 ```
 
-## 要件
+Discord commands:
 
-| Layer | Default |
-|---|---|
-| Runtime | Node.js 20+, npm |
-| Audio | `ffmpeg` |
-| STT | `whisper.cpp` / `whisper-cli` |
-| Discord | Bot token, Message Content intent, voice permissions |
-| Agent | At least one authenticated CLI harness, Hermes Agent by default |
-| Platform focus | macOS / Apple Silicon currently gets the most testing |
-
-## コントリビュート
-
-```bash
-node --check app-node/main.mjs
-npm test
-bash -n run.sh scripts/install.sh
-vc doctor
+```text
+!join        !ask <prompt>       !verbose on/off
+!latency     !sensitivity normal !sensitivity conservative
+!session new <name> <workdir> [context] --voice <voice-channel>
 ```
 
-## ステータス
+## Requirements
 
-VerbalCoding is public-release oriented but still early. Demo video/GIF, broader Linux notes, and a formal license file are still TODOs.
+Node.js 20+, npm, `ffmpeg`, `whisper.cpp` / `whisper-cli`, Edge TTS CLI, a Discord bot token with Message Content intent and voice permissions, and at least one authenticated CLI agent backend.

package/docs/i18n/README.ko.md

@@ -1,49 +1,27 @@
 # VerbalCoding
 
-<p align="center">
-  <strong>Discord 음성으로 CLI 코딩 에이전트와 통화하듯 작업하세요.</strong>
-</p>
-
-<p align="center">
-  <a href="../../README.md">English</a> ·
-  <a href="README.ko.md">한국어</a> ·
-  <a href="README.ja.md">日本語</a> ·
-  <a href="README.zh.md">中文</a> ·
-  <a href="README.es.md">Español</a> ·
-  <a href="README.fr.md">Français</a> ·
-  <a href="README.ru.md">Русский</a>
-</p>
-
-<p align="center">
-  <img alt="Node.js" src="https://img.shields.io/badge/Node.js-20%2B-339933?logo=node.js&logoColor=white">
-  <img alt="Discord" src="https://img.shields.io/badge/Discord-voice%20bridge-5865F2?logo=discord&logoColor=white">
-  <img alt="STT" src="https://img.shields.io/badge/STT-whisper.cpp-7C3AED">
-  <img alt="TTS" src="https://img.shields.io/badge/TTS-Edge%20%7C%20OpenVoice%20%7C%20Supertonic%20%7C%20SpeechSwift-0EA5E9">
-  <img alt="Agents" src="https://img.shields.io/badge/Agents-Hermes%20%7C%20Claude%20%7C%20Codex%20%7C%20Gemini%20%7C%20OpenCode-111827">
-</p>
-
-<p align="center">
-  <img src="../assets/figures/verbalcoding-flow.svg" alt="VerbalCoding voice-to-agent flow" width="860">
-</p>
-
-## 왜 필요한가
-
-VerbalCoding은 Discord 음성 채널을 코딩 에이전트용 핸즈프리 조작면으로 바꿉니다. 말로 요청하고, CLI 에이전트가 작업하게 두고, 핵심 답변을 음성으로 다시 들을 수 있습니다. 텍스트 기록, 진행 이벤트, 코드/로그 낭독 방지 장치도 함께 제공합니다.
-
-## 핵심 기능
-
-| 제공 기능 | 좋은 이유 |
-|---|---|
-| 음성 우선 에이전트 제어 | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw 또는 커스텀 CLI를 말로 제어합니다. |
-| 로컬 우선 음성 루프 | Discord 음성 캡처 → `whisper.cpp` STT → 에이전트 → 분할 TTS 재생. |
-| 음성 + 텍스트 컨텍스트 공유 | 지원되는 에이전트에서는 음성 턴과 `!ask` 텍스트 명령이 같은 세션을 재사용합니다. |
-| 끼어들기와 감도 모드 | 재생 중 자연스럽게 끼어들고, 일반/보수 감도 모드를 전환합니다. |
-| 다국어 음성 프리셋 | `vc language ko/en/auto`로 STT, 진행 언어, TTS 음성을 함께 바꿉니다. |
-| 프로젝트별 멀티룸 격리 | 프로젝트 방마다 별도 봇과 Hermes 프로필, 세션, 메모리, 로그를 둡니다. |
+**Discord 음성으로 CLI 코딩 에이전트와 통화하듯 작업하세요.**
+
+[English](../../README.md) · [한국어](README.ko.md) · [日本語](README.ja.md) · [中文](README.zh.md) · [Español](README.es.md) · [Français](README.fr.md) · [Русский](README.ru.md)
+
+![VerbalCoding voice-to-agent flow](../assets/figures/verbalcoding-flow.svg)
+
+## Why
+
+VerbalCoding은 Discord 음성 채널을 코딩 에이전트용 핸즈프리 제어면으로 바꿉니다. 말로 요청하고, CLI 에이전트가 작업하게 두고, 간결한 음성 답변과 텍스트 기록을 함께 받습니다.
+
+## Highlights
 
-## 빠른 시작
+| Feature | What it means |
+|---|---|
+| Voice-first agent control | Hermes Agent, Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, or a custom CLI harness. |
+| Local-first speech loop | Discord voice capture → `whisper.cpp` STT → agent → chunked TTS playback. |
+| Shared voice + text context | Voice turns and `!ask` text commands can reuse the same supported agent session. |
+| Barge-in and sensitivity modes | Interrupt playback naturally and switch between normal and conservative/noisy modes. |
+| Multilingual voice presets | `vc language ko/en/auto` changes STT, progress language, and TTS voice together. |
+| Multi-room project isolation | Run one bot per project room with isolated Hermes profiles, sessions, memory, and logs. |
 
-가장 쉬운 npm 설치:
+## Quick Start
 
 ```bash
 npm install -g verbalcoding
@@ -52,7 +30,7 @@ vc doctor
 vc start
 ```
 
-전역 설치 없이 바로 실행:
+Run without a permanent global install:
 
 ```bash
 npx verbalcoding setup --yes
@@ -60,7 +38,7 @@ vc doctor
 vc start
 ```
 
-기여자용 GitHub 클론:
+Contributor clone path:
 
 ```bash
 git clone https://github.com/ca1773130n/VerbalCoding.git
@@ -70,57 +48,31 @@ vc doctor
 ./run.sh
 ```
 
-`vc setup --yes`와 `./scripts/install.sh --yes`는 가능한 경우 Node/npm 의존성, `ffmpeg`, `whisper-cli`, 기본 whisper.cpp 모델, 로컬 `.venv-tts` Edge TTS helper를 준비합니다. macOS/Homebrew와 일반적인 Linux 패키지 매니저(`apt`, `dnf`, `pacman`)를 지원합니다.
-
-## 동작 방식
-
-```mermaid
-flowchart LR
-  A[Discord voice] --> B["@discordjs/voice"]
-  B --> C[PCM cleanup + gates]
-  C --> D["whisper.cpp STT"]
-  D --> E["CLI agent adapter"]
-  E --> F["Concise answer"]
-  F --> G["Chunked TTS"]
-  G --> H["Discord playback"]
-```
-
-## 지원 에이전트 백엔드
-
-| 백엔드 | 기본 명령 | 세션 지원 |
-|---|---:|---|
-| Hermes Agent | `hermes chat -Q -q` | resume, 자세한 진행, cancellation, 최종 답변 복구 |
-| Claude Code | `claude -p` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
-| Codex CLI | `codex exec` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
-| Gemini CLI | `gemini -p` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
-| OpenCode | `opencode run` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
-| OpenClaw | `openclaw run` | 어댑터 기본값을 통한 CLI 세션 파일 지원 |
-| Custom | `AGENT_COMMAND` | 비대화형 명령을 직접 연결 |
+`vc setup --yes` and `./scripts/install.sh --yes` bootstrap npm dependencies, `ffmpeg`, `whisper-cli`, the default whisper.cpp model, a local Edge TTS helper, and the short `vc` command where possible.
 
-## 더 알아보기
+## Guides
 
-| 문서 | 내용 |
+| Guide | Link |
 |---|---|
-| [새 설치](FRESH_INSTALL.ko.md) | npm 설치, 클린 클론, 모델 다운로드, 첫 실행 |
-| [사용 가이드](USAGE.ko.md) | CLI 명령, Discord 명령, 진행 모드, 지연 시간 지표 |
-| [설정](CONFIGURATION.ko.md) | `.env`, 에이전트 백엔드, MCP, TTS 백엔드, 운영 메모 |
-| [멀티 인스턴스](MULTI_INSTANCE.ko.md) | 프로젝트마다 영구 Discord 음성방 하나씩 운영 |
-| [릴리스 노트](RELEASE.ko.md) | 현재 기능과 릴리스 전 체크리스트 |
-| [English docs](../../README.md) | 영어 canonical README와 문서 |
+| 새 설치 | [FRESH_INSTALL.ko.md](FRESH_INSTALL.ko.md) |
+| 사용 가이드 | [USAGE.ko.md](USAGE.ko.md) |
+| 설정 | [CONFIGURATION.ko.md](CONFIGURATION.ko.md) |
+| 멀티 인스턴스 | [MULTI_INSTANCE.ko.md](MULTI_INSTANCE.ko.md) |
+| 릴리스 노트 | [RELEASE.ko.md](RELEASE.ko.md) |
 
-## 작은 명령 지도
+## Command map
 
 ```bash
-vc status                 # 현재 언어, TTS, 브릿지 설정 보기
-vc language ko|en|auto    # STT/진행/TTS 언어 프리셋 전환
-vc bot invite CLIENT_ID   # Discord 봇 초대 URL 생성
-vc instance setup NAME    # 격리된 프로젝트 음성 봇 생성
-vc instance start NAME    # 해당 봇을 백그라운드로 실행
-vc doctor                 # 비밀값을 숨긴 상태 점검
-vc start                  # 기본 브릿지 시작
+vc status
+vc language ko|en|auto
+vc bot invite CLIENT_ID
+vc instance setup NAME
+vc instance start NAME
+vc doctor
+vc start
 ```
 
-Discord에서:
+Discord commands:
 
 ```text
 !join        !ask <prompt>       !verbose on/off
@@ -128,30 +80,6 @@ Discord에서:
 !session new <name> <workdir> [context] --voice <voice-channel>
 ```
 
-## 요구 사항
-
-| 계층 | 기본값 |
-|---|---|
-| Runtime | Node.js 20+, npm; 설치 스크립트가 Homebrew/apt/dnf/pacman으로 설치 시도 |
-| Audio | `ffmpeg`; 설치 스크립트가 설치 시도 |
-| STT | `whisper.cpp` / `whisper-cli`; macOS는 Homebrew, Linux는 로컬 빌드 fallback |
-| TTS | Edge TTS CLI; 필요하면 `.venv-tts` 생성 |
-| Discord | Bot token, Message Content intent, voice permissions |
-| Agent | 인증된 CLI 하네스 하나 이상; 기본은 Hermes Agent |
-| Platform focus | macOS / Apple Silicon을 가장 많이 테스트; Linux bootstrap은 best-effort |
-
-## 기여
-
-변경 전 가벼운 검증:
-
-```bash
-node --check app-node/main.mjs
-npm test
-bash -n run.sh scripts/install.sh
-npm pack --dry-run
-vc doctor
-```
-
-## 상태
+## Requirements
 
-VerbalCoding은 공개 릴리스를 지향하지만 아직 초기 단계입니다. 데모 영상/GIF, 더 넓은 Linux 검증, CI와 보안 리뷰를 계속 보강하면 좋습니다.
+Node.js 20+, npm, `ffmpeg`, `whisper.cpp` / `whisper-cli`, Edge TTS CLI, a Discord bot token with Message Content intent and voice permissions, and at least one authenticated CLI agent backend.