clew-code 0.3.2 → 0.3.3

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 (47) hide show
  1. package/README.md +181 -113
  2. package/dist/generated/version.json +1 -1
  3. package/dist/main.js +2948 -3258
  4. package/package.json +1 -1
  5. package/docs/.nojekyll +0 -0
  6. package/docs/_config.yml +0 -3
  7. package/docs/architecture.html +0 -90
  8. package/docs/assets/clew-agent-loop.png +0 -0
  9. package/docs/assets/clew-general-architecture.png +0 -0
  10. package/docs/assets/clew-mcp-architecture.png +0 -0
  11. package/docs/assets/clew-p2p-swarm.png +0 -0
  12. package/docs/assets/clew.svg +0 -33
  13. package/docs/changelog.html +0 -141
  14. package/docs/cli-reference.html +0 -89
  15. package/docs/commands.html +0 -161
  16. package/docs/configuration.html +0 -85
  17. package/docs/contributing.html +0 -91
  18. package/docs/css/styles.css +0 -545
  19. package/docs/daemon.html +0 -62
  20. package/docs/features/bridge-mode.html +0 -62
  21. package/docs/features/evals.html +0 -58
  22. package/docs/features/searxng-search.html +0 -59
  23. package/docs/features/sentry-setup.html +0 -62
  24. package/docs/generated/providers.html +0 -625
  25. package/docs/generated/tools.html +0 -559
  26. package/docs/index.html +0 -182
  27. package/docs/installation.html +0 -77
  28. package/docs/internals/claude-ai-backend-dependencies.md +0 -278
  29. package/docs/internals/growthbook-ab-testing.html +0 -70
  30. package/docs/internals/hidden-features.html +0 -82
  31. package/docs/internals/long-term-memory-design.md +0 -173
  32. package/docs/js/main.js +0 -438
  33. package/docs/loop.html +0 -69
  34. package/docs/mcp.html +0 -99
  35. package/docs/models.html +0 -81
  36. package/docs/permission-model.html +0 -86
  37. package/docs/personal-profile.html +0 -113
  38. package/docs/plugins.html +0 -84
  39. package/docs/providers.html +0 -625
  40. package/docs/quick-start.html +0 -81
  41. package/docs/research-memory.html +0 -71
  42. package/docs/security.html +0 -71
  43. package/docs/skills.html +0 -67
  44. package/docs/swarm.html +0 -78
  45. package/docs/tools.html +0 -559
  46. package/docs/troubleshooting.html +0 -86
  47. package/docs/voice-mode.html +0 -79
