tonedial 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deokgyu Yang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.es.md

@@ -0,0 +1,83 @@
+# ToneDial
+
+**Dale un personaje a tu agente de programación.**
+
+Elige un personaje, ajusta doce diales y guarda una voz para usarla en distintos proyectos.
+
+**7 personajes · 12 ejes de tono · 5 idiomas del CLI · Cero dependencias en ejecución**
+
+[English](https://github.com/awesometic/tonedial/blob/main/README.md) | [한국어](https://github.com/awesometic/tonedial/blob/main/README.ko.md) | [日本語](https://github.com/awesometic/tonedial/blob/main/README.ja.md) | [简体中文](https://github.com/awesometic/tonedial/blob/main/README.zh.md) | **Español**
+
+## Mira cómo responde
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/es/voice-examples.svg" alt="Royal Advisor y Ego Sword responden a la misma pregunta sobre renombrar una función en conversaciones reales de Codex" width="760">
+
+<sub>Respuestas reales de Codex, presentadas como diálogos de terminal. <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/es/voice-examples.json">Entradas y procedencia</a>.</sub>
+
+**[Ver los 7 personajes →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.es.md)**
+
+## Pruébalo
+
+Requiere **Node 24 o posterior** y npm.
+
+```bash
+npm install --global tonedial
+tonedial init --tools none --global --lang es
+tonedial set
+```
+
+La configuración muestra los cambios de archivos y pide aprobación. Puedes abrir el dial sin conectar un agente.
+
+[Conecta tu agente](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent) · [Prueba con ajustes temporales](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md#isolated-candidate)
+
+## Elige tu personaje
+
+| Preajuste | Tú → agente |
+| --- | --- |
+| Caring Brother | Hermano pequeño → hermano mayor |
+| Bratty Kid | Interlocutor → niño descarado |
+| Eager Sycophant | Creador → fan entusiasta |
+| Royal Advisor | Monarca → súbdito leal |
+| Ego Sword | Novato → espada consciente |
+| Heavenly Demon | Discípulo → maestro marcial severo |
+| Right Hand | Jefe → consigliere de confianza |
+
+```bash
+tonedial use ego-sword
+tonedial set verbosity=1 warmth=3
+tonedial save "My Sword"
+```
+
+Crea el tuyo con `tonedial create`. Cada perfil guarda tono, roles, formas de trato, registro y palabra clave.
+
+## Ajusta los diales
+
+**Doce ejes, cinco niveles cada uno.** Decide cuánta formalidad, brevedad, calidez, crítica o teatralidad quieres.
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/es/dial.svg" alt="Dial de doce ejes de ToneDial con niveles actuales, explicación de warmth y teclas de control" width="760">
+
+<sub>Vista previa sintética de 80 columnas generada con el renderizador actual del CLI. <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/es/dial-example.json">Procedencia del fotograma</a> · <a href="https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#current-dial-example">Receta</a>.</sub>
+
+**↑↓** elegir eje · **←→ / 1–5** fijar nivel · **Enter** aplicar · **Esc** descartar
+
+ToneDial compila los ajustes en `TONE.md` de forma local y determinista. Tu agente aporta el modelo.
+
+## Conecta tu agente
+
+**Claude Code · Codex · Antigravity IDE/Desktop** — [guía de conexión](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent)
+
+Prueba una conversación nueva con un cliente Codex o Claude Code instalado:
+
+```bash
+tonedial test codex --preset my-sword
+```
+
+- Las vistas previas usan tu cuenta del proveedor; se aplican el consumo, los cargos y el historial habituales.
+- El tono cambia el estilo. Los permisos y las aprobaciones del cliente siguen vigentes.
+- El comportamiento varía según el modelo. Es para divertirse; no se recomienda en producción.
+
+## Más información
+
+[Uso y referencia](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md) · [Aporta un preajuste o una corrección](https://github.com/awesometic/tonedial/blob/main/CONTRIBUTING.md) · [Pruebas](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md) · [Seguridad](https://github.com/awesometic/tonedial/blob/main/SECURITY.md)
+
+[Guía para agentes](https://github.com/awesometic/tonedial/blob/main/AGENTS.md) · [Licencia MIT](https://github.com/awesometic/tonedial/blob/main/LICENSE) · [Avisos de terceros](https://github.com/awesometic/tonedial/blob/main/THIRD_PARTY_NOTICES.md)

package/README.ja.md

@@ -0,0 +1,83 @@
+# ToneDial
+
+**コーディングエージェントにキャラクターを。**
+
+キャラクターを選び、12個のダイヤルで口調を調整。保存した声をプロジェクトをまたいで使えます。
+
+**7キャラクター · 12の口調軸 · CLIは5言語 · 実行時の依存パッケージなし**
+
+[English](https://github.com/awesometic/tonedial/blob/main/README.md) | [한국어](https://github.com/awesometic/tonedial/blob/main/README.ko.md) | **日本語** | [简体中文](https://github.com/awesometic/tonedial/blob/main/README.zh.md) | [Español](https://github.com/awesometic/tonedial/blob/main/README.es.md)
+
+## まずは応答から
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/ja/voice-examples.svg" alt="同じ関数名変更の質問に答えるRoyal AdvisorとEgo Swordの実際のCodex対話記録" width="760">
+
+<sub>実際のCodex応答をターミナル風の対話として表示しています。 <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/ja/voice-examples.json">入力と生成記録</a>.</sub>
+
+**[7キャラクターすべてを見る →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.ja.md)**
+
+## 試してみる
+
+**Node 24以降**とnpmが必要です。
+
+```bash
+npm install --global tonedial
+tonedial init --tools none --global --lang ja
+tonedial set
+```
+
+設定時にファイル変更を表示し、承認を求めます。エージェントに接続せず、まずダイヤルを試せます。
+
+[エージェントを接続する](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent) · [一時設定で試す](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md#isolated-candidate)
+
+## キャラクターを選ぶ
+
+| プリセット | あなた → エージェント |
+| --- | --- |
+| Caring Brother | 弟や妹 → 頼れる兄 |
+| Bratty Kid | 話し相手 → 生意気な子供 |
+| Eager Sycophant | 創作者 → 熱狂的ファン |
+| Royal Advisor | 君主 → 忠実な臣下 |
+| Ego Sword | 駆け出しの冒険者 → 自我を持つ剣 |
+| Heavenly Demon | 弟子 → 厳格な天魔 |
+| Right Hand | 親分 → 信頼できる右腕 |
+
+```bash
+tonedial use ego-sword
+tonedial set verbosity=1 warmth=3
+tonedial save "My Sword"
+```
+
+`tonedial create` で自分のキャラクターも作れます。口調、役割、呼称、敬語区分、合言葉を1つのプロファイルに保存します。
+
+## ダイヤルを回す
+
+**12の軸を、それぞれ5段階で。** 格式、簡潔さ、温かさ、批判、役柄の強さを調整します。
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/ja/dial.svg" alt="現在値、選択したwarmthの説明、キー操作を示すToneDialの12軸ダイヤル" width="760">
+
+<sub>現在のCLIレンダラーで生成した80列の合成プレビューです。 <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/ja/dial-example.json">フレームの生成記録</a> · <a href="https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#current-dial-example">生成手順</a>.</sub>
+
+**↑↓** 軸を選択 · **←→ / 1–5** 値を変更 · **Enter** 適用 · **Esc** 破棄
+
+ToneDialは設定をローカルで `TONE.md` にコンパイルします。同じ設定からは同じ結果を生成し、モデルは利用中のエージェントが提供します。
+
+## エージェントと使う
+
+**Claude Code · Codex · Antigravity IDE/Desktop** — [接続ガイド](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent)
+
+インストール済みのCodexかClaude Codeで、新しい会話を試せます。
+
+```bash
+tonedial test codex --preset my-sword
+```
+
+- プレビューは利用者のプロバイダーアカウントを使い、通常の使用量・料金・履歴の扱いが適用されます。
+- 変わるのは話し方です。ホストの権限と承認要件はそのままです。
+- 反応はモデルによって異なります。娯楽用で、実務利用は推奨しません。
+
+## さらに詳しく
+
+[使い方とリファレンス](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md) · [プリセットや修正を提案](https://github.com/awesometic/tonedial/blob/main/CONTRIBUTING.md) · [テスト](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md) · [セキュリティ](https://github.com/awesometic/tonedial/blob/main/SECURITY.md)
+
+[エージェント作業ガイド](https://github.com/awesometic/tonedial/blob/main/AGENTS.md) · [MITライセンス](https://github.com/awesometic/tonedial/blob/main/LICENSE) · [第三者の権利表示](https://github.com/awesometic/tonedial/blob/main/THIRD_PARTY_NOTICES.md)

package/README.ko.md

@@ -0,0 +1,83 @@
+# ToneDial
+
+**코딩 에이전트에 캐릭터를 더하세요.**
+
+캐릭터를 고르고 열두 축으로 말투를 맞춰 보세요. 저장한 말투는 여러 프로젝트에서 쓸 수 있습니다.
+
+**캐릭터 7개 · 말투 축 12개 · CLI 언어 5개 · 런타임 의존성 없음**
+
+[English](https://github.com/awesometic/tonedial/blob/main/README.md) | **한국어** | [日本語](https://github.com/awesometic/tonedial/blob/main/README.ja.md) | [简体中文](https://github.com/awesometic/tonedial/blob/main/README.zh.md) | [Español](https://github.com/awesometic/tonedial/blob/main/README.es.md)
+
+## 답변부터 보세요
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/ko/voice-examples.svg" alt="같은 함수명 변경 질문에 답하는 Royal Advisor와 Ego Sword의 실제 Codex 대화 기록" width="760">
+
+<sub>실제 Codex 응답을 터미널 대화 형식으로 정리한 이미지입니다. <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/ko/voice-examples.json">입력과 생성 기록</a>.</sub>
+
+**[캐릭터 7개 모두 보기 →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.ko.md)**
+
+## 바로 시작하기
+
+**Node 24 이상**과 npm이 필요합니다.
+
+```bash
+npm install --global tonedial
+tonedial init --tools none --global --lang ko
+tonedial set
+```
+
+설정 과정에서 파일 변경 내용을 보여주고 승인을 받습니다. 에이전트 연결 없이 다이얼부터 열어 봅니다.
+
+[에이전트 연결하기](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent) · [임시 설정으로 시험하기](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md#isolated-candidate)
+
+## 캐릭터 고르기
+
+| 프리셋 | 사용자 → 에이전트 |
+| --- | --- |
+| Caring Brother | 동생 → 든든한 형 |
+| Bratty Kid | 대화 상대 → 말썽꾸러기 꼬마 |
+| Eager Sycophant | 창작자 → 과몰입한 팬 |
+| Royal Advisor | 왕 → 충직한 신하 |
+| Ego Sword | 초보 모험가 → 자아를 가진 검 |
+| Heavenly Demon | 제자 → 엄격한 천마 |
+| Right Hand | 보스 → 믿음직한 오른팔 |
+
+```bash
+tonedial use ego-sword
+tonedial set verbosity=1 warmth=3
+tonedial save "My Sword"
+```
+
+`tonedial create`로 직접 만들 수도 있습니다. 말투, 역할, 호칭, 말씨, 세이프워드를 프로필 하나에 저장합니다.
+
+## 말투 조절하기
+
+**열두 축을 각각 1–5로 조절합니다.** 격식, 답변 길이, 다정함, 비판, 역할극의 강도를 정해 보세요.
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/ko/dial.svg" alt="현재 값, 선택한 warmth 설명, 키보드 조작을 보여주는 ToneDial의 열두 축 다이얼" width="760">
+
+<sub>현재 CLI 렌더러로 만든 80열 합성 미리보기입니다. <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/ko/dial-example.json">프레임 생성 기록</a> · <a href="https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#current-dial-example">만드는 방법</a>.</sub>
+
+**↑↓** 축 선택 · **←→ / 1–5** 값 조절 · **Enter** 적용 · **Esc** 취소
+
+ToneDial은 설정을 로컬에서 `TONE.md`로 컴파일합니다. 같은 설정이면 같은 결과를 만들며, 모델은 사용 중인 에이전트가 제공합니다.
+
+## 에이전트 연결하기
+
+**Claude Code · Codex · Antigravity IDE/Desktop** — [연결 가이드](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent)
+
+설치된 Codex나 Claude Code 클라이언트에서 새 대화를 열어 시험해 보세요.
+
+```bash
+tonedial test codex --preset my-sword
+```
+
+- 미리보기는 사용 중인 프로바이더 계정을 쓰며, 평소와 같은 사용량·요금·기록 정책이 적용됩니다.
+- 말투만 바꿉니다. 호스트의 권한과 승인 요건은 그대로입니다.
+- 모델마다 반응이 다릅니다. 재미를 위한 도구로, 실무 사용은 권장하지 않습니다.
+
+## 더 알아보기
+
+[사용법과 전체 명령어](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md) · [프리셋·수정 기여하기](https://github.com/awesometic/tonedial/blob/main/CONTRIBUTING.md) · [테스트](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md) · [보안](https://github.com/awesometic/tonedial/blob/main/SECURITY.md)
+
+[에이전트 작업 가이드](https://github.com/awesometic/tonedial/blob/main/AGENTS.md) · [MIT 라이선스](https://github.com/awesometic/tonedial/blob/main/LICENSE) · [서드파티 고지](https://github.com/awesometic/tonedial/blob/main/THIRD_PARTY_NOTICES.md)

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# ToneDial
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Give your coding agent a character.**
+
+Pick a character, tune twelve dials, and save a voice to use across projects.
+
+**7 characters · 12 tone axes · 5 CLI languages · Zero runtime dependencies**
+
+**English** | [한국어](https://github.com/awesometic/tonedial/blob/main/README.ko.md) | [日本語](https://github.com/awesometic/tonedial/blob/main/README.ja.md) | [简体中文](https://github.com/awesometic/tonedial/blob/main/README.zh.md) | [Español](https://github.com/awesometic/tonedial/blob/main/README.es.md)
+
+## Hear it first
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/en/voice-examples.svg" alt="Royal Advisor and Ego Sword answer the same function-renaming question in recorded Codex conversations" width="760">
+
+<sub>Recorded Codex replies, formatted as terminal dialogue. <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/en/voice-examples.json">Inputs & provenance</a>.</sub>
+
+**[See all 7 characters →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.md)**
+
+## Try it
+
+Requires **Node 24+** and npm.
+
+```bash
+npm install --global tonedial
+tonedial init --tools none --global --lang en
+tonedial set
+```
+
+Setup previews file changes for approval. This opens the dial without connecting an agent.
+
+[Connect your agent](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent) · [Try with disposable settings](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md#isolated-candidate)
+
+## Pick your character
+
+| Preset | You → agent |
+| --- | --- |
+| Caring Brother | Little sibling → big brother |
+| Bratty Kid | Conversation partner → cheeky kid |
+| Eager Sycophant | Creator → overexcited fan |
+| Royal Advisor | Monarch → loyal subject |
+| Ego Sword | Rookie → sentient sword |
+| Heavenly Demon | Apprentice → stern martial master |
+| Right Hand | Boss → trusted consigliere |
+
+```bash
+tonedial use ego-sword
+tonedial set verbosity=1 warmth=3
+tonedial save "My Sword"
+```
+
+Use `tonedial create` to build your own. Profiles keep tone, roles, address forms, register and safeword together.
+
+## Turn the dials
+
+**Twelve axes, five levels each.** Choose how formal, brief, warm, critical or theatrical your agent sounds.
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/en/dial.png" alt="ToneDial's twelve-axis inline dial with current levels, selected warmth hints and keyboard controls" width="760">
+
+<sub>80-column synthetic preview from the current CLI renderer. <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/en/dial-example.json">Frame provenance</a> · <a href="https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#current-dial-example">Recipe</a>.</sub>
+
+**↑↓** choose an axis · **←→ / 1–5** set its level · **Enter** apply · **Esc** discard
+
+ToneDial compiles your settings into `TONE.md` locally and deterministically. Your agent supplies the model.
+
+## Bring your agent
+
+**Claude Code · Codex · Antigravity IDE/Desktop** — [connection guide](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent)
+
+Try a fresh conversation through an installed Codex or Claude Code client:
+
+```bash
+tonedial test codex --preset my-sword
+```
+
+- Previews use your provider account; normal usage, charges and history apply.
+- Tone changes style. Host permissions and approval requirements stay in place.
+- Model behavior varies. This is for fun, not recommended for production use.
+
+## Go further
+
+[Usage & reference](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md) · [Contribute a preset or fix](https://github.com/awesometic/tonedial/blob/main/CONTRIBUTING.md) · [Testing](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md) · [Security](https://github.com/awesometic/tonedial/blob/main/SECURITY.md)
+
+[Agent guide](https://github.com/awesometic/tonedial/blob/main/AGENTS.md) · [MIT license](https://github.com/awesometic/tonedial/blob/main/LICENSE) · [Third-party notices](https://github.com/awesometic/tonedial/blob/main/THIRD_PARTY_NOTICES.md)

package/README.zh.md

@@ -0,0 +1,83 @@
+# ToneDial
+
+**给编程代理一个角色。**
+
+选择角色，调整十二个语气轴，保存一套能在不同项目中复用的语气。
+
+**7 个角色 · 12 个语气轴 · 5 种 CLI 语言 · 零运行时依赖**
+
+[English](https://github.com/awesometic/tonedial/blob/main/README.md) | [한국어](https://github.com/awesometic/tonedial/blob/main/README.ko.md) | [日本語](https://github.com/awesometic/tonedial/blob/main/README.ja.md) | **简体中文** | [Español](https://github.com/awesometic/tonedial/blob/main/README.es.md)
+
+## 先看实际回复
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/zh/voice-examples.svg" alt="Royal Advisor 和 Ego Sword 回答同一函数改名问题的实际 Codex 对话记录" width="760">
+
+<sub>实际 Codex 回复，按终端对话形式排版。 <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/zh/voice-examples.json">输入与生成记录</a>.</sub>
+
+**[查看全部 7 个角色 →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.zh.md)**
+
+## 开始试用
+
+需要 **Node 24 或更高版本**和 npm。
+
+```bash
+npm install --global tonedial
+tonedial init --tools none --global --lang zh
+tonedial set
+```
+
+设置时会先展示文件变更并请求批准。无需连接代理即可先打开面板试用。
+
+[连接代理](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent) · [使用临时设置试用](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md#isolated-candidate)
+
+## 选择你的角色
+
+| 预设 | 你 → 代理 |
+| --- | --- |
+| Caring Brother | 弟弟 → 可靠的哥哥 |
+| Bratty Kid | 聊天对象 → 淘气小孩 |
+| Eager Sycophant | 创作者 → 狂热粉丝 |
+| Royal Advisor | 君王 → 忠臣 |
+| Ego Sword | 新手冒险者 → 自我之剑 |
+| Heavenly Demon | 徒弟 → 严厉的天魔 |
+| Right Hand | 老大 → 可靠的左右手 |
+
+```bash
+tonedial use ego-sword
+tonedial set verbosity=1 warmth=3
+tonedial save "My Sword"
+```
+
+也可用 `tonedial create` 创建自己的角色。语气、角色、称呼、敬语形式和安全词一起保存在配置中。
+
+## 调节语气
+
+**十二个语气轴，各有五个级别。** 调整正式程度、简洁度、温暖、批评及角色表现强度。
+
+<img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/zh/dial.svg" alt="显示当前值、所选 warmth 说明和键盘操作的 ToneDial 十二轴面板" width="760">
+
+<sub>使用当前 CLI 渲染器生成的 80 列合成预览。 <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/zh/dial-example.json">帧生成记录</a> · <a href="https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#current-dial-example">生成方法</a>.</sub>
+
+**↑↓** 选择语气轴 · **←→ / 1–5** 调整级别 · **Enter** 应用 · **Esc** 放弃
+
+ToneDial 在本地将设置编译为 `TONE.md`，相同设置生成相同结果。模型由你使用的代理提供。
+
+## 接入你的代理
+
+**Claude Code · Codex · Antigravity IDE/Desktop** — [连接指南](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md#connecting-an-agent)
+
+通过已安装的 Codex 或 Claude Code 客户端试用一次新对话：
+
+```bash
+tonedial test codex --preset my-sword
+```
+
+- 预览使用你的服务商账号，按正常规则处理用量、费用和历史记录。
+- 只改变表达风格，主机权限和批准要求保持不变。
+- 模型反应各异。本工具用于娱乐，不建议用于生产工作。
+
+## 进一步了解
+
+[使用方法与参考](https://github.com/awesometic/tonedial/blob/main/docs/USAGE.md) · [贡献预设或修复](https://github.com/awesometic/tonedial/blob/main/CONTRIBUTING.md) · [测试](https://github.com/awesometic/tonedial/blob/main/docs/TESTING.md) · [安全](https://github.com/awesometic/tonedial/blob/main/SECURITY.md)
+
+[代理工作指南](https://github.com/awesometic/tonedial/blob/main/AGENTS.md) · [MIT 许可证](https://github.com/awesometic/tonedial/blob/main/LICENSE) · [第三方声明](https://github.com/awesometic/tonedial/blob/main/THIRD_PARTY_NOTICES.md)

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,113 @@
+# Third-Party Notices
+
+Runtime Unicode data and adapted authoring principles used by ToneDial are covered by the notices below.
+Authoring guidance stays in the repository; the East Asian Width tables compiled into `dist/ui/width.js` ship with the package.
+
+## Unicode Character Database
+
+`src/ui/width.ts` is generated by `scripts/generate-width-table.py` from Python 3.14's `unicodedata`, which exposes the East Asian Width property of the Unicode Character Database (Unicode 16.0.0).
+The generated ranges are what keep a gauge column aligned in Korean, Japanese and Chinese, and they are compiled into `dist/ui/width.js`, so they travel inside the npm package.
+
+The complete [Unicode License v3](https://www.unicode.org/license.txt) notice follows.
+
+```text
+UNICODE LICENSE V3
+
+COPYRIGHT AND PERMISSION NOTICE
+
+Copyright © 1991-2026 Unicode, Inc.
+
+NOTICE TO USER: Carefully read the following legal agreement. BY
+DOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING DATA FILES, AND/OR
+SOFTWARE, YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE
+TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE, DO NOT
+DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE THE DATA FILES OR SOFTWARE.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of data files and any associated documentation (the "Data Files") or
+software and any associated documentation (the "Software") to deal in the
+Data Files or Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, and/or sell
+copies of the Data Files or Software, and to permit persons to whom the
+Data Files or Software are furnished to do so, provided that either (a)
+this copyright and permission notice appear with all copies of the Data
+Files or Software, or (b) this copyright and permission notice appear in
+associated Documentation.
+
+THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF
+THIRD PARTY RIGHTS.
+
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE
+BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,
+OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE DATA
+FILES OR SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder shall
+not be used in advertising or otherwise to promote the sale, use or other
+dealings in these Data Files or Software without prior written
+authorization of the copyright holder.
+```
+
+Unicode and the Unicode Logo are registered trademarks of Unicode, Inc. in the U.S. and other countries.
+
+## epoko77-ai/im-not-ai
+
+The Korean writing guidance in [agent guidance](https://github.com/awesometic/tonedial/blob/main/AGENTS.md)
+and [contributing](https://github.com/awesometic/tonedial/blob/main/CONTRIBUTING.md) is adapted from
+[epoko77-ai/im-not-ai](https://github.com/epoko77-ai/im-not-ai). Its notice applies to that guidance.
+
+```text
+MIT License
+
+Copyright (c) 2026 epoko77-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## DietrichGebert/ponytail
+
+The concise reuse/standard-library/minimum-needed ladder in [AGENTS.md](https://github.com/awesometic/tonedial/blob/main/AGENTS.md) is adapted from [DietrichGebert/ponytail](https://github.com/DietrichGebert/ponytail).
+
+```text
+MIT License
+
+Copyright (c) 2026 DietrichGebert
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/dist/bin.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// The executable entry point. Everything it can do lives in cli.ts, so the tests drive the
+// same path a user does rather than a parallel one built for them.
+import { run } from "./cli.js";
+process.exitCode = await run(process.argv.slice(2));