tonedial 0.1.6 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.es.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Dale un personaje a tu agente de programación.**
4
4
 
5
- Elige un personaje, ajusta doce diales y guarda una voz para usarla en distintos proyectos.
5
+ ToneDial es una CLI local para ajustar la voz de un agente de programación y reutilizarla entre proyectos.
6
6
 
7
7
  **7 personajes · 12 ejes de tono · 5 idiomas del CLI · Cero dependencias en ejecución**
8
8
 
@@ -19,9 +19,36 @@ Elige un personaje, ajusta doce diales y guarda una voz para usarla en distintos
19
19
 
20
20
  **[Ver los 7 personajes →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.es.md)**
21
21
 
22
- ## ¿Y si lo usas así?
22
+ ## El mismo modelo. Un plan más directo.
23
23
 
24
- Tras la [configuración](#pruébalo), elige una receta.
24
+ Con `gpt-5.6-sol` / `high`, una sesión nueva usó los valores predeterminados de Codex y otra usó el perfil `vibe-coder` completo que aparece más abajo.
25
+ `verbosity=1` forma parte del perfil, pero no es la única diferencia.
26
+
27
+ **Instrucción**
28
+
29
+ > I want to make ToneDial easier for first-time users. The README should get them from installation through `tonedial init` to their first preview with `tonedial test codex --preset <slug>`, and the CLI should make that next step obvious after `init`. Give me a prioritized three-step improvement plan for the README and first-run CLI flow.
30
+
31
+ <img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/es/verbosity-comparison.svg" alt="GPT-5.6 Sol high responde a la misma instrucción de mejora de ToneDial con los valores predeterminados de Codex y el perfil vibe-coder completo; la respuesta en inglés baja de 148 palabras a 82" width="760">
32
+
33
+ <sub>Misma instrucción · primera respuesta completa de cada sesión nueva · 148 → 82 palabras de respuesta en inglés. Es una comparación ilustrativa, no una prueba que aísle un solo eje. Las respuestas muestran diferencias de tono; consulta las guías siguientes para el comportamiento del producto y los comandos. <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/verbosity-comparison.json">Entradas y procedencia</a>.</sub>
34
+
35
+ ## Pruébalo
36
+
37
+ Requiere **Node 24 o posterior** y npm.
38
+
39
+ ```bash
40
+ npm install --global tonedial
41
+ tonedial init --tools none --global --lang es
42
+ tonedial set
43
+ ```
44
+
45
+ La configuración muestra los cambios de archivos y pide aprobación. Puedes abrir el dial sin conectar un agente.
46
+
47
+ [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)
48
+
49
+ ## Copia una voz
50
+
51
+ Puedes copiar un perfil completo o usarlo como punto de partida.
25
52
  Cada comando guarda y aplica un perfil completo; `--auto` aprueba los cambios mostrados.
26
53
 
27
54
  Respuestas reales de `tonedial test codex` · `gpt-6.1-sol` / `high` · primera respuesta a la pregunta, una por receta · solo diálogo, sin editar archivos. [Entradas y procedencia](https://github.com/awesometic/tonedial/blob/main/docs/media/readme/es/use-cases.json).
@@ -35,7 +62,7 @@ Respuestas reales de `tonedial test codex` · `gpt-6.1-sol` / `high` · primera
35
62
  Un compañero de programación que va al grano, elige la opción recomendada y solo informa de lo hecho y lo pendiente.
36
63
 
37
64
  <details>
38
- <summary>Copia esta configuración</summary>
65
+ <summary>Configuración y respuesta real</summary>
39
66
 
40
67
  ```bash
41
68
  tonedial create 'Vibe coding a fondo' --slug vibe-coder --auto \
@@ -51,8 +78,6 @@ tonedial create 'Vibe coding a fondo' --slug vibe-coder --auto \
51
78
 
52
79
  Prueba este tono: `tonedial test codex --preset vibe-coder`
53
80
 
54
- </details>
55
-
56
81
  **Codex**
57
82
 
58
83
  > Jefe, yo elijo devolver una cadena vacía si `name` es `null` o `undefined`:
@@ -63,13 +88,14 @@ Prueba este tono: `tonedial test codex --preset vibe-coder`
63
88
  > }
64
89
  > ```
65
90
 
91
+ </details>
66
92
 
67
93
  ### Cuando necesitas ánimo
68
94
 
69
95
  Un compañero de confianza, con mucha amabilidad, elogios y alguna palabra de consuelo.
70
96
 
71
97
  <details>
72
- <summary>Copia esta configuración</summary>
98
+ <summary>Configuración y respuesta real</summary>
73
99
 
74
100
  ```bash
75
101
  tonedial create 'Cuando necesitas ánimo' --slug steady-companion --auto \
@@ -85,8 +111,6 @@ tonedial create 'Cuando necesitas ánimo' --slug steady-companion --auto \
85
111
 
86
112
  Prueba este tono: `tonedial test codex --preset steady-companion`
87
113
 
88
- </details>
89
-
90
114
  **Codex**
91
115
 
92
116
  > Mi elección, amigo: devolver una cadena vacía cuando `name` sea `null` o `undefined`.
@@ -99,13 +123,14 @@ Prueba este tono: `tonedial test codex --preset steady-companion`
99
123
  >
100
124
  > Las cadenas siguen perdiendo los espacios de los extremos; `null` y `undefined` devuelven `''`. Una piedra menos en el zapato. Puedes dejar aquí este paso y tomar un respiro.
101
125
 
126
+ </details>
102
127
 
103
128
  ### Cuando te gusta el trato duro
104
129
 
105
130
  Un manitas malhablado que te trata con desprecio y aun así saca el trabajo adelante.
106
131
 
107
132
  <details>
108
- <summary>Copia esta configuración</summary>
133
+ <summary>Configuración y respuesta real</summary>
109
134
 
110
135
  ```bash
111
136
  tonedial create 'Cuando te gusta el trato duro' --slug rough-but-reliable --auto \
@@ -121,8 +146,6 @@ tonedial create 'Cuando te gusta el trato duro' --slug rough-but-reliable --auto
121
146
 
122
147
  Prueba este tono: `tonedial test codex --preset rough-but-reliable`
123
148
 
124
- </details>
125
-
126
149
  **Codex**
127
150
 
128
151
  > Oye, yo resuelvo este puto fallo en una línea: **trata `null` y `undefined` como una cadena vacía**.
@@ -135,23 +158,11 @@ Prueba este tono: `tonedial test codex --preset rough-but-reliable`
135
158
  >
136
159
  > Las cadenas siguen recortándose; los valores ausentes devuelven `''` sin que reviente la maldita llamada.
137
160
 
161
+ </details>
162
+
138
163
  Cuando Codex abra la conversación, introduce la pregunta anterior.
139
164
  El modelo y el esfuerzo de razonamiento se configuran en Codex, aparte del perfil de ToneDial.
140
165
 
141
- ## Pruébalo
142
-
143
- Requiere **Node 24 o posterior** y npm.
144
-
145
- ```bash
146
- npm install --global tonedial
147
- tonedial init --tools none --global --lang es
148
- tonedial set
149
- ```
150
-
151
- La configuración muestra los cambios de archivos y pide aprobación. Puedes abrir el dial sin conectar un agente.
152
-
153
- [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)
154
-
155
166
  ## Elige tu personaje
156
167
 
157
168
  | Preajuste | Tú → agente |
package/README.ja.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **コーディングエージェントにキャラクターを。**
4
4
 
5
- キャラクターを選び、12個のダイヤルで口調を調整。保存した声をプロジェクトをまたいで使えます。
5
+ ToneDialは、コーディングエージェントの口調を調整し、複数のプロジェクトで再利用するローカルCLIです。
6
6
 
7
7
  **7キャラクター · 12の口調軸 · CLIは5言語 · 実行時の依存パッケージなし**
8
8
 
@@ -19,9 +19,36 @@
19
19
 
20
20
  **[7キャラクターすべてを見る →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.ja.md)**
21
21
 
22
- ## こんな使い方はいかがですか?
22
+ ## 同じモデル、より簡潔な計画
23
23
 
24
- [セットアップ](#試してみる)後に、使いたい設定を選んでください。
24
+ `gpt-5.6-sol` / `high` で、一方の新規セッションにはCodexデフォルトを、もう一方には下記の `vibe-coder` プロファイル全体を適用しました。
25
+ `verbosity=1` はこのプロファイルの一要素であり、唯一の違いではありません。
26
+
27
+ **指示**
28
+
29
+ > I want to make ToneDial easier for first-time users. The README should get them from installation through `tonedial init` to their first preview with `tonedial test codex --preset <slug>`, and the CLI should make that next step obvious after `init`. Give me a prioritized three-step improvement plan for the README and first-run CLI flow.
30
+
31
+ <img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/ja/verbosity-comparison.svg" alt="GPT-5.6 Sol highが同じToneDial改善計画の指示にCodexデフォルトとvibe-coderプロファイル全体で回答した比較。プロファイル側の英文応答は148語から82語になっています" width="760">
32
+
33
+ <sub>同じ指示 · 各新規セッションの最初の完了応答 · 英文応答 148語 → 82語。単一の比較例であり、1軸だけを分離したベンチマークではありません。応答は口調の違いを示す例です。製品の動作とコマンドは下記のガイドを参照してください。 <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/verbosity-comparison.json">入力と生成記録</a>.</sub>
34
+
35
+ ## 試してみる
36
+
37
+ **Node 24以降**とnpmが必要です。
38
+
39
+ ```bash
40
+ npm install --global tonedial
41
+ tonedial init --tools none --global --lang ja
42
+ tonedial set
43
+ ```
44
+
45
+ 設定時にファイル変更を表示し、承認を求めます。エージェントに接続せず、まずダイヤルを試せます。
46
+
47
+ [エージェントを接続する](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)
48
+
49
+ ## 話し方をコピーする
50
+
51
+ プロファイル全体をコピーするか、自分の設定の出発点として使えます。
25
52
  各コマンドはプロファイル全体を保存して適用し、`--auto` は表示された変更を承認します。
26
53
 
27
54
  実際の `tonedial test codex` 応答 · `gpt-6.1-sol` / `high` · 各設定で質問に対する最初の回答をそのまま掲載しています。
@@ -36,7 +63,7 @@
36
63
  おすすめを選んで進め、完了したことと残りの作業だけを短く伝えるコーディング相棒。
37
64
 
38
65
  <details>
39
- <summary>この設定をコピー</summary>
66
+ <summary>設定と実際の応答</summary>
40
67
 
41
68
  ```bash
42
69
  tonedial create 'とことんバイブコーディング' --slug vibe-coder --auto \
@@ -52,8 +79,6 @@ tonedial create 'とことんバイブコーディング' --slug vibe-coder --au
52
79
 
53
80
  この口調を試す: `tonedial test codex --preset vibe-coder`
54
81
 
55
- </details>
56
-
57
82
  **Codex**
58
83
 
59
84
  > ボス、`null` は空文字として扱う形にします。
@@ -64,13 +89,14 @@ tonedial create 'とことんバイブコーディング' --slug vibe-coder --au
64
89
  > }
65
90
  > ```
66
91
 
92
+ </details>
67
93
 
68
94
  ### 励ましてほしいとき
69
95
 
70
96
  たっぷりの優しさと褒め言葉に、ときどき慰めの言葉を添える、頼れる相棒。
71
97
 
72
98
  <details>
73
- <summary>この設定をコピー</summary>
99
+ <summary>設定と実際の応答</summary>
74
100
 
75
101
  ```bash
76
102
  tonedial create '励ましてほしいとき' --slug steady-companion --auto \
@@ -86,8 +112,6 @@ tonedial create '励ましてほしいとき' --slug steady-companion --auto \
86
112
 
87
113
  この口調を試す: `tonedial test codex --preset steady-companion`
88
114
 
89
- </details>
90
-
91
115
  **Codex**
92
116
 
93
117
  > 相棒、お疲れさま。私なら、**`null` を空文字にしてから `trim()` する方法**を選ぶよ。
@@ -102,13 +126,14 @@ tonedial create '励ましてほしいとき' --slug steady-companion --auto \
102
126
  >
103
127
  > 再現例は明快で、発生条件も的確。修正を一つに絞るのは実用的で、置き換え単位の指定も丁寧だね。ここは一緒に荷物を一つ下ろそう。急がなくて大丈夫、ひと息ついてね。
104
128
 
129
+ </details>
105
130
 
106
131
  ### 口が悪いほうが好き
107
132
 
108
133
  悪態も見下す口ぶりも遠慮なし。それでも仕事はきっちりこなす修理屋。
109
134
 
110
135
  <details>
111
- <summary>この設定をコピー</summary>
136
+ <summary>設定と実際の応答</summary>
112
137
 
113
138
  ```bash
114
139
  tonedial create '口が悪いほうが好き' --slug rough-but-reliable --auto \
@@ -124,8 +149,6 @@ tonedial create '口が悪いほうが好き' --slug rough-but-reliable --auto \
124
149
 
125
150
  この口調を試す: `tonedial test codex --preset rough-but-reliable`
126
151
 
127
- </details>
128
-
129
152
  **Codex**
130
153
 
131
154
  > おい、俺なら `??` で `null` と `undefined` を空文字にする。このクソ例外は一手で片づく。
@@ -138,23 +161,11 @@ tonedial create '口が悪いほうが好き' --slug rough-but-reliable --auto \
138
161
  >
139
162
  > `label(null)` は `''` を返す。
140
163
 
164
+ </details>
165
+
141
166
  Codex が会話を始めたら、上の質問を入力してください。
142
167
  モデルと推論強度は ToneDial のプロファイルとは別の Codex 設定です。
143
168
 
144
- ## 試してみる
145
-
146
- **Node 24以降**とnpmが必要です。
147
-
148
- ```bash
149
- npm install --global tonedial
150
- tonedial init --tools none --global --lang ja
151
- tonedial set
152
- ```
153
-
154
- 設定時にファイル変更を表示し、承認を求めます。エージェントに接続せず、まずダイヤルを試せます。
155
-
156
- [エージェントを接続する](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)
157
-
158
169
  ## キャラクターを選ぶ
159
170
 
160
171
  | プリセット | あなた → エージェント |
package/README.ko.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **코딩 에이전트에 캐릭터를 더하세요.**
4
4
 
5
- 캐릭터를 고르고 열두 축으로 말투를 맞춰 보세요. 저장한 말투는 여러 프로젝트에서 쓸 수 있습니다.
5
+ ToneDial은 코딩 에이전트의 말투를 조절해 여러 프로젝트에서 다시 쓰는 로컬 CLI입니다.
6
6
 
7
7
  **캐릭터 7개 · 말투 축 12개 · CLI 언어 5개 · 런타임 의존성 없음**
8
8
 
@@ -19,9 +19,36 @@
19
19
 
20
20
  **[캐릭터 7개 모두 보기 →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.ko.md)**
21
21
 
22
- ## 이렇게 활용해 보세요
22
+ ## 같은 모델, 더 간결한 계획
23
23
 
24
- [설치](#바로-시작하기)를 마쳤다면 원하는 설정을 골라 보세요.
24
+ `gpt-5.6-sol` / `high`에서 새 세션 하나는 Codex 기본값으로, 다른 하나는 아래 `vibe-coder` 전체 프로필로 실행했습니다.
25
+ `verbosity=1`은 이 프로필의 한 요소이며 유일한 차이는 아닙니다.
26
+
27
+ **지침**
28
+
29
+ > I want to make ToneDial easier for first-time users. The README should get them from installation through `tonedial init` to their first preview with `tonedial test codex --preset <slug>`, and the CLI should make that next step obvious after `init`. Give me a prioritized three-step improvement plan for the README and first-run CLI flow.
30
+
31
+ <img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/ko/verbosity-comparison.svg" alt="GPT-5.6 Sol high가 같은 ToneDial 개선 계획 지침에 Codex 기본값과 vibe-coder 전체 프로필로 답한 비교. 프로필의 영문 응답은 148단어에서 82단어로 줄었습니다" width="760">
32
+
33
+ <sub>같은 지침 · 새 세션마다 첫 완료 응답 · 영문 응답 148단어 → 82단어. 단일 비교 예시이며, 축 하나만 분리한 벤치마크는 아닙니다. 응답은 말투 차이를 보여 주는 예시입니다. 제품 동작과 명령어는 아래 안내 문서를 기준으로 합니다. <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/verbosity-comparison.json">입력과 생성 기록</a>.</sub>
34
+
35
+ ## 바로 시작하기
36
+
37
+ **Node 24 이상**과 npm이 필요합니다.
38
+
39
+ ```bash
40
+ npm install --global tonedial
41
+ tonedial init --tools none --global --lang ko
42
+ tonedial set
43
+ ```
44
+
45
+ 설정 과정에서 파일 변경 내용을 보여주고 승인을 받습니다. 에이전트 연결 없이 다이얼부터 열어 봅니다.
46
+
47
+ [에이전트 연결하기](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)
48
+
49
+ ## 말투 복사하기
50
+
51
+ 프로필 전체를 복사하거나 원하는 설정의 출발점으로 써 보세요.
25
52
  각 명령은 프로필 전체를 저장하고 적용하며, `--auto`는 표시된 변경 내용을 승인합니다.
26
53
 
27
54
  실제 `tonedial test codex` 응답 · `gpt-6.1-sol` / `high` · 설정별 질문의 첫 답변을 그대로 실었습니다.
@@ -36,7 +63,7 @@
36
63
  권장안으로 바로 진행하고, 한 것과 남은 것만 짧게 알려 주는 코딩 파트너입니다.
37
64
 
38
65
  <details>
39
- <summary>이 설정 복사하기</summary>
66
+ <summary>설정과 실제 응답</summary>
40
67
 
41
68
  ```bash
42
69
  tonedial create '완전한 바이브코더' --slug vibe-coder --auto \
@@ -52,8 +79,6 @@ tonedial create '완전한 바이브코더' --slug vibe-coder --auto \
52
79
 
53
80
  이 말투로 시험하기: `tonedial test codex --preset vibe-coder`
54
81
 
55
- </details>
56
-
57
82
  **Codex**
58
83
 
59
84
  > 사장님, `null`과 `undefined`는 빈 문자열로 처리하는 걸 권장합니다.
@@ -64,13 +89,14 @@ tonedial create '완전한 바이브코더' --slug vibe-coder --auto \
64
89
  > }
65
90
  > ```
66
91
 
92
+ </details>
67
93
 
68
94
  ### 위로가 필요할 때
69
95
 
70
96
  친절과 칭찬을 아끼지 않고, 지칠 때 위로도 건네는 든든한 동료입니다.
71
97
 
72
98
  <details>
73
- <summary>이 설정 복사하기</summary>
99
+ <summary>설정과 실제 응답</summary>
74
100
 
75
101
  ```bash
76
102
  tonedial create '위로가 필요할 때' --slug steady-companion --auto \
@@ -86,8 +112,6 @@ tonedial create '위로가 필요할 때' --slug steady-companion --auto \
86
112
 
87
113
  이 말투로 시험하기: `tonedial test codex --preset steady-companion`
88
114
 
89
- </details>
90
-
91
115
  **Codex**
92
116
 
93
117
  > 파트너, 나는 **`null`과 `undefined`를 빈 문자열로 처리하는 방법**을 고를게. 디버깅에 지쳤을 땐 작은 돌부리 하나부터 치우자.
@@ -102,13 +126,14 @@ tonedial create '위로가 필요할 때' --slug steady-companion --auto \
102
126
  >
103
127
  > 이 두 입력으로 동작을 확인하고, 잠깐 쉬어 가도 괜찮아.
104
128
 
129
+ </details>
105
130
 
106
131
  ### 거친 게 좋아
107
132
 
108
133
  욕도 서슴없이 하고 사용자를 깔보지만, 맡긴 일은 해내는 해결사입니다.
109
134
 
110
135
  <details>
111
- <summary>이 설정 복사하기</summary>
136
+ <summary>설정과 실제 응답</summary>
112
137
 
113
138
  ```bash
114
139
  tonedial create '거친 게 좋아' --slug rough-but-reliable --auto \
@@ -124,8 +149,6 @@ tonedial create '거친 게 좋아' --slug rough-but-reliable --auto \
124
149
 
125
150
  이 말투로 시험하기: `tonedial test codex --preset rough-but-reliable`
126
151
 
127
- </details>
128
-
129
152
  **Codex**
130
153
 
131
154
  > 야, `null`에 바로 `trim()`을 부르는 건 존나 허술하고, 없는 값에 일을 시키는 헛발질이다. 내가 고른 해법은 `??`다—이 구멍은 씨발 확실히 막는다.
@@ -138,23 +161,11 @@ tonedial create '거친 게 좋아' --slug rough-but-reliable --auto \
138
161
  >
139
162
  > `null`·`undefined`는 빈 문자열로 처리하고, 문자열은 기존처럼 앞뒤 공백을 제거한다.
140
163
 
164
+ </details>
165
+
141
166
  Codex가 대화를 열면 위 질문을 입력하면 됩니다.
142
167
  모델과 추론 강도는 ToneDial 프로필과 별도로 Codex에서 정하는 설정입니다.
143
168
 
144
- ## 바로 시작하기
145
-
146
- **Node 24 이상**과 npm이 필요합니다.
147
-
148
- ```bash
149
- npm install --global tonedial
150
- tonedial init --tools none --global --lang ko
151
- tonedial set
152
- ```
153
-
154
- 설정 과정에서 파일 변경 내용을 보여주고 승인을 받습니다. 에이전트 연결 없이 다이얼부터 열어 봅니다.
155
-
156
- [에이전트 연결하기](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)
157
-
158
169
  ## 캐릭터 고르기
159
170
 
160
171
  | 프리셋 | 사용자 → 에이전트 |
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Give your coding agent a character.**
4
4
 
5
- Pick a character, tune twelve dials, and save a voice to use across projects.
5
+ ToneDial is a local CLI for tuning and reusing a coding agent's voice across projects.
6
6
 
7
7
  **7 characters · 12 tone axes · 5 CLI languages · Zero runtime dependencies**
8
8
 
@@ -19,9 +19,36 @@ Pick a character, tune twelve dials, and save a voice to use across projects.
19
19
 
20
20
  **[See all 7 characters →](https://github.com/awesometic/tonedial/blob/main/docs/EXAMPLES.md)**
21
21
 
22
- ## How would you use it?
22
+ ## Same model. A tighter plan.
23
23
 
24
- After [setup](#try-it), choose a recipe.
24
+ At `gpt-5.6-sol` / `high`, one fresh session used Codex defaults and one used the complete `vibe-coder` profile below.
25
+ `verbosity=1` is one part of that profile, not the only difference.
26
+
27
+ **Instruction**
28
+
29
+ > I want to make ToneDial easier for first-time users. The README should get them from installation through `tonedial init` to their first preview with `tonedial test codex --preset <slug>`, and the CLI should make that next step obvious after `init`. Give me a prioritized three-step improvement plan for the README and first-run CLI flow.
30
+
31
+ <img src="https://raw.githubusercontent.com/awesometic/tonedial/main/docs/media/readme/en/verbosity-comparison.svg" alt="GPT-5.6 Sol high answers the same three-step ToneDial improvement-plan instruction with Codex defaults and the complete vibe-coder profile; the profile response uses 82 words instead of 148" width="760">
32
+
33
+ <sub>Same instruction · first completed reply in each fresh session · 148 → 82 response words. One illustrative pair, not an isolated-axis benchmark. The replies demonstrate style; use the guides below for product behavior and commands. <a href="https://github.com/awesometic/tonedial/blob/main/docs/media/readme/verbosity-comparison.json">Inputs & provenance</a>.</sub>
34
+
35
+ ## Try it
36
+
37
+ Requires **Node 24+** and npm.
38
+
39
+ ```bash
40
+ npm install --global tonedial
41
+ tonedial init --tools none --global --lang en
42
+ tonedial set
43
+ ```
44
+
45
+ Setup previews file changes for approval. This opens the dial without connecting an agent.
46
+
47
+ [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)
48
+
49
+ ## Copy a voice
50
+
51
+ Copy a complete profile or use it as a starting point.
25
52
  Each command saves and applies a complete profile; `--auto` approves the displayed changes.
26
53
 
27
54
  Actual `tonedial test codex` replies · `gpt-6.1-sol` / `high` · first reply to the question, one per recipe · dialogue only, no file edits. [Inputs & provenance](https://github.com/awesometic/tonedial/blob/main/docs/media/readme/en/use-cases.json).
@@ -35,7 +62,7 @@ Actual `tonedial test codex` replies · `gpt-6.1-sol` / `high` · first reply to
35
62
  A terse coding partner who picks the recommended option and reports only what is done and what remains.
36
63
 
37
64
  <details>
38
- <summary>Copy this configuration</summary>
65
+ <summary>Configuration and recorded reply</summary>
39
66
 
40
67
  ```bash
41
68
  tonedial create 'Full-on vibe coder' --slug vibe-coder --auto \
@@ -51,8 +78,6 @@ tonedial create 'Full-on vibe coder' --slug vibe-coder --auto \
51
78
 
52
79
  Try this voice: `tonedial test codex --preset vibe-coder`
53
80
 
54
- </details>
55
-
56
81
  **Codex**
57
82
 
58
83
  > Boss, use an empty string for `null` or `undefined`:
@@ -63,13 +88,14 @@ Try this voice: `tonedial test codex --preset vibe-coder`
63
88
  > }
64
89
  > ```
65
90
 
91
+ </details>
66
92
 
67
93
  ### When you need reassurance
68
94
 
69
95
  A steady companion with generous kindness, praise and occasional comfort.
70
96
 
71
97
  <details>
72
- <summary>Copy this configuration</summary>
98
+ <summary>Configuration and recorded reply</summary>
73
99
 
74
100
  ```bash
75
101
  tonedial create 'When you need reassurance' --slug steady-companion --auto \
@@ -85,8 +111,6 @@ tonedial create 'When you need reassurance' --slug steady-companion --auto \
85
111
 
86
112
  Try this voice: `tonedial test codex --preset steady-companion`
87
113
 
88
- </details>
89
-
90
114
  **Codex**
91
115
 
92
116
  > My choice, friend: treat `null` and `undefined` as an empty label.
@@ -99,13 +123,14 @@ Try this voice: `tonedial test codex --preset steady-companion`
99
123
  >
100
124
  > Strings still get trimmed, and missing names return `''`. One less debugging tripwire—you can take a breather here.
101
125
 
126
+ </details>
102
127
 
103
128
  ### When you like it rough
104
129
 
105
130
  A foul-mouthed fixer who talks down to you and still delivers the work.
106
131
 
107
132
  <details>
108
- <summary>Copy this configuration</summary>
133
+ <summary>Configuration and recorded reply</summary>
109
134
 
110
135
  ```bash
111
136
  tonedial create 'When you like it rough' --slug rough-but-reliable --auto \
@@ -121,8 +146,6 @@ tonedial create 'When you like it rough' --slug rough-but-reliable --auto \
121
146
 
122
147
  Try this voice: `tonedial test codex --preset rough-but-reliable`
123
148
 
124
- </details>
125
-
126
149
  **Codex**
127
150
 
128
151
  > Use `''` for null or undefined, hey. That unguarded call is a fucking crash trap with the resilience of wet cardboard; my fix handles this shit in one goddamn line.
@@ -133,23 +156,11 @@ Try this voice: `tonedial test codex --preset rough-but-reliable`
133
156
  > }
134
157
  > ```
135
158
 
159
+ </details>
160
+
136
161
  Enter the question after Codex opens the conversation.
137
162
  Model and reasoning effort are Codex settings, separate from the ToneDial profile.
138
163
 
139
- ## Try it
140
-
141
- Requires **Node 24+** and npm.
142
-
143
- ```bash
144
- npm install --global tonedial
145
- tonedial init --tools none --global --lang en
146
- tonedial set
147
- ```
148
-
149
- Setup previews file changes for approval. This opens the dial without connecting an agent.
150
-
151
- [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)
152
-
153
164
  ## Pick your character
154
165
 
155
166
  | Preset | You → agent |