package/docs/features/bridge-mode.html DELETED
@@ -1,62 +0,0 @@
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>Bridge Mode — Clew Code</title>
7
- <meta name="description" content="Remote control and bridge mode for Clew Code.">
8
- <link rel="icon" type="image/svg+xml" href="../assets/clew.svg">
9
- <link rel="preconnect" href="https://fonts.googleapis.com">
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
- </head>
13
- <body>
14
- <header class="header"></header>
15
- <div id="sidebarOverlay" class="sidebar-overlay"></div>
16
- <aside id="sidebar" class="sidebar"></aside>
17
-
18
- <div class="content-wrap">
19
- <div class="content">
20
-
21
- <div class="breadcrumbs"><a href="../index.html">Home</a><span class="sep">/</span><span class="current">Bridge Mode</span></div>
22
-
23
- <h1>Bridge Mode</h1>
24
- <p class="sub">Remote control Clew Code from anywhere via WebSocket bridge.</p>
25
-
26
- <h2 id="overview">Overview</h2>
27
- <p>Bridge mode allows you to connect to a running Clew Code instance remotely. There are two systems:</p>
28
- <ul>
29
- <li><strong>Bridge v1 (Legacy CCR)</strong> — The original Claude Code Remote system, tied to claude.ai OAuth</li>
30
- <li><strong>Bridge v2 (Provider-Agnostic)</strong> — A standalone WebSocket server that works without claude.ai</li>
31
- </ul>
32
-
33
- <h2 id="v2">Bridge v2 — Provider-Agnostic Remote Control</h2>
34
- <p>The new bridge v2 runs a local WebSocket server with:</p>
35
- <ul>
36
- <li>One-time auth tokens (SHA-256 hashed)</li>
37
- <li>Session management</li>
38
- <li>Optional NAT-traversal relay</li>
39
- <li>No dependency on any provider's backend</li>
40
- </ul>
41
-
42
- <h3>Commands</h3>
43
- <pre><code class="language-bash">❯ /remote listen # start the WebSocket server
44
- ❯ /remote connect &lt;url&gt; # connect to a remote instance
45
- ❯ /remote token # generate a one-time auth token
46
- </code></pre>
47
-
48
- <h2 id="relay">Relay Mode</h2>
49
- <p>For NAT traversal, use the optional relay server:</p>
50
- <pre><code class="language-bash">bun run relay # start the relay server
51
- </code></pre>
52
-
53
- <h2 id="bridge-commands">Bridge v1 Commands</h2>
54
- <pre><code class="language-bash">❯ /bridge # configure bridge mode
55
- </code></pre>
56
- <p>Note: Bridge v1 requires a claude.ai subscription.</p>
57
- </div>
58
- </div>
59
-
60
- <script src="../js/main.js"></script>
61
- </body>
62
- </html>
package/docs/features/evals.html DELETED
@@ -1,58 +0,0 @@
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>Evaluation Harness — Clew Code</title>
7
- <meta name="description" content="Built-in evaluation harness for testing provider and model performance.">
8
- <link rel="icon" type="image/svg+xml" href="../assets/clew.svg">
9
- <link rel="preconnect" href="https://fonts.googleapis.com">
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
- </head>
13
- <body>
14
- <header class="header"></header>
15
- <div id="sidebarOverlay" class="sidebar-overlay"></div>
16
- <aside id="sidebar" class="sidebar"></aside>
17
-
18
- <div class="content-wrap">
19
- <div class="content">
20
-
21
- <div class="breadcrumbs"><a href="../index.html">Home</a><span class="sep">/</span><span class="current">Evaluation Harness</span></div>
22
-
23
- <h1>Evaluation Harness</h1>
24
- <p class="sub">Test and compare provider and model performance with the built-in eval system.</p>
25
-
26
- <h2 id="overview">Overview</h2>
27
- <p>The evaluation harness allows you to run standardized benchmarks against any configured provider/model combination. Use it to compare performance, measure latency, and validate outputs across providers.</p>
28
-
29
- <h2 id="usage">Usage</h2>
30
- <pre><code class="language-bash">❯ /evals run # run the standard eval suite
31
- ❯ /evals list # list available eval benchmarks
32
- ❯ /evals results # show previous eval results
33
- </code></pre>
34
-
35
- <h2 id="benchmarks">Available Benchmarks</h2>
36
- <ul>
37
- <li><strong>Code generation</strong> — function-level code synthesis</li>
38
- <li><strong>Tool calling</strong> — accuracy of tool selection and argument generation</li>
39
- <li><strong>Reasoning</strong> — multi-step logical reasoning</li>
40
- <li><strong>Context comprehension</strong> — long-context understanding and recall</li>
41
- </ul>
42
-
43
- <h2 id="comparing">Comparing Providers</h2>
44
- <p>Switch providers and re-run the same eval to compare:</p>
45
- <pre><code class="language-bash">❯ /model openai
46
- ❯ /evals run
47
-
48
- ❯ /model deepseek-v4-flash
49
- ❯ /evals run
50
-
51
- ❯ /evals results # side-by-side comparison
52
- </code></pre>
53
- </div>
54
- </div>
55
-
56
- <script src="../js/main.js"></script>
57
- </body>
58
- </html>
package/docs/features/searxng-search.html DELETED
@@ -1,59 +0,0 @@
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>SearXNG Search — Clew Code</title>
7
- <meta name="description" content="Private, self-hosted web search via SearXNG integration.">
8
- <link rel="icon" type="image/svg+xml" href="../assets/clew.svg">
9
- <link rel="preconnect" href="https://fonts.googleapis.com">
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
- </head>
13
- <body>
14
- <header class="header"></header>
15
- <div id="sidebarOverlay" class="sidebar-overlay"></div>
16
- <aside id="sidebar" class="sidebar"></aside>
17
-
18
- <div class="content-wrap">
19
- <div class="content">
20
-
21
- <div class="breadcrumbs"><a href="../index.html">Home</a><span class="sep">/</span><span class="current">SearXNG Search</span></div>
22
-
23
- <h1>SearXNG Search</h1>
24
- <p class="sub">Private, self-hosted web search integration using SearXNG.</p>
25
-
26
- <h2 id="overview">Overview</h2>
27
- <p>Clew Code integrates with <a href="https://docs.searxng.org/">SearXNG</a>, a privacy-respecting, self-hosted metasearch engine. This gives the AI access to web search results without relying on third-party search APIs.</p>
28
-
29
- <h2 id="setup">Setup</h2>
30
- <ol>
31
- <li>Deploy SearXNG (Docker is recommended):<pre><code class="language-bash">docker run --name searxng -d -p 8888:8080 \
32
- -e BASE_URL=http://localhost:8888/ \
33
- searxng/searxng</code></pre></li>
34
- <li>Configure SearXNG to enable JSON API:<pre><code class="language-yaml"># /etc/searxng/settings.yml
35
- search:
36
- formats:
37
- - html
38
- - json</code></pre></li>
39
- <li>Set the SearXNG URL in Clew Code:<pre><code class="language-bash">export SEARXNG_URL=http://localhost:8888</code></pre></li>
40
- </ol>
41
-
42
- <h2 id="using">Using SearXNG</h2>
43
- <pre><code class="language-bash">❯ /searxng search "your query here"
44
- </code></pre>
45
- <p>The search results are automatically available to the AI as context.</p>
46
-
47
- <h2 id="benefits">Benefits</h2>
48
- <ul>
49
- <li>Complete privacy — no search data sent to third parties</li>
50
- <li>Aggregates results from multiple engines (Google, Bing, DuckDuckGo, etc.)</li>
51
- <li>Self-hosted and fully可控</li>
52
- <li>Works offline or on air-gapped networks</li>
53
- </ul>
54
- </div>
55
- </div>
56
-
57
- <script src="../js/main.js"></script>
58
- </body>
59
- </html>
package/docs/features/sentry-setup.html DELETED
@@ -1,62 +0,0 @@
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>Sentry Setup — Clew Code</title>
7
- <meta name="description" content="Error tracking and performance monitoring with Sentry.">
8
- <link rel="icon" type="image/svg+xml" href="../assets/clew.svg">
9
- <link rel="preconnect" href="https://fonts.googleapis.com">
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
- </head>
13
- <body>
14
- <header class="header"></header>
15
- <div id="sidebarOverlay" class="sidebar-overlay"></div>
16
- <aside id="sidebar" class="sidebar"></aside>
17
-
18
- <div class="content-wrap">
19
- <div class="content">
20
-
21
- <div class="breadcrumbs"><a href="../index.html">Home</a><span class="sep">/</span><span class="current">Sentry Setup</span></div>
22
-
23
- <h1>Sentry Setup</h1>
24
- <p class="sub">Error tracking and performance monitoring via Sentry integration.</p>
25
-
26
- <h2 id="overview">Overview</h2>
27
- <p>Clew Code integrates with <a href="https://sentry.io/">Sentry</a> for error tracking, crash reporting, and performance monitoring. This helps developers identify and fix issues in production deployments.</p>
28
-
29
- <h2 id="configuration">Configuration</h2>
30
- <p>Set your Sentry DSN as an environment variable:</p>
31
- <pre><code class="language-bash">export SENTRY_DSN=https://your-dsn@sentry.io/your-project
32
- </code></pre>
33
-
34
- <p>Or configure it in <code>.clew/settings.json</code>:</p>
35
- <pre><code class="language-json">{
36
- "sentry": {
37
- "dsn": "https://your-dsn@sentry.io/your-project",
38
- "environment": "production",
39
- "tracesSampleRate": 0.1
40
- }
41
- }
42
- </code></pre>
43
-
44
- <h2 id="features">What's Tracked</h2>
45
- <ul>
46
- <li>Unhandled exceptions and promise rejections</li>
47
- <li>Provider API errors with contextual information</li>
48
- <li>Tool execution failures</li>
49
- <li>Session-level performance traces</li>
50
- <li>MCP server connection errors</li>
51
- </ul>
52
-
53
- <h2 id="verify">Verifying Setup</h2>
54
- <p>Run the doctor command to verify Sentry is connected:</p>
55
- <pre><code class="language-bash">❯ /doctor
56
- </code></pre>
57
- </div>
58
- </div>
59
-
60
- <script src="../js/main.js"></script>
61
- </body>
62
- </html>