clew-code 0.2.11 → 0.2.14

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.
Files changed (52) hide show
  1. package/dist/main.js +2596 -2527
  2. package/docs/architecture.html +148 -148
  3. package/docs/architecture.th.html +79 -79
  4. package/docs/clew-code-architecture.html +6 -6
  5. package/docs/commands.html +225 -224
  6. package/docs/commands.th.html +132 -131
  7. package/docs/configuration.html +147 -147
  8. package/docs/configuration.th.html +108 -108
  9. package/docs/daemon.html +129 -129
  10. package/docs/daemon.th.html +73 -73
  11. package/docs/features/bridge-mode.html +99 -99
  12. package/docs/features/bridge-mode.th.html +90 -90
  13. package/docs/features/evals.html +182 -182
  14. package/docs/features/evals.th.html +90 -90
  15. package/docs/features/peer.html +178 -178
  16. package/docs/features/searxng-search.html +151 -151
  17. package/docs/features/searxng-search.th.html +95 -95
  18. package/docs/features/sentry-setup.html +157 -157
  19. package/docs/features/sentry-setup.th.html +97 -97
  20. package/docs/index.html +298 -299
  21. package/docs/index.th.html +292 -292
  22. package/docs/installation.html +105 -105
  23. package/docs/installation.th.html +105 -105
  24. package/docs/internals/growthbook-ab-testing.html +113 -113
  25. package/docs/internals/growthbook-ab-testing.th.html +81 -81
  26. package/docs/internals/hidden-features.html +175 -149
  27. package/docs/internals/hidden-features.th.html +135 -109
  28. package/docs/loop.html +181 -181
  29. package/docs/loop.th.html +227 -227
  30. package/docs/mcp.html +247 -247
  31. package/docs/mcp.th.html +207 -207
  32. package/docs/models.html +110 -111
  33. package/docs/models.th.html +61 -61
  34. package/docs/peer.html +236 -236
  35. package/docs/peer.th.html +280 -280
  36. package/docs/permission-model.html +102 -102
  37. package/docs/permission-model.th.html +67 -67
  38. package/docs/plugins.html +102 -102
  39. package/docs/plugins.th.html +79 -79
  40. package/docs/providers.html +126 -126
  41. package/docs/providers.th.html +80 -80
  42. package/docs/quick-start.html +93 -93
  43. package/docs/quick-start.th.html +1 -1
  44. package/docs/research-memory.html +82 -82
  45. package/docs/research-memory.th.html +72 -72
  46. package/docs/skills.html +117 -117
  47. package/docs/skills.th.html +90 -90
  48. package/docs/tools.html +170 -170
  49. package/docs/tools.th.html +84 -84
  50. package/docs/troubleshooting.html +106 -106
  51. package/docs/troubleshooting.th.html +85 -85
  52. package/package.json +162 -164
