clew-code 0.2.4 → 0.2.5
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.md +264 -292
- package/dist/clew-dev.js +5118 -2840
- package/dist/main.js +2358 -2133
- package/docs/_config.yml +1 -1
- package/docs/architecture.html +145 -166
- package/docs/architecture.th.html +2 -23
- package/docs/commands.html +1 -22
- package/docs/commands.th.html +1 -22
- package/docs/configuration.html +145 -166
- package/docs/configuration.th.html +2 -23
- package/docs/css/styles.css +22 -0
- package/docs/daemon.html +128 -160
- package/docs/daemon.th.html +2 -30
- package/docs/features/bridge-mode.html +98 -98
- package/docs/features/bridge-mode.th.html +1 -1
- package/docs/features/evals.html +181 -181
- package/docs/features/evals.th.html +1 -1
- package/docs/features/searxng-search.html +150 -150
- package/docs/features/searxng-search.th.html +1 -1
- package/docs/features/sentry-setup.html +156 -156
- package/docs/features/sentry-setup.th.html +1 -1
- package/docs/index.html +298 -333
- package/docs/index.th.html +1 -36
- package/docs/installation.html +103 -124
- package/docs/installation.th.html +2 -23
- package/docs/internals/growthbook-ab-testing.html +112 -112
- package/docs/internals/growthbook-ab-testing.th.html +1 -1
- package/docs/internals/hidden-features.html +147 -147
- package/docs/internals/hidden-features.th.html +1 -1
- package/docs/js/main.js +78 -7
- package/docs/loop.html +180 -0
- package/docs/loop.th.html +226 -0
- package/docs/mcp.html +246 -157
- package/docs/mcp.th.html +156 -60
- package/docs/models.html +1 -22
- package/docs/models.th.html +1 -22
- package/docs/peer.html +235 -0
- package/docs/peer.th.html +279 -0
- package/docs/permission-model.html +101 -122
- package/docs/permission-model.th.html +2 -23
- package/docs/plugins.html +101 -122
- package/docs/plugins.th.html +2 -23
- package/docs/providers.html +117 -138
- package/docs/providers.th.html +2 -23
- package/docs/quick-start.html +92 -120
- package/docs/quick-start.th.html +1 -29
- package/docs/research-memory.html +79 -111
- package/docs/research-memory.th.html +2 -30
- package/docs/skills.html +116 -137
- package/docs/skills.th.html +2 -23
- package/docs/taste.html +96 -29
- package/docs/taste.th.html +193 -54
- package/docs/tools.html +169 -190
- package/docs/tools.th.html +2 -23
- package/docs/troubleshooting.html +105 -126
- package/docs/troubleshooting.th.html +2 -23
- package/package.json +2 -2
|
@@ -1,126 +1,105 @@
|
|
|
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>Troubleshooting — Clew</title>
|
|
7
|
-
<meta name="description" content="Common issues and solutions for Clew — provider keys, build errors, MCP, plugins, and runtime problems.">
|
|
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"
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
</
|
|
36
|
-
|
|
37
|
-
<
|
|
38
|
-
<
|
|
39
|
-
|
|
40
|
-
<
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
<
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
<
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
<
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
<
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
<
|
|
71
|
-
<
|
|
72
|
-
|
|
73
|
-
<
|
|
74
|
-
<
|
|
75
|
-
<
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
<
|
|
84
|
-
<
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
<
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
<li><strong>In-app diagnostics:</strong> <code>/doctor</code> — comprehensive environment check</li>
|
|
107
|
-
<li><strong>Status overview:</strong> <code>/status</code> — version, model, API connectivity, tool statuses</li>
|
|
108
|
-
<li><strong>GitHub Issues:</strong> Report bugs and feature requests</li>
|
|
109
|
-
<li><strong>Debug mode:</strong> Run with <code>DEBUG=1</code> or <code>DEBUG=provider:anthropic</code> for detailed logging</li>
|
|
110
|
-
</ul>
|
|
111
|
-
|
|
112
|
-
<footer class="footer">
|
|
113
|
-
<span>Clew v0.1.2 — Open Source</span>
|
|
114
|
-
<div class="footer-links">
|
|
115
|
-
<a href="https://github.com/JonusNattapong/ClewCode">GitHub</a>
|
|
116
|
-
<a href="https://github.com/JonusNattapong/ClewCode/issues">Issues</a>
|
|
117
|
-
<a href="https://npmjs.com/package/clew-code">npm</a>
|
|
118
|
-
</div>
|
|
119
|
-
</footer>
|
|
120
|
-
</main>
|
|
121
|
-
<nav class="toc-sidebar"></nav>
|
|
122
|
-
</div>
|
|
123
|
-
</div>
|
|
124
|
-
<script src="js/main.js"></script>
|
|
125
|
-
</body>
|
|
126
|
-
</html>
|
|
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>Troubleshooting — Clew</title>
|
|
7
|
+
<meta name="description" content="Common issues and solutions for Clew — provider keys, build errors, MCP, plugins, and runtime problems.">
|
|
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>Troubleshooting</span></div>
|
|
19
|
+
<h1>Troubleshooting</h1>
|
|
20
|
+
<p class="section-subtitle">Start with <code>/doctor</code> — it checks runtime version, provider credentials, config integrity, plugin/MCP status, and Sentry telemetry.</p>
|
|
21
|
+
|
|
22
|
+
<h2>Startup Issues</h2>
|
|
23
|
+
<h3>"command not found: clew"</h3>
|
|
24
|
+
<p>npm global install path may not be in <code>PATH</code>. Use <code>npx clew-code</code> or <code>bun x clew-code</code> as alternatives.</p>
|
|
25
|
+
|
|
26
|
+
<h3>"Bun not found"</h3>
|
|
27
|
+
<p>Clew requires <a href="https://bun.sh">Bun 1.3+</a> as the runtime for the npm package.</p>
|
|
28
|
+
|
|
29
|
+
<h2>Provider Issues</h2>
|
|
30
|
+
|
|
31
|
+
<h3>"No API key configured"</h3>
|
|
32
|
+
<p>Set at least one provider API key as an environment variable. See <a href="providers.html">Providers</a> for the full list.</p>
|
|
33
|
+
<pre><code>export ANTHROPIC_API_KEY=sk-ant-...
|
|
34
|
+
export DEEPSEEK_API_KEY=sk-...</code></pre>
|
|
35
|
+
<p>Run <code>/doctor</code> to verify configured providers.</p>
|
|
36
|
+
|
|
37
|
+
<h3>"Rate limited" or "Quota exceeded"</h3>
|
|
38
|
+
<p>Set a fallback model via CLI: <code>--fallback-model <model></code>. Or use <code>/model</code> to switch to a different provider. For rate limit options during a session, use <code>/rate-limit-options</code>.</p>
|
|
39
|
+
|
|
40
|
+
<h2>Build Issues</h2>
|
|
41
|
+
|
|
42
|
+
<h3>TypeScript errors during build</h3>
|
|
43
|
+
<pre><code>bun run build
|
|
44
|
+
# TypeScript errors may exist in uncommitted code or external modules.
|
|
45
|
+
# Run targeted checks:
|
|
46
|
+
bun x tsc --noEmit
|
|
47
|
+
bun test <targeted-path></code></pre>
|
|
48
|
+
|
|
49
|
+
<h3>Windows-specific issues</h3>
|
|
50
|
+
<ul>
|
|
51
|
+
<li>ripgrep is bundled at <code>src/utils/vendor/ripgrep/x64-win32/rg.exe</code></li>
|
|
52
|
+
<li>TTY polyfill may be needed for Ink compatibility</li>
|
|
53
|
+
<li>PowerShell and Bash may behave differently for tool execution</li>
|
|
54
|
+
<li>Windows argv normalization in <code>src/entry.ts</code></li>
|
|
55
|
+
</ul>
|
|
56
|
+
|
|
57
|
+
<h2>MCP Issues</h2>
|
|
58
|
+
|
|
59
|
+
<h3>"MCP server connection failed"</h3>
|
|
60
|
+
<p>Verify the server command exists and paths are correct. Check JSON config syntax with <code>/mcp</code> command.</p>
|
|
61
|
+
|
|
62
|
+
<h3>MCP tools not appearing</h3>
|
|
63
|
+
<p>Use <code>/mcp</code> to check server status. Tools are loaded at startup via <code>--mcp-config</code> or through <code>assembleToolPool()</code> during server connection. Verify the server implements <code>tools/list</code> correctly.</p>
|
|
64
|
+
|
|
65
|
+
<h2>Plugin Issues</h2>
|
|
66
|
+
|
|
67
|
+
<h3>Plugin not loading</h3>
|
|
68
|
+
<p>Check plugin manifest format and location. Use <code>/plugin</code> and <code>/reload-plugins</code> to refresh. For directory-based plugins, use <code>--plugin-dir <path></code>.</p>
|
|
69
|
+
|
|
70
|
+
<h2>Feature Flags</h2>
|
|
71
|
+
<p>Some features require compile-time or runtime flags:</p>
|
|
72
|
+
<table>
|
|
73
|
+
<tr><th>Feature</th><th>Required Flag</th></tr>
|
|
74
|
+
<tr><td>Bridge mode</td><td><code>BRIDGE_MODE=1</code></td></tr>
|
|
75
|
+
<tr><td>Voice mode</td><td><code>VOICE_MODE=1</code></td></tr>
|
|
76
|
+
<tr><td>LSP tool</td><td><code>ENABLE_LSP_TOOL=1</code></td></tr>
|
|
77
|
+
<tr><td>Computer Use</td><td><code>ENABLE_COMPUTER_USE=1</code> (Windows)</td></tr>
|
|
78
|
+
<tr><td>Proactive features</td><td><code>KAIROS=1</code></td></tr>
|
|
79
|
+
<tr><td>Agent triggers</td><td><code>AGENT_TRIGGERS=1</code></td></tr>
|
|
80
|
+
<tr><td>Code index</td><td><code>CODE_INDEX=1</code></td></tr>
|
|
81
|
+
</table>
|
|
82
|
+
|
|
83
|
+
<h2>Getting Help</h2>
|
|
84
|
+
<ul>
|
|
85
|
+
<li><strong>In-app diagnostics:</strong> <code>/doctor</code> — comprehensive environment check</li>
|
|
86
|
+
<li><strong>Status overview:</strong> <code>/status</code> — version, model, API connectivity, tool statuses</li>
|
|
87
|
+
<li><strong>GitHub Issues:</strong> Report bugs and feature requests</li>
|
|
88
|
+
<li><strong>Debug mode:</strong> Run with <code>DEBUG=1</code> or <code>DEBUG=provider:anthropic</code> for detailed logging</li>
|
|
89
|
+
</ul>
|
|
90
|
+
|
|
91
|
+
<footer class="footer">
|
|
92
|
+
<span>Clew Code v0.2.4 — Open Source</span>
|
|
93
|
+
<div class="footer-links">
|
|
94
|
+
<a href="https://github.com/JonusNattapong/ClewCode">GitHub</a>
|
|
95
|
+
<a href="https://github.com/JonusNattapong/ClewCode/issues">Issues</a>
|
|
96
|
+
<a href="https://npmjs.com/package/clew-code">npm</a>
|
|
97
|
+
</div>
|
|
98
|
+
</footer>
|
|
99
|
+
</main>
|
|
100
|
+
<nav class="toc-sidebar"></nav>
|
|
101
|
+
</div>
|
|
102
|
+
</div>
|
|
103
|
+
<script src="js/main.js"></script>
|
|
104
|
+
</body>
|
|
105
|
+
</html>
|
|
@@ -12,28 +12,7 @@
|
|
|
12
12
|
<link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
|
|
13
13
|
</head>
|
|
14
14
|
<body>
|
|
15
|
-
<header class="header"
|
|
16
|
-
<span>Clew Code</span>
|
|
17
|
-
</a><nav class="header-nav"><a href="index.th.html">หน้าแรก</a><a href="index.th.html#features">ฟีเจอร์</a><a href="index.th.html#commands">คำสั่ง</a><a href="quick-start.th.html" class="active">เอกสาร</a><a href="https://github.com/JonusNattapong/ClewCode" target="_blank">GitHub</a>
|
|
18
|
-
<div class="lang-wrap">
|
|
19
|
-
<button class="lang-btn">🌐</button>
|
|
20
|
-
<div class="lang-menu">
|
|
21
|
-
<a href="../readme/README.zh.md">中文</a>
|
|
22
|
-
<a href="../readme/README.th.md">ไทย</a>
|
|
23
|
-
<a href="../readme/README.ja.md">日本語</a>
|
|
24
|
-
<a href="../readme/README.ko.md">한국어</a>
|
|
25
|
-
<a href="../readme/README.es.md">Español</a>
|
|
26
|
-
<a href="../readme/README.fr.md">Français</a>
|
|
27
|
-
<a href="../readme/README.de.md">Deutsch</a>
|
|
28
|
-
<a href="../readme/README.pt.md">Português</a>
|
|
29
|
-
<a href="../readme/README.vi.md">Tiếng Việt</a>
|
|
30
|
-
<a href="../readme/README.id.md">Bahasa Indonesia</a>
|
|
31
|
-
<a href="../readme/README.ru.md">Русский</a>
|
|
32
|
-
<a href="../readme/README.hi.md">हिन्दी</a>
|
|
33
|
-
<a href="troubleshooting.html">English</a>
|
|
34
|
-
</div>
|
|
35
|
-
</div>
|
|
36
|
-
</nav><button class="menu-btn" id="menuToggle" aria-label="เปิด/ปิดเมนู"><span></span><span></span><span></span></button></div></header>
|
|
15
|
+
<header class="header"></header>
|
|
37
16
|
<div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
|
|
38
17
|
<div class="content-wrap"><main class="content">
|
|
39
18
|
<div class="breadcrumbs"><a href="index.th.html">หน้าแรก</a><span class="sep">/</span><span>การแก้ปัญหา</span></div>
|
|
@@ -89,7 +68,7 @@ bun test <targeted-path></code></pre>
|
|
|
89
68
|
</ul>
|
|
90
69
|
|
|
91
70
|
<footer class="footer">
|
|
92
|
-
<span>Clew v0.
|
|
71
|
+
<span>Clew Code v0.2.4 — โอเพนซอร์ส</span>
|
|
93
72
|
<div class="footer-links">
|
|
94
73
|
<a href="https://github.com/JonusNattapong/ClewCode">GitHub</a>
|
|
95
74
|
<a href="https://github.com/JonusNattapong/ClewCode/issues">ปัญหา</a>
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "clew-code",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.5",
|
|
4
4
|
"description": "ClewCode — multi-provider AI coding agent CLI",
|
|
5
5
|
"main": "./dist/main.js",
|
|
6
6
|
"type": "module",
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
},
|
|
25
25
|
"homepage": "https://github.com/ClewCode/ClewCode#readme",
|
|
26
26
|
"scripts": {
|
|
27
|
-
"dev": "bun
|
|
27
|
+
"dev": "bun --watch run --define.TRANSCRIPT_CLASSIFIER=true --define.CHICAGO_MCP=true --define.VOICE_MODE=true src/main.tsx",
|
|
28
28
|
"start": "bun run --define.VOICE_MODE=true src/main.tsx",
|
|
29
29
|
"dev:channels": "bun run --define.VOICE_MODE=true src/main.tsx -- --dangerously-load-development-channels server:clew-orc",
|
|
30
30
|
"build": "NODE_ENV=production bun build --production --define.TRANSCRIPT_CLASSIFIER=true --define.CHICAGO_MCP=true --define.VOICE_MODE=true src/main.tsx --outdir ./dist --target bun --external electron --external 'chromium-bidi*' --external '@ant/claude-for-chrome-mcp' --external '@anthropic-ai/bedrock-sdk' --external '@anthropic-ai/foundry-sdk' --external '@anthropic-ai/vertex-sdk' --external '@anthropic-ai/mcpb' --external '@aws-sdk/client-bedrock-runtime' --external 'google-auth-library' --external 'sharp' --external 'asciichart' --external 'audio-capture-napi' --external 'modifiers-napi' --external '@xenova/transformers' --external 'onnxruntime-node' --external playwright --external 'playwright-core'",
|