@@ -1,147 +1,147 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Configuration — Clew</title>
7
- <meta name="description" content="Comprehensive configuration guide for Clew — CLI flags, environment variables, settings file, and in-session commands.">
8
- <link rel="preconnect" href="https://fonts.googleapis.com">
9
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
- <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
11
- <link rel="stylesheet" href="css/styles.css">
12
- <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
- </head>
14
- <body>
15
- <header class="header"></header>
16
- <div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
17
- <div class="content-wrap"><main class="content">
18
- <div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Configuration</span></div>
19
- <h1>Configuration</h1>
20
- <p class="section-subtitle">Clew is configured through CLI flags (Commander.js), environment variables, a JSON settings file (validated with Zod), and in-session slash commands.</p>
21
-
22
- <h2>CLI Flags</h2>
23
- <p>Defined in <code>src/main.tsx</code> with Commander.js <code>.option()</code> and <code>.addOption()</code>:</p>
24
- <table>
25
- <tr><th>Flag</th><th>Description</th></tr>
26
- <tr><td><code>-p, --print</code></td><td>Print response and exit (useful for pipes). Skips workspace trust dialog.</td></tr>
27
- <tr><td><code>--bare</code></td><td>Minimal mode: skip hooks, LSP, plugins, attribution, auto-memory, keychain reads, CLEW.md discovery. Sets CLEW_CODE_SIMPLE=1.</td></tr>
28
- <tr><td><code>-d, --debug [filter]</code></td><td>Enable debug mode with optional category filtering (e.g., "api,hooks" or "!1p,!file")</td></tr>
29
- <tr><td><code>--debug-file &lt;path&gt;</code></td><td>Write debug logs to a file</td></tr>
30
- <tr><td><code>--verbose</code></td><td>Override verbose mode setting from config</td></tr>
31
- <tr><td><code>--model &lt;model&gt;</code></td><td>Model for the current session (alias or full ID)</td></tr>
32
- <tr><td><code>--effort &lt;level&gt;</code></td><td>Effort level: low, medium, high, max</td></tr>
33
- <tr><td><code>--agent &lt;agent&gt;</code></td><td>Agent for the current session</td></tr>
34
- <tr><td><code>--permission-mode &lt;mode&gt;</code></td><td>Permission mode (default, ask, plan, auto, acceptEdits, bypassPermissions, dontAsk)</td></tr>
35
- <tr><td><code>--dangerously-skip-permissions</code></td><td>Bypass all permission checks (sandbox only)</td></tr>
36
- <tr><td><code>--allow-dangerously-skip-permissions</code></td><td>Enable bypass as an option without enabling by default</td></tr>
37
- <tr><td><code>--allowedTools, --allowed-tools</code></td><td>Comma/space-separated tool names to allow (e.g., "Bash(git:*) Edit")</td></tr>
38
- <tr><td><code>--disallowedTools, --disallowed-tools</code></td><td>Comma/space-separated tool names to deny</td></tr>
39
- <tr><td><code>--tools &lt;tools...&gt;</code></td><td>Specify available tools from built-in set</td></tr>
40
- <tr><td><code>--mcp-config &lt;configs...&gt;</code></td><td>Load MCP servers from JSON files or strings</td></tr>
41
- <tr><td><code>--strict-mcp-config</code></td><td>Only use MCP servers from --mcp-config</td></tr>
42
- <tr><td><code>--plugin-dir &lt;path&gt;</code></td><td>Load plugins from a directory (repeatable)</td></tr>
43
- <tr><td><code>--settings &lt;file-or-json&gt;</code></td><td>Path to a settings JSON file or JSON string</td></tr>
44
- <tr><td><code>--add-dir &lt;directories...&gt;</code></td><td>Additional directories to allow tool access</td></tr>
45
- <tr><td><code>--system-prompt &lt;prompt&gt;</code></td><td>Custom system prompt</td></tr>
46
- <tr><td><code>--system-prompt-file &lt;file&gt;</code></td><td>Read system prompt from a file</td></tr>
47
- <tr><td><code>--append-system-prompt &lt;prompt&gt;</code></td><td>Append to default system prompt</td></tr>
48
- <tr><td><code>--continue, -c</code></td><td>Continue the most recent conversation</td></tr>
49
- <tr><td><code>--resume, -r [value]</code></td><td>Resume a conversation by session ID or picker</td></tr>
50
- <tr><td><code>--fork-session</code></td><td>When resuming, create a new session ID</td></tr>
51
- <tr><td><code>--session-id &lt;uuid&gt;</code></td><td>Use a specific session ID</td></tr>
52
- <tr><td><code>--name, -n &lt;name&gt;</code></td><td>Display name for this session</td></tr>
53
- <tr><td><code>--agents &lt;json&gt;</code></td><td>JSON defining custom agents</td></tr>
54
- <tr><td><code>--output-format &lt;format&gt;</code></td><td>text, json, or stream-json (with --print)</td></tr>
55
- <tr><td><code>--input-format &lt;format&gt;</code></td><td>text or stream-json (with --print)</td></tr>
56
- <tr><td><code>--json-schema &lt;schema&gt;</code></td><td>JSON Schema for structured output validation</td></tr>
57
- <tr><td><code>--thinking &lt;mode&gt;</code></td><td>Thinking mode: enabled, adaptive, disabled</td></tr>
58
- <tr><td><code>--max-turns &lt;turns&gt;</code></td><td>Max agentic turns in non-interactive mode</td></tr>
59
- <tr><td><code>--max-budget-usd &lt;amount&gt;</code></td><td>Max API spend (print mode only)</td></tr>
60
- <tr><td><code>--fallback-model &lt;model&gt;</code></td><td>Fallback when primary model is overloaded</td></tr>
61
- <tr><td><code>--betas &lt;betas...&gt;</code></td><td>Beta headers for API requests</td></tr>
62
- <tr><td><code>--ide</code></td><td>Auto-connect to IDE on startup</td></tr>
63
- <tr><td><code>--chrome / --no-chrome</code></td><td>Enable/disable Claude in Chrome integration</td></tr>
64
- <tr><td><code>--computer</code></td><td>Enable Computer Use tool (Windows only)</td></tr>
65
- <tr><td><code>--no-session-persistence</code></td><td>Disable session save to disk (print mode only)</td></tr>
66
- <tr><td><code>--disable-slash-commands</code></td><td>Disable all skills</td></tr>
67
- <tr><td><code>--prefill &lt;text&gt;</code></td><td>Pre-fill prompt input without submitting</td></tr>
68
- <tr><td><code>--file &lt;specs...&gt;</code></td><td>Download file resources at startup</td></tr>
69
- </table>
70
-
71
- <h2>Environment Variables</h2>
72
-
73
- <h3>Provider API Keys</h3>
74
- <p>27 providers — set one or more. See <a href="providers.html">Providers page</a> for the full list.</p>
75
-
76
- <h3>Runtime &amp; Feature Flags</h3>
77
- <table>
78
- <tr><th>Variable</th><th>Purpose</th></tr>
79
- <tr><td><code>DEBUG</code></td><td>Debug logging with optional category filter</td></tr>
80
- <tr><td><code>NO_COLOR</code> / <code>FORCE_COLOR</code></td><td>Terminal color control</td></tr>
81
- <tr><td><code>BRIDGE_MODE=1</code></td><td>Enable WebSocket bridge for remote control</td></tr>
82
- <tr><td><code>VOICE_MODE=1</code></td><td>Enable voice mode</td></tr>
83
- <tr><td><code>KAIROS=1</code></td><td>Enable proactive/brief/assistant features</td></tr>
84
- <tr><td><code>ENABLE_LSP_TOOL=1</code></td><td>Enable LSP tool integration</td></tr>
85
- <tr><td><code>ENABLE_COMPUTER_USE=1</code></td><td>Enable Computer Use tool (Windows)</td></tr>
86
- <tr><td><code>CLAUDECODE_NO_RESPAWN</code></td><td>Disable process respawn</td></tr>
87
- <tr><td><code>CODE_INDEX=1</code></td><td>Enable fuzzy code search tool</td></tr>
88
- <tr><td><code>AGENT_TRIGGERS=1</code></td><td>Enable autonomous scheduled task triggers</td></tr>
89
- <tr><td><code>SENTRY_DSN</code></td><td>Enable Sentry error reporting (opt-in)</td></tr>
90
- <tr><td><code>TAVILY_API_KEY</code></td><td>Tavily web search (highest priority)</td></tr>
91
- <tr><td><code>BRAVE_API_KEY</code></td><td>Brave web search</td></tr>
92
- <tr><td><code>SERPER_API_KEY</code></td><td>Serper web search</td></tr>
93
- <tr><td><code>SEARXNG_INSTANCE_URL</code></td><td>Self-hosted SearXNG URL</td></tr>
94
- </table>
95
-
96
- <h2>Settings File</h2>
97
- <p>Config file at <code>~/.clew/settings.json</code> (TypeBox-validated). Stores:</p>
98
- <ul>
99
- <li>Default provider and model</li>
100
- <li>Permission mode and rules</li>
101
- <li>Workspace directories</li>
102
- <li>Plugin and MCP server configs</li>
103
- <li>Theme and UI preferences</li>
104
- <li>Session persistence settings</li>
105
- </ul>
106
-
107
- <h2>Config Paths</h2>
108
- <table>
109
- <tr><th>Path</th><th>Content</th></tr>
110
- <tr><td><code>~/.clew/settings.json</code></td><td>Main configuration (TypeBox schema)</td></tr>
111
- <tr><td><code>~/.clew/credentials/</code></td><td>Stored credentials</td></tr>
112
- <tr><td><code>~/.clew/sessions/</code></td><td>Session persistence</td></tr>
113
- <tr><td><code>~/.clew/logs/</code></td><td>Debug and error logs</td></tr>
114
- <tr><td><code>~/.clew/skills/</code></td><td>User-installed skills</td></tr>
115
- <tr><td><code>.clew/skills/</code></td><td>Project-level skills</td></tr>
116
- </table>
117
-
118
- <h2>In-Session Configuration</h2>
119
- <pre><code>/config # Open config panel (aliases: settings)
120
- /theme # Change the theme
121
- /color # Set prompt bar color
122
- /keybindings # Edit keybindings
123
- /permissions # Manage permission rules</code></pre>
124
-
125
- <h2>Build Configuration</h2>
126
- <p>Build via <code>bun run build</code> with compile-time feature defines:</p>
127
- <pre><code># In src/main.tsx:
128
- --define.TRANSCRIPT_CLASSIFIER=true # Enables auto permission mode
129
- --define.CHICAGO_MCP=true # Enables Chicago MCP features
130
- --define.VOICE_MODE=true # Enables voice input support</code></pre>
131
-
132
- <footer class="footer">
133
- <span>Clew Code v0.2.7 — Open Source</span>
134
- <div class="footer-links">
135
- <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
136
- <a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
137
- </div>
138
- </footer>
139
- </main>
140
- <nav class="toc-sidebar"></nav>
141
- </div>
142
- </div>
143
- <script src="js/main.js"></script>
144
- </body>
145
- </html>
146
-
147
-
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Configuration — Clew</title>
7
+ <meta name="description" content="Comprehensive configuration guide for Clew — CLI flags, environment variables, settings file, and in-session commands.">
8
+ <link rel="preconnect" href="https://fonts.googleapis.com">
9
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
+ <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
11
+ <link rel="stylesheet" href="css/styles.css">
12
+ <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
+ </head>
14
+ <body>
15
+ <header class="header"></header>
16
+ <div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
17
+ <div class="content-wrap"><main class="content">
18
+ <div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Configuration</span></div>
19
+ <h1>Configuration</h1>
20
+ <p class="section-subtitle">Clew is configured through CLI flags (Commander.js), environment variables, a JSON settings file (validated with Zod), and in-session slash commands.</p>
21
+
22
+ <h2>CLI Flags</h2>
23
+ <p>Defined in <code>src/main.tsx</code> with Commander.js <code>.option()</code> and <code>.addOption()</code>:</p>
24
+ <table>
25
+ <tr><th>Flag</th><th>Description</th></tr>
26
+ <tr><td><code>-p, --print</code></td><td>Print response and exit (useful for pipes). Skips workspace trust dialog.</td></tr>
27
+ <tr><td><code>--bare</code></td><td>Minimal mode: skip hooks, LSP, plugins, attribution, auto-memory, keychain reads, CLEW.md discovery. Sets CLEW_CODE_SIMPLE=1.</td></tr>
28
+ <tr><td><code>-d, --debug [filter]</code></td><td>Enable debug mode with optional category filtering (e.g., "api,hooks" or "!1p,!file")</td></tr>
29
+ <tr><td><code>--debug-file &lt;path&gt;</code></td><td>Write debug logs to a file</td></tr>
30
+ <tr><td><code>--verbose</code></td><td>Override verbose mode setting from config</td></tr>
31
+ <tr><td><code>--model &lt;model&gt;</code></td><td>Model for the current session (alias or full ID)</td></tr>
32
+ <tr><td><code>--effort &lt;level&gt;</code></td><td>Effort level: low, medium, high, max</td></tr>
33
+ <tr><td><code>--agent &lt;agent&gt;</code></td><td>Agent for the current session</td></tr>
34
+ <tr><td><code>--permission-mode &lt;mode&gt;</code></td><td>Permission mode (default, ask, plan, auto, acceptEdits, bypassPermissions, dontAsk)</td></tr>
35
+ <tr><td><code>--dangerously-skip-permissions</code></td><td>Bypass all permission checks (sandbox only)</td></tr>
36
+ <tr><td><code>--allow-dangerously-skip-permissions</code></td><td>Enable bypass as an option without enabling by default</td></tr>
37
+ <tr><td><code>--allowedTools, --allowed-tools</code></td><td>Comma/space-separated tool names to allow (e.g., "Bash(git:*) Edit")</td></tr>
38
+ <tr><td><code>--disallowedTools, --disallowed-tools</code></td><td>Comma/space-separated tool names to deny</td></tr>
39
+ <tr><td><code>--tools &lt;tools...&gt;</code></td><td>Specify available tools from built-in set</td></tr>
40
+ <tr><td><code>--mcp-config &lt;configs...&gt;</code></td><td>Load MCP servers from JSON files or strings</td></tr>
41
+ <tr><td><code>--strict-mcp-config</code></td><td>Only use MCP servers from --mcp-config</td></tr>
42
+ <tr><td><code>--plugin-dir &lt;path&gt;</code></td><td>Load plugins from a directory (repeatable)</td></tr>
43
+ <tr><td><code>--settings &lt;file-or-json&gt;</code></td><td>Path to a settings JSON file or JSON string</td></tr>
44
+ <tr><td><code>--add-dir &lt;directories...&gt;</code></td><td>Additional directories to allow tool access</td></tr>
45
+ <tr><td><code>--system-prompt &lt;prompt&gt;</code></td><td>Custom system prompt</td></tr>
46
+ <tr><td><code>--system-prompt-file &lt;file&gt;</code></td><td>Read system prompt from a file</td></tr>
47
+ <tr><td><code>--append-system-prompt &lt;prompt&gt;</code></td><td>Append to default system prompt</td></tr>
48
+ <tr><td><code>--continue, -c</code></td><td>Continue the most recent conversation</td></tr>
49
+ <tr><td><code>--resume, -r [value]</code></td><td>Resume a conversation by session ID or picker</td></tr>
50
+ <tr><td><code>--fork-session</code></td><td>When resuming, create a new session ID</td></tr>
51
+ <tr><td><code>--session-id &lt;uuid&gt;</code></td><td>Use a specific session ID</td></tr>
52
+ <tr><td><code>--name, -n &lt;name&gt;</code></td><td>Display name for this session</td></tr>
53
+ <tr><td><code>--agents &lt;json&gt;</code></td><td>JSON defining custom agents</td></tr>
54
+ <tr><td><code>--output-format &lt;format&gt;</code></td><td>text, json, or stream-json (with --print)</td></tr>
55
+ <tr><td><code>--input-format &lt;format&gt;</code></td><td>text or stream-json (with --print)</td></tr>
56
+ <tr><td><code>--json-schema &lt;schema&gt;</code></td><td>JSON Schema for structured output validation</td></tr>
57
+ <tr><td><code>--thinking &lt;mode&gt;</code></td><td>Thinking mode: enabled, adaptive, disabled</td></tr>
58
+ <tr><td><code>--max-turns &lt;turns&gt;</code></td><td>Max agentic turns in non-interactive mode</td></tr>
59
+ <tr><td><code>--max-budget-usd &lt;amount&gt;</code></td><td>Max API spend (print mode only)</td></tr>
60
+ <tr><td><code>--fallback-model &lt;model&gt;</code></td><td>Fallback when primary model is overloaded</td></tr>
61
+ <tr><td><code>--betas &lt;betas...&gt;</code></td><td>Beta headers for API requests</td></tr>
62
+ <tr><td><code>--ide</code></td><td>Auto-connect to IDE on startup</td></tr>
63
+ <tr><td><code>--chrome / --no-chrome</code></td><td>Enable/disable Claude in Chrome integration</td></tr>
64
+ <tr><td><code>--computer</code></td><td>Enable Computer Use tool (Windows only)</td></tr>
65
+ <tr><td><code>--no-session-persistence</code></td><td>Disable session save to disk (print mode only)</td></tr>
66
+ <tr><td><code>--disable-slash-commands</code></td><td>Disable all skills</td></tr>
67
+ <tr><td><code>--prefill &lt;text&gt;</code></td><td>Pre-fill prompt input without submitting</td></tr>
68
+ <tr><td><code>--file &lt;specs...&gt;</code></td><td>Download file resources at startup</td></tr>
69
+ </table>
70
+
71
+ <h2>Environment Variables</h2>
72
+
73
+ <h3>Provider API Keys</h3>
74
+ <p>28 providers — set one or more. See <a href="providers.html">Providers page</a> for the full list.</p>
75
+
76
+ <h3>Runtime &amp; Feature Flags</h3>
77
+ <table>
78
+ <tr><th>Variable</th><th>Purpose</th></tr>
79
+ <tr><td><code>DEBUG</code></td><td>Debug logging with optional category filter</td></tr>
80
+ <tr><td><code>NO_COLOR</code> / <code>FORCE_COLOR</code></td><td>Terminal color control</td></tr>
81
+ <tr><td><code>BRIDGE_MODE=1</code></td><td>Enable WebSocket bridge for remote control</td></tr>
82
+ <tr><td><code>VOICE_MODE=1</code></td><td>Enable voice mode</td></tr>
83
+ <tr><td><code>KAIROS=1</code></td><td>Enable proactive/brief/assistant features</td></tr>
84
+ <tr><td><code>ENABLE_LSP_TOOL=1</code></td><td>Enable LSP tool integration</td></tr>
85
+ <tr><td><code>ENABLE_COMPUTER_USE=1</code></td><td>Enable Computer Use tool (Windows)</td></tr>
86
+ <tr><td><code>CLAUDECODE_NO_RESPAWN</code></td><td>Disable process respawn</td></tr>
87
+ <tr><td><code>CODE_INDEX=1</code></td><td>Enable fuzzy code search tool</td></tr>
88
+ <tr><td><code>AGENT_TRIGGERS=1</code></td><td>Enable autonomous scheduled task triggers</td></tr>
89
+ <tr><td><code>SENTRY_DSN</code></td><td>Enable Sentry error reporting (opt-in)</td></tr>
90
+ <tr><td><code>TAVILY_API_KEY</code></td><td>Tavily web search (highest priority)</td></tr>
91
+ <tr><td><code>BRAVE_API_KEY</code></td><td>Brave web search</td></tr>
92
+ <tr><td><code>SERPER_API_KEY</code></td><td>Serper web search</td></tr>
93
+ <tr><td><code>SEARXNG_INSTANCE_URL</code></td><td>Self-hosted SearXNG URL</td></tr>
94
+ </table>
95
+
96
+ <h2>Settings File</h2>
97
+ <p>Config file at <code>~/.clew/settings.json</code> (TypeBox-validated). Stores:</p>
98
+ <ul>
99
+ <li>Default provider and model</li>
100
+ <li>Permission mode and rules</li>
101
+ <li>Workspace directories</li>
102
+ <li>Plugin and MCP server configs</li>
103
+ <li>Theme and UI preferences</li>
104
+ <li>Session persistence settings</li>
105
+ </ul>
106
+
107
+ <h2>Config Paths</h2>
108
+ <table>
109
+ <tr><th>Path</th><th>Content</th></tr>
110
+ <tr><td><code>~/.clew/settings.json</code></td><td>Main configuration (TypeBox schema)</td></tr>
111
+ <tr><td><code>~/.clew/credentials/</code></td><td>Stored credentials</td></tr>
112
+ <tr><td><code>~/.clew/sessions/</code></td><td>Session persistence</td></tr>
113
+ <tr><td><code>~/.clew/logs/</code></td><td>Debug and error logs</td></tr>
114
+ <tr><td><code>~/.clew/skills/</code></td><td>User-installed skills</td></tr>
115
+ <tr><td><code>.clew/skills/</code></td><td>Project-level skills</td></tr>
116
+ </table>
117
+
118
+ <h2>In-Session Configuration</h2>
119
+ <pre><code>/config # Open config panel (aliases: settings)
120
+ /theme # Change the theme
121
+ /color # Set prompt bar color
122
+ /keybindings # Edit keybindings
123
+ /permissions # Manage permission rules</code></pre>
124
+
125
+ <h2>Build Configuration</h2>
126
+ <p>Build via <code>bun run build</code> with compile-time feature defines:</p>
127
+ <pre><code># In src/main.tsx:
128
+ --define.TRANSCRIPT_CLASSIFIER=true # Enables auto permission mode
129
+ --define.CHICAGO_MCP=true # Enables Chicago MCP features
130
+ --define.VOICE_MODE=true # Enables voice input support</code></pre>
131
+
132
+ <footer class="footer">
133
+ <span>Clew Code 0.2.13 — Open Source</span>
134
+ <div class="footer-links">
135
+ <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
136
+ <a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
137
+ </div>
138
+ </footer>
139
+ </main>
140
+ <nav class="toc-sidebar"></nav>
141
+ </div>
142
+ </div>
143
+ <script src="js/main.js"></script>
144
+ </body>
145
+ </html>
146
+
147
+
@@ -1,108 +1,108 @@
1
- <!DOCTYPE html>
2
- <html lang="th">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>การตั้งค่า — Clew</title>
7
- <meta name="description" content="คู่มือการตั้งค่า Clew อย่างครอบคลุม — CLI flags, ตัวแปรสภาพแวดล้อม, ไฟล์ตั้งค่า, และคำสั่งในเซสชัน">
8
- <link rel="preconnect" href="https://fonts.googleapis.com">
9
- <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
- <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Thai:wght@400;500;600;700&display=swap" rel="stylesheet">
11
- <link rel="stylesheet" href="css/styles.css">
12
- <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
- </head>
14
- <body>
15
- <header class="header"></header>
16
- <div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
17
- <div class="content-wrap"><main class="content">
18
- <div class="breadcrumbs"><a href="index.th.html">หน้าแรก</a><span class="sep">/</span><span>การตั้งค่า</span></div>
19
- <h1>การตั้งค่า</h1>
20
- <p class="section-subtitle">Clew ถูกตั้งค่าผ่าน CLI flags (Commander.js), ตัวแปรสภาพแวดล้อม, ไฟล์ตั้งค่า JSON (<code>~/.clew/settings.json</code> ตรวจสอบด้วย TypeBox), และคำสั่ง slash ในเซสชัน</p>
21
-
22
- <h2>CLI Flags</h2>
23
- <p>กำหนดใน <code>src/main.tsx</code> ด้วย Commander.js <code>.option()</code> และ <code>.addOption()</code>:</p>
24
- <table>
25
- <tr><th>Flag</th><th>คำอธิบาย</th></tr>
26
- <tr><td><code>-p, --print</code></td><td>พิมพ์คำตอบและออก (มีประโยชน์สำหรับ pipes) ข้ามกล่องโต้ตอบ trust workspace</td></tr>
27
- <tr><td><code>--bare</code></td><td>โหมด minimal: ข้าม hooks, LSP, plugins, attribution, auto-memory, keychain reads, CLEW.md discovery</td></tr>
28
- <tr><td><code>-d, --debug [filter]</code></td><td>เปิดโหมด debug พร้อมตัวกรองหมวดหมู่</td></tr>
29
- <tr><td><code>--debug-file &lt;path&gt;</code></td><td>เขียน debug logs ไปยังไฟล์</td></tr>
30
- <tr><td><code>--verbose</code></td><td>แทนที่การตั้งค่า verbose mode จากการตั้งค่า</td></tr>
31
- <tr><td><code>--model &lt;model&gt;</code></td><td>โมเดลสำหรับเซสชันปัจจุบัน (alias หรือ ID เต็ม)</td></tr>
32
- <tr><td><code>--effort &lt;level&gt;</code></td><td>ระดับความพยายาม: low, medium, high, max</td></tr>
33
- <tr><td><code>--permission-mode &lt;mode&gt;</code></td><td>โหมดสิทธิ์ (default, ask, plan, auto, acceptEdits, bypassPermissions, dontAsk)</td></tr>
34
- <tr><td><code>--allowedTools</code></td><td>รายชื่อเครื่องมือที่อนุญาต คั่นด้วยเครื่องหมายจุลภาค/ช่องว่าง</td></tr>
35
- <tr><td><code>--disallowedTools</code></td><td>รายชื่อเครื่องมือที่ปฏิเสธ</td></tr>
36
- <tr><td><code>--mcp-config &lt;configs...&gt;</code></td><td>โหลดเซิร์ฟเวอร์ MCP จากไฟล์ JSON หรือสตริง</td></tr>
37
- <tr><td><code>--settings &lt;file-or-json&gt;</code></td><td>พาธไปยังไฟล์ตั้งค่า JSON หรือสตริง JSON</td></tr>
38
- <tr><td><code>--system-prompt &lt;prompt&gt;</code></td><td>system prompt ที่กำหนดเอง</td></tr>
39
- <tr><td><code>--continue, -c</code></td><td>ต่อการสนทนาล่าสุด</td></tr>
40
- <tr><td><code>--resume, -r [value]</code></td><td>กลับมาเซสชันตาม ID หรือตัวเลือก</td></tr>
41
- <tr><td><code>--output-format &lt;format&gt;</code></td><td>text, json, หรือ stream-json (ใช้กับ --print)</td></tr>
42
- <tr><td><code>--thinking &lt;mode&gt;</code></td><td>โหมดการคิด: enabled, adaptive, disabled</td></tr>
43
- <tr><td><code>--max-turns &lt;turns&gt;</code></td><td>จำนวนรอบสูงสุดในโหมดไม่โต้ตอบ</td></tr>
44
- <tr><td><code>--fallback-model &lt;model&gt;</code></td><td>โมเดลสำรองเมื่อโมเดลหลักโอเวอร์โหลด</td></tr>
45
- </table>
46
-
47
- <h2>ตัวแปรสภาพแวดล้อม</h2>
48
- <h3>คีย์ API ผู้ให้บริการ</h3>
49
- <p>27 ผู้ให้บริการ — ตั้งอย่างน้อยหนึ่งรายการ ดู <a href="providers.th.html">หน้าผู้ให้บริการ</a> สำหรับรายการทั้งหมด</p>
50
-
51
- <h3>Runtime และ Feature Flags</h3>
52
- <table>
53
- <tr><th>ตัวแปร</th><th>วัตถุประสงค์</th></tr>
54
- <tr><td><code>DEBUG</code></td><td>Debug logging พร้อมตัวกรองหมวดหมู่</td></tr>
55
- <tr><td><code>NO_COLOR</code> / <code>FORCE_COLOR</code></td><td>ควบคุมสีเทอร์มินัล</td></tr>
56
- <tr><td><code>BRIDGE_MODE=1</code></td><td>เปิดใช้งาน WebSocket bridge สำหรับควบคุมระยะไกล</td></tr>
57
- <tr><td><code>VOICE_MODE=1</code></td><td>เปิดใช้งานโหมดเสียง</td></tr>
58
- <tr><td><code>KAIROS=1</code></td><td>เปิดใช้งานฟีเจอร์ proactive/brief/assistant</td></tr>
59
- <tr><td><code>ENABLE_LSP_TOOL=1</code></td><td>เปิดใช้งาน LSP tool integration</td></tr>
60
- <tr><td><code>CODE_INDEX=1</code></td><td>เปิดใช้งานการค้นหาโค้ดแบบ fuzzy</td></tr>
61
- <tr><td><code>SENTRY_DSN</code></td><td>เปิดใช้งาน Sentry error reporting (opt-in)</td></tr>
62
- </table>
63
-
64
- <h2>ไฟล์ตั้งค่า</h2>
65
- <p>ไฟล์ตั้งค่าที่ <code>~/.clew/settings.json</code> (ตรวจสอบด้วย TypeBox) เก็บ:</p>
66
- <ul>
67
- <li>ผู้ให้บริการและโมเดลเริ่มต้น</li>
68
- <li>โหมดสิทธิ์และกฎ</li>
69
- <li>ไดเรกทอรี workspace</li>
70
- <li>การตั้งค่าปลั๊กอินและเซิร์ฟเวอร์ MCP</li>
71
- <li>ค่ากำหนดธีมและ UI</li>
72
- <li>การตั้งค่าการคงอยู่ของเซสชัน</li>
73
- </ul>
74
-
75
- <h2>เส้นทางการตั้งค่า</h2>
76
- <table>
77
- <tr><th>พาธ</th><th>เนื้อหา</th></tr>
78
- <tr><td><code>~/.claude/settings.json</code></td><td>การตั้งค่าหลัก (TypeBox schema)</td></tr>
79
- <tr><td><code>~/.claude/credentials/</code></td><td>ข้อมูลประจำตัวที่เก็บไว้</td></tr>
80
- <tr><td><code>~/.claude/sessions/</code></td><td>การคงอยู่ของเซสชัน</td></tr>
81
- <tr><td><code>~/.claude/logs/</code></td><td>Debug และ error logs</td></tr>
82
- <tr><td><code>~/.claude/skills/</code></td><td>สกิลที่ผู้ใช้ติดตั้ง</td></tr>
83
- <tr><td><code>.claude/skills/</code></td><td>สกิลระดับโปรเจกต์</td></tr>
84
- </table>
85
-
86
- <h2>การตั้งค่าในเซสชัน</h2>
87
- <pre><code>/config # เปิดแผงตั้งค่า
88
- /theme # เปลี่ยนธีม
89
- /color # ตั้งค่าสีแถบ prompt
90
- /keybindings # แก้ไขคีย์ลัด
91
- /permissions # จัดการกฎสิทธิ์</code></pre>
92
-
93
- <footer class="footer">
94
- <span>Clew Code v0.2.7 — โอเพนซอร์ส</span>
95
- <div class="footer-links">
96
- <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
97
- <a href="https://github.com/ClewCode/ClewCode/issues">ปัญหา</a>
98
- </div>
99
- </footer>
100
- </main>
101
- <nav class="toc-sidebar"></nav>
102
- </div>
103
- </div>
104
- <script src="js/main.js"></script>
105
- </body>
106
- </html>
107
-
108
-
1
+ <!DOCTYPE html>
2
+ <html lang="th">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>การตั้งค่า — Clew</title>
7
+ <meta name="description" content="คู่มือการตั้งค่า Clew อย่างครอบคลุม — CLI flags, ตัวแปรสภาพแวดล้อม, ไฟล์ตั้งค่า, และคำสั่งในเซสชัน">
8
+ <link rel="preconnect" href="https://fonts.googleapis.com">
9
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
10
+ <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Thai:wght@400;500;600;700&display=swap" rel="stylesheet">
11
+ <link rel="stylesheet" href="css/styles.css">
12
+ <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
+ </head>
14
+ <body>
15
+ <header class="header"></header>
16
+ <div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
17
+ <div class="content-wrap"><main class="content">
18
+ <div class="breadcrumbs"><a href="index.th.html">หน้าแรก</a><span class="sep">/</span><span>การตั้งค่า</span></div>
19
+ <h1>การตั้งค่า</h1>
20
+ <p class="section-subtitle">Clew ถูกตั้งค่าผ่าน CLI flags (Commander.js), ตัวแปรสภาพแวดล้อม, ไฟล์ตั้งค่า JSON (<code>~/.clew/settings.json</code> ตรวจสอบด้วย TypeBox), และคำสั่ง slash ในเซสชัน</p>
21
+
22
+ <h2>CLI Flags</h2>
23
+ <p>กำหนดใน <code>src/main.tsx</code> ด้วย Commander.js <code>.option()</code> และ <code>.addOption()</code>:</p>
24
+ <table>
25
+ <tr><th>Flag</th><th>คำอธิบาย</th></tr>
26
+ <tr><td><code>-p, --print</code></td><td>พิมพ์คำตอบและออก (มีประโยชน์สำหรับ pipes) ข้ามกล่องโต้ตอบ trust workspace</td></tr>
27
+ <tr><td><code>--bare</code></td><td>โหมด minimal: ข้าม hooks, LSP, plugins, attribution, auto-memory, keychain reads, CLEW.md discovery</td></tr>
28
+ <tr><td><code>-d, --debug [filter]</code></td><td>เปิดโหมด debug พร้อมตัวกรองหมวดหมู่</td></tr>
29
+ <tr><td><code>--debug-file &lt;path&gt;</code></td><td>เขียน debug logs ไปยังไฟล์</td></tr>
30
+ <tr><td><code>--verbose</code></td><td>แทนที่การตั้งค่า verbose mode จากการตั้งค่า</td></tr>
31
+ <tr><td><code>--model &lt;model&gt;</code></td><td>โมเดลสำหรับเซสชันปัจจุบัน (alias หรือ ID เต็ม)</td></tr>
32
+ <tr><td><code>--effort &lt;level&gt;</code></td><td>ระดับความพยายาม: low, medium, high, max</td></tr>
33
+ <tr><td><code>--permission-mode &lt;mode&gt;</code></td><td>โหมดสิทธิ์ (default, ask, plan, auto, acceptEdits, bypassPermissions, dontAsk)</td></tr>
34
+ <tr><td><code>--allowedTools</code></td><td>รายชื่อเครื่องมือที่อนุญาต คั่นด้วยเครื่องหมายจุลภาค/ช่องว่าง</td></tr>
35
+ <tr><td><code>--disallowedTools</code></td><td>รายชื่อเครื่องมือที่ปฏิเสธ</td></tr>
36
+ <tr><td><code>--mcp-config &lt;configs...&gt;</code></td><td>โหลดเซิร์ฟเวอร์ MCP จากไฟล์ JSON หรือสตริง</td></tr>
37
+ <tr><td><code>--settings &lt;file-or-json&gt;</code></td><td>พาธไปยังไฟล์ตั้งค่า JSON หรือสตริง JSON</td></tr>
38
+ <tr><td><code>--system-prompt &lt;prompt&gt;</code></td><td>system prompt ที่กำหนดเอง</td></tr>
39
+ <tr><td><code>--continue, -c</code></td><td>ต่อการสนทนาล่าสุด</td></tr>
40
+ <tr><td><code>--resume, -r [value]</code></td><td>กลับมาเซสชันตาม ID หรือตัวเลือก</td></tr>
41
+ <tr><td><code>--output-format &lt;format&gt;</code></td><td>text, json, หรือ stream-json (ใช้กับ --print)</td></tr>
42
+ <tr><td><code>--thinking &lt;mode&gt;</code></td><td>โหมดการคิด: enabled, adaptive, disabled</td></tr>
43
+ <tr><td><code>--max-turns &lt;turns&gt;</code></td><td>จำนวนรอบสูงสุดในโหมดไม่โต้ตอบ</td></tr>
44
+ <tr><td><code>--fallback-model &lt;model&gt;</code></td><td>โมเดลสำรองเมื่อโมเดลหลักโอเวอร์โหลด</td></tr>
45
+ </table>
46
+
47
+ <h2>ตัวแปรสภาพแวดล้อม</h2>
48
+ <h3>คีย์ API ผู้ให้บริการ</h3>
49
+ <p>27 ผู้ให้บริการ — ตั้งอย่างน้อยหนึ่งรายการ ดู <a href="providers.th.html">หน้าผู้ให้บริการ</a> สำหรับรายการทั้งหมด</p>
50
+
51
+ <h3>Runtime และ Feature Flags</h3>
52
+ <table>
53
+ <tr><th>ตัวแปร</th><th>วัตถุประสงค์</th></tr>
54
+ <tr><td><code>DEBUG</code></td><td>Debug logging พร้อมตัวกรองหมวดหมู่</td></tr>
55
+ <tr><td><code>NO_COLOR</code> / <code>FORCE_COLOR</code></td><td>ควบคุมสีเทอร์มินัล</td></tr>
56
+ <tr><td><code>BRIDGE_MODE=1</code></td><td>เปิดใช้งาน WebSocket bridge สำหรับควบคุมระยะไกล</td></tr>
57
+ <tr><td><code>VOICE_MODE=1</code></td><td>เปิดใช้งานโหมดเสียง</td></tr>
58
+ <tr><td><code>KAIROS=1</code></td><td>เปิดใช้งานฟีเจอร์ proactive/brief/assistant</td></tr>
59
+ <tr><td><code>ENABLE_LSP_TOOL=1</code></td><td>เปิดใช้งาน LSP tool integration</td></tr>
60
+ <tr><td><code>CODE_INDEX=1</code></td><td>เปิดใช้งานการค้นหาโค้ดแบบ fuzzy</td></tr>
61
+ <tr><td><code>SENTRY_DSN</code></td><td>เปิดใช้งาน Sentry error reporting (opt-in)</td></tr>
62
+ </table>
63
+
64
+ <h2>ไฟล์ตั้งค่า</h2>
65
+ <p>ไฟล์ตั้งค่าที่ <code>~/.clew/settings.json</code> (ตรวจสอบด้วย TypeBox) เก็บ:</p>
66
+ <ul>
67
+ <li>ผู้ให้บริการและโมเดลเริ่มต้น</li>
68
+ <li>โหมดสิทธิ์และกฎ</li>
69
+ <li>ไดเรกทอรี workspace</li>
70
+ <li>การตั้งค่าปลั๊กอินและเซิร์ฟเวอร์ MCP</li>
71
+ <li>ค่ากำหนดธีมและ UI</li>
72
+ <li>การตั้งค่าการคงอยู่ของเซสชัน</li>
73
+ </ul>
74
+
75
+ <h2>เส้นทางการตั้งค่า</h2>
76
+ <table>
77
+ <tr><th>พาธ</th><th>เนื้อหา</th></tr>
78
+ <tr><td><code>~/.claude/settings.json</code></td><td>การตั้งค่าหลัก (TypeBox schema)</td></tr>
79
+ <tr><td><code>~/.claude/credentials/</code></td><td>ข้อมูลประจำตัวที่เก็บไว้</td></tr>
80
+ <tr><td><code>~/.claude/sessions/</code></td><td>การคงอยู่ของเซสชัน</td></tr>
81
+ <tr><td><code>~/.claude/logs/</code></td><td>Debug และ error logs</td></tr>
82
+ <tr><td><code>~/.claude/skills/</code></td><td>สกิลที่ผู้ใช้ติดตั้ง</td></tr>
83
+ <tr><td><code>.claude/skills/</code></td><td>สกิลระดับโปรเจกต์</td></tr>
84
+ </table>
85
+
86
+ <h2>การตั้งค่าในเซสชัน</h2>
87
+ <pre><code>/config # เปิดแผงตั้งค่า
88
+ /theme # เปลี่ยนธีม
89
+ /color # ตั้งค่าสีแถบ prompt
90
+ /keybindings # แก้ไขคีย์ลัด
91
+ /permissions # จัดการกฎสิทธิ์</code></pre>
92
+
93
+ <footer class="footer">
94
+ <span>Clew Code 0.2.13 — โอเพนซอร์ส</span>
95
+ <div class="footer-links">
96
+ <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
97
+ <a href="https://github.com/ClewCode/ClewCode/issues">ปัญหา</a>
98
+ </div>
99
+ </footer>
100
+ </main>
101
+ <nav class="toc-sidebar"></nav>
102
+ </div>
103
+ </div>
104
+ <script src="js/main.js"></script>
105
+ </body>
106
+ </html>
107
+
108
+