clew-code 0.2.21 → 0.2.22

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 (66) hide show
  1. package/dist/main.js +1861 -1856
  2. package/docs/architecture.html +91 -148
  3. package/docs/assets/clew-agent-loop.png +0 -0
  4. package/docs/assets/clew-general-architecture.png +0 -0
  5. package/docs/assets/clew-mcp-architecture.png +0 -0
  6. package/docs/assets/clew-p2p-swarm.png +0 -0
  7. package/docs/changelog.html +150 -0
  8. package/docs/cli-reference.html +90 -0
  9. package/docs/commands.html +156 -265
  10. package/docs/configuration.html +85 -147
  11. package/docs/contributing.html +91 -0
  12. package/docs/css/styles.css +425 -425
  13. package/docs/daemon.html +62 -129
  14. package/docs/features/bridge-mode.html +61 -66
  15. package/docs/features/evals.html +57 -149
  16. package/docs/features/searxng-search.html +58 -118
  17. package/docs/features/sentry-setup.html +61 -124
  18. package/docs/index.html +137 -125
  19. package/docs/installation.html +77 -105
  20. package/docs/internals/growthbook-ab-testing.html +69 -91
  21. package/docs/internals/hidden-features.html +81 -143
  22. package/docs/js/main.js +29 -0
  23. package/docs/loop.html +69 -181
  24. package/docs/mcp.html +99 -247
  25. package/docs/models.html +69 -110
  26. package/docs/permission-model.html +86 -102
  27. package/docs/plugins.html +84 -102
  28. package/docs/providers.html +87 -127
  29. package/docs/quick-start.html +81 -93
  30. package/docs/research-memory.html +71 -102
  31. package/docs/security.html +71 -0
  32. package/docs/skills.html +67 -117
  33. package/docs/swarm.html +78 -236
  34. package/docs/tools.html +152 -151
  35. package/docs/troubleshooting.html +86 -106
  36. package/docs/voice-mode.html +79 -0
  37. package/package.json +1 -1
  38. package/docs/architecture.th.html +0 -79
  39. package/docs/clew-code-architecture.html +0 -1126
  40. package/docs/commands.th.html +0 -269
  41. package/docs/configuration.th.html +0 -108
  42. package/docs/daemon.th.html +0 -73
  43. package/docs/features/bridge-mode.th.html +0 -62
  44. package/docs/features/evals.th.html +0 -62
  45. package/docs/features/searxng-search.th.html +0 -67
  46. package/docs/features/sentry-setup.th.html +0 -69
  47. package/docs/features/swarm.html +0 -156
  48. package/docs/generated/providers.html +0 -625
  49. package/docs/generated/tools.html +0 -558
  50. package/docs/index.th.html +0 -292
  51. package/docs/installation.th.html +0 -105
  52. package/docs/internals/growthbook-ab-testing.th.html +0 -60
  53. package/docs/internals/hidden-features.th.html +0 -107
  54. package/docs/loop.th.html +0 -227
  55. package/docs/mcp.th.html +0 -207
  56. package/docs/models.th.html +0 -61
  57. package/docs/permission-model.th.html +0 -67
  58. package/docs/plugins.th.html +0 -79
  59. package/docs/prompts-and-features.html +0 -806
  60. package/docs/providers.th.html +0 -81
  61. package/docs/quick-start.th.html +0 -89
  62. package/docs/research-memory.th.html +0 -72
  63. package/docs/skills.th.html +0 -90
  64. package/docs/swarm.th.html +0 -280
  65. package/docs/tools.th.html +0 -84
  66. package/docs/troubleshooting.th.html +0 -85
package/docs/index.html CHANGED
@@ -3,146 +3,158 @@
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Clew — AI Coding Assistant</title>
7
- <meta name="description" content="Terminal-based AI coding assistant with 29+ providers, P2P swarm, MCP support, and plugin system.">
6
+ <title>Clew Code Multi-Provider AI Coding Agent</title>
7
+ <meta name="description" content="The open-source AI coding agent with 27 providers, LAN mesh coordination, autonomous agent loop, MCP integration, and 50+ built-in tools.">
8
+ <link rel="icon" type="image/svg+xml" href="assets/clew.svg">
8
9
  <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&display=swap" rel="stylesheet">
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
11
  <link rel="stylesheet" href="css/styles.css">
12
- <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
13
12
  </head>
14
13
  <body>
14
+ <header class="header"></header>
15
+ <div id="sidebarOverlay" class="sidebar-overlay"></div>
16
+ <aside id="sidebar" class="sidebar"></aside>
15
17
 
16
- <div class="header">
17
- <div class="header-inner">
18
- <a href="index.html" class="logo"><span class="logo-mark">C</span>Clew</a>
19
- <nav class="header-nav">
20
- <a href="quick-start.html">Guide</a>
21
- <a href="commands.html">Commands</a>
22
- <a href="providers.html">Providers</a>
23
- <a href="tools.html">Tools</a>
24
- <a href="https://github.com/ClewCode/ClewCode" target="_blank">GitHub</a>
25
- </nav>
26
- <button class="menu-btn" id="menuToggle"><span></span><span></span><span></span></button>
18
+ <div class="content-wrap">
19
+ <div class="content">
20
+
21
+ <section class="hero">
22
+ <div class="badge"><span class="dot"></span> v0.2.21 — Multi-Provider AI Coding Agent</div>
23
+ <h1>Code with <span class="hl">any</span> AI.</h1>
24
+ <p>Clew Code is an open-source AI coding agent that runs in your terminal,
25
+ coordinates across machines on your LAN, and works with 27 different
26
+ AI providers — no lock-in.</p>
27
+ <div class="hero-actions">
28
+ <a href="quick-start.html" class="btn btn-p">Get Started →</a>
29
+ <a href="installation.html" class="btn btn-ghost">Installation</a>
30
+ <a href="https://github.com/ClewCode/ClewCode" class="btn btn-ghost" target="_blank">GitHub</a>
27
31
  </div>
28
- </div>
32
+ </section>
29
33
 
30
- <div class="page">
34
+ <div class="term">
35
+ <div class="term-bar">
36
+ <span class="term-dot"></span><span class="term-dot"></span><span class="term-dot"></span>
37
+ <span class="term-title">clew</span>
38
+ </div>
39
+ <div class="term-body"><span class="p">❯</span> clew
40
+ <span class="d">│ Starting Clew Code v0.2.21 …</span>
41
+ <span class="d">│ Select a provider:</span>
42
+ <span class="h">│ ● Anthropic</span>
43
+ <span class="h">│ ● OpenAI</span>
44
+ ○ Google Gemini
45
+ ○ DeepSeek
46
+ ○ Ollama (local)
47
+
48
+ <span class="p">❯</span> /model deepseek-v4-flash
31
49
 
32
- <section class="hero">
33
- <div class="badge"><span class="dot"></span>0.2.14 Multi-Provider AI CLI</div>
34
- <h1>Code with <span class="hl">any model</span></h1>
35
- <p>Terminal-based AI coding assistant with multi-provider routing, P2P swarm, and extensible tool system.</p>
36
- <div class="hero-actions">
37
- <a href="https://npmjs.com/package/clew-code" class="btn btn-p">npm install -g clew-code</a>
38
- <a href="quick-start.html" class="btn btn-ghost">Get Started →</a>
39
- <a href="https://github.com/ClewCode/ClewCode" class="btn btn-ghost" target="_blank">GitHub</a>
40
- </div>
41
- </section>
50
+ <span class="p">❯</span> /mesh discover
51
+ <span class="d">│ Found 2 peers on LAN</span>
42
52
 
43
- <div class="stats">
44
- <div class="stat"><div class="stat-num">29</div><div class="stat-lbl">AI Providers</div></div>
45
- <div class="stat"><div class="stat-num">120+</div><div class="stat-lbl">Commands</div></div>
46
- <div class="stat"><div class="stat-num">76+</div><div class="stat-lbl">Built-in Tools</div></div>
47
- <div class="stat"><div class="stat-num">100%</div><div class="stat-lbl">Open Source</div></div>
48
- </div>
53
+ <span class="p">❯</span> write a web scraper in Go</div>
54
+ </div>
49
55
 
50
- <h2>Features</h2>
51
- <div class="grid">
52
- <div class="card">
53
- <h3>Multi-Provider AI</h3>
54
- <p>29 providers Anthropic, OpenAI, Google, DeepSeek, Groq, Mistral, and more. Switch at runtime with <code>/model</code>.</p>
55
- <span class="tag">/model</span> <span class="tag">/provider</span>
56
- </div>
57
- <div class="card">
58
- <h3>P2P Swarm &amp; Mesh</h3>
59
- <p>LAN-based multi-agent coordination. Discover peers, share workers, assign tasks across machines. Mesh networking with remote control.</p>
60
- <span class="tag">/swarm</span> <span class="tag">/mesh</span>
61
- </div>
62
- <div class="card">
63
- <h3>MCP &amp; Plugins</h3>
64
- <p>Full MCP support (stdio + SSE + DirectConnect), hot-reloadable plugins with hooks, and a plugin marketplace.</p>
65
- <span class="tag">/mcp</span> <span class="tag">/plugin</span>
66
- </div>
67
- <div class="card">
68
- <h3>76+ Built-in Tools</h3>
69
- <p>File ops, shell, web search, browser automation, agent delegation, git/PR workflows, process mesh — permission-gated.</p>
70
- <span class="tag">Read/Write/Edit</span> <span class="tag">Bash</span>
71
- </div>
72
- <div class="card">
73
- <h3>Memory &amp; Research</h3>
74
- <p>Auto-memory with semantic search. Deep research across files, wiki, and web. XP system with knowledge graph.</p>
75
- <span class="tag">/memory</span> <span class="tag">/research</span>
76
- </div>
77
- <div class="card">
78
- <h3>Voice &amp; Automation</h3>
79
- <p>Voice mode with Whisper, 24/7 daemon agent, scheduled tasks, recurring loops, and bridge for remote control.</p>
80
- <span class="tag">/voice</span> <span class="tag">/daemon</span>
81
- </div>
82
- <div class="card">
83
- <h3>Ultracode &amp; Reasoning</h3>
84
- <p>Ultracode mode with xhigh effort, parallel subtasks, and adversarial verifiers. Configurable reasoning effort per provider.</p>
85
- <span class="tag">/ultracode</span> <span class="tag">/effort</span>
86
- </div>
87
- <div class="card">
88
- <h3>OAuth &amp; Permissions</h3>
89
- <p>Granular permissions with allow/deny rules, 7 permission modes, sandbox mode. OAuth for Anthropic, Google, OpenAI.</p>
90
- <span class="tag">/permissions</span> <span class="tag">/login</span>
91
- </div>
92
- <div class="card">
93
- <h3>Plan, Review &amp; PR</h3>
94
- <p>Plan mode for complex tasks. AI code review with auto-fix. Full GitHub PR lifecycle — create, review, merge, comment.</p>
95
- <span class="tag">/plan</span> <span class="tag">/review</span>
96
- </div>
97
- <div class="card">
98
- <h3>Process Mesh &amp; Agents</h3>
99
- <p>Distributed process-backed workers with PTY/exec modes. Subagents, background tasks, and multi-agent coordination.</p>
100
- <span class="tag">/agent</span> <span class="tag">ProcessMesh</span>
101
- </div>
102
- <div class="card">
103
- <h3>Taste &amp; Preference Learning</h3>
104
- <p>Adaptive preference learning engine — learns your coding style, tool preferences, and workflow patterns over time.</p>
105
- <span class="tag">/taste</span> <span class="tag">/buddy</span>
106
- </div>
107
- <div class="card">
108
- <h3>Skills &amp; Workflows</h3>
109
- <p>Reusable skill instructions, dynamic workflows in YAML/JSON, SearXNG local search, and multi-source research.</p>
110
- <span class="tag">/skill</span> <span class="tag">/workflow</span>
111
- </div>
112
- </div>
56
+ <div class="stats">
57
+ <div class="stat"><div class="stat-num">27</div><div class="stat-lbl">Providers</div></div>
58
+ <div class="stat"><div class="stat-num">50+</div><div class="stat-lbl">Built-in Tools</div></div>
59
+ <div class="stat"><div class="stat-num">15</div><div class="stat-lbl">Mesh Tools</div></div>
60
+ <div class="stat"><div class="stat-num">7</div><div class="stat-lbl">Permission Modes</div></div>
61
+ </div>
113
62
 
114
- <h2>Why Clew?</h2>
115
- <div class="grid">
116
- <div class="card">
117
- <h3>Provider Freedom</h3>
118
- <p>Use any AI provider switch between them mid-session. No vendor lock-in. Consistent tool calling across all providers.</p>
119
- </div>
120
- <div class="card">
121
- <h3>Team-Ready</h3>
122
- <p>P2P swarm lets instances collaborate over LAN. Broadcast tasks, orchestrate multi-agent workflows without a central server.</p>
123
- </div>
124
- <div class="card">
125
- <h3>Fully Extensible</h3>
126
- <p>Plugins with hot-reload, MCP servers, custom skills. Every part can be extended.</p>
127
- </div>
63
+ <h2 id="features">Features</h2>
64
+ <div class="grid">
65
+ <div class="card">
66
+ <h3>27 Providers</h3>
67
+ <p>Anthropic, OpenAI, Google Gemini, DeepSeek, Groq, Mistral, Ollama, OpenRouter, and 19 more. Switch mid-session with <code>/model</code>.</p>
68
+ </div>
69
+ <div class="card">
70
+ <h3>LAN Mesh</h3>
71
+ <p>Discover peers, assign tasks, execute remote commands, and coordinate across machines via UDP multicast or file registry.</p>
72
+ <span class="tag">15 tools</span>
73
+ </div>
74
+ <div class="card">
75
+ <h3>Autonomous Loop</h3>
76
+ <p>Persistent task queue, lease-based concurrency, exponential-backoff retry, dead-letter management, and cron scheduling.</p>
77
+ </div>
78
+ <div class="card">
79
+ <h3>MCP Integration</h3>
80
+ <p>Model Context Protocol via stdio, SSE with OAuth, or DirectConnect for in-process plugin servers.</p>
81
+ </div>
82
+ <div class="card">
83
+ <h3>50+ Built-in Tools</h3>
84
+ <p>Read, Write, Edit, Bash, WebSearch, WebFetch, Browser (Playwright), PR, NotebookEdit, JsonPath, and more.</p>
85
+ </div>
86
+ <div class="card">
87
+ <h3>3 Execution Layers</h3>
88
+ <p>Subagents (one-shot), Swarm/Teammates (long-running), Process Mesh (Codex via exec/pty).</p>
89
+ </div>
90
+ <div class="card">
91
+ <h3>Skills &amp; Plugins</h3>
92
+ <p>Extend via SKILL.md, plugin manifests with lifecycle hooks at every stage (PreToolUse, PostBash, and more).</p>
93
+ </div>
94
+ <div class="card">
95
+ <h3>7 Permission Modes</h3>
96
+ <p>Default, ask, plan, auto, acceptEdits, bypassPermissions, dontAsk — with granular allow/deny rule patterns.</p>
128
97
  </div>
98
+ <div class="card">
99
+ <h3>Plan Mode</h3>
100
+ <p>Full-access planning with bypass permissions. Explore, read, write, and edit freely. Plans persist with progress snapshots.</p>
101
+ </div>
102
+ <div class="card">
103
+ <h3>Memory System</h3>
104
+ <p>Persistent auto-memory, topic indexing, session digests with weekly/monthly consolidation — like human memory decay.</p>
105
+ </div>
106
+ <div class="card">
107
+ <h3>Web UI &amp; Remote</h3>
108
+ <p>Local WebSocket server with one-time auth tokens, optional NAT-traversal relay, and session management.</p>
109
+ </div>
110
+ <div class="card">
111
+ <h3>Multi-Pass Compaction</h3>
112
+ <p>Automatic chunk-based context compression with recursive re-compaction when context exceeds the model window.</p>
113
+ </div>
114
+ </div>
115
+
116
+ <h2 id="quick-start">Quick Start</h2>
117
+ <pre><code class="language-bash">npm install -g clew-code
118
+ cd my-project
119
+ clew
129
120
 
130
- <footer class="footer">
131
- <span>Clew Code Open Source</span>
132
- <div class="footer-links">
133
- <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
134
- <a href="https://npmjs.com/package/clew-code">npm</a>
135
- <a href="commands.html">Commands</a>
136
- <a href="prompts-and-features.html">Reference</a>
137
- </div>
138
- </footer>
121
+ # Inside the REPL:
122
+ # /model openai # pick a provider
123
+ # /help # list all commands
124
+ # /mesh discover # find peers on LAN
125
+ </code></pre>
139
126
 
127
+ <h2 id="concepts">Core Concepts</h2>
128
+ <p>Clew Code has several execution layers, each serving a different purpose:</p>
129
+ <div class="grid">
130
+ <div class="card">
131
+ <h3>Agent</h3>
132
+ <p>An AI worker with a prompt, model, tools, and permissions. The main chat session is an agent. Custom agents live in <code>.clew/agents/*.md</code>.</p>
133
+ </div>
134
+ <div class="card">
135
+ <h3>Subagent</h3>
136
+ <p>A short-lived child agent for independent work like codebase exploration or test triage. The built-in <code>Explore</code> agent is read-only.</p>
137
+ </div>
138
+ <div class="card">
139
+ <h3>Teammate / Swarm</h3>
140
+ <p>A longer-lived agent team member with identity, mailbox, task coordination, and optional pane/tmux execution.</p>
141
+ </div>
142
+ <div class="card">
143
+ <h3>LAN Mesh</h3>
144
+ <p>A network of Clew instances on the same machine or LAN. <code>/mesh</code> discovers peers, sends messages, and assigns tasks.</p>
145
+ </div>
146
+ <div class="card">
147
+ <h3>Process Mesh</h3>
148
+ <p>Local process-backed worker. Delegates prompts to external CLIs like Codex using exec or pty modes.</p>
149
+ </div>
150
+ <div class="card">
151
+ <h3>ACP</h3>
152
+ <p>Agent Client Protocol — an external boundary for editors, IDEs, REST clients, or other agents to send work into Clew.</p>
153
+ </div>
154
+ </div>
155
+ </div>
140
156
  </div>
141
157
 
142
- <script>
143
- document.getElementById('menuToggle')?.addEventListener('click',()=>{
144
- document.querySelector('.header-nav')?.classList.toggle('open');
145
- });
146
- </script>
158
+ <script src="js/main.js"></script>
147
159
  </body>
148
160
  </html>
@@ -1,105 +1,77 @@
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>Installation — Clew</title>
7
- <meta name="description" content="Install Clew via npm, run from source, or use the prebuilt binary.">
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>Installation</span></div>
19
- <h1>Installation</h1>
20
- <p class="section-subtitle">Clew runs on Windows, macOS, Linux, and WSL2. Runtime: Bun 1.3+.</p>
21
-
22
- <h2>Prerequisites</h2>
23
- <ul>
24
- <li><strong>Bun 1.3+</strong> — required runtime for both global installs and source builds</li>
25
- <li>At least one AI provider API key</li>
26
- </ul>
27
-
28
- <h2>Via npm (global)</h2>
29
- <pre><code>npm install -g clew-code
30
- clew
31
-
32
- # Verify
33
- clew --version</code></pre>
34
- <p><strong>Important:</strong> the npm package installs the launcher only. You must install <a href="https://bun.sh">Bun</a> separately before running <code>clew</code>.</p>
35
-
36
- <h2>Via Bun (global)</h2>
37
- <pre><code>bun install -g clew-code
38
- clew</code></pre>
39
-
40
- <h2>From Source</h2>
41
- <pre><code>git clone https://github.com/ClewCode/ClewCode.git
42
- cd ClewCode
43
- bun install
44
- bun run build
45
- bun run start
46
-
47
- # Development mode with watch
48
- bun run dev</code></pre>
49
-
50
- <p>Build output goes to <code>dist/</code>. The build uses Bun bundler with compile-time feature defines (<code>TRANSCRIPT_CLASSIFIER</code>, <code>CHICAGO_MCP</code>).</p>
51
-
52
- <h2>Platform-Specific Notes</h2>
53
-
54
- <h3>Windows</h3>
55
- <ul>
56
- <li>Both cmd and PowerShell supported as shell targets</li>
57
- <li>ripgrep bundled at <code>src/utils/vendor/ripgrep/x64-win32/rg.exe</code></li>
58
- <li>WSL2 recommended for best experience</li>
59
- <li>Windows argv normalization in <code>src/entry.ts</code></li>
60
- <li>TTY polyfill for Ink compatibility in <code>src/main.tsx</code></li>
61
- </ul>
62
-
63
- <h3>macOS</h3>
64
- <ul>
65
- <li>CLI-based usage with (clew)</li>
66
- <li>Voice Wake and Talk Mode overlays</li>
67
- <li>Keychain prefetch for faster OAuth startup</li>
68
- <li>WebChat and debug tools available</li>
69
- </ul>
70
-
71
- <h3>Linux</h3>
72
- <ul>
73
- <li>Full support via terminal</li>
74
- <li>Tailscale Serve/Funnel for remote gateway access</li>
75
- </ul>
76
-
77
- <h2>Release Channels</h2>
78
- <table>
79
- <tr><th>Channel</th><th>npm Tag</th><th>Description</th></tr>
80
- <tr><td>stable</td><td><code>latest</code></td><td>Tagged releases (vYYYY.M.D)</td></tr>
81
- <tr><td>beta</td><td><code>beta</code></td><td>Prereleases (vYYYY.M.D-beta.N)</td></tr>
82
- <tr><td>dev</td><td><code>dev</code></td><td>Moving main branch</td></tr>
83
- </table>
84
-
85
- <h2>Verifying Installation</h2>
86
- <pre><code>/doctor # Run environment diagnostics
87
- /status # Check version, model, account, API connectivity</code></pre>
88
-
89
- <footer class="footer">
90
- <span>Clew Code 0.2.14 — Open Source</span>
91
- <div class="footer-links">
92
- <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
93
- <a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
94
- <a href="https://npmjs.com/package/clew-code">npm</a>
95
- </div>
96
- </footer>
97
- </main>
98
- <nav class="toc-sidebar"></nav>
99
- </div>
100
- </div>
101
- <script src="js/main.js"></script>
102
- </body>
103
- </html>
104
-
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>Installation — Clew Code</title>
7
+ <meta name="description" content="Install Clew Code via npm or build from source.">
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">Installation</span></div>
22
+
23
+ <h1>Installation</h1>
24
+
25
+ <h2 id="npm">Install via npm</h2>
26
+ <pre><code class="language-bash">npm install -g clew-code
27
+
28
+ # Verify installation
29
+ clew --version
30
+ </code></pre>
31
+
32
+ <h2 id="build">Build from Source</h2>
33
+ <pre><code class="language-bash">git clone https://github.com/ClewCode/ClewCode.git
34
+ cd ClewCode
35
+ bun install
36
+ bun run build
37
+ bun run start
38
+ </code></pre>
39
+
40
+ <h2 id="requirements">Requirements</h2>
41
+ <table>
42
+ <thead>
43
+ <tr><th>Dependency</th><th>Minimum Version</th></tr>
44
+ </thead>
45
+ <tbody>
46
+ <tr><td>Bun</td><td>1.3+</td></tr>
47
+ <tr><td>Node.js</td><td>18+</td></tr>
48
+ <tr><td>Git</td><td>Any modern version</td></tr>
49
+ <tr><td>Provider API key</td><td>At least one (see <a href="providers.html">providers</a>)</td></tr>
50
+ </tbody>
51
+ </table>
52
+
53
+ <h2 id="platform">Platform Notes</h2>
54
+
55
+ <h3>macOS</h3>
56
+ <p>Works out of the box on both Apple Silicon and Intel Macs.</p>
57
+
58
+ <h3>Linux</h3>
59
+ <p>No special dependencies required.</p>
60
+
61
+ <h3>Windows</h3>
62
+ <p>Requires Git Bash, WSL, or PowerShell. Some features (e.g., ComputerUse) are Windows-only.</p>
63
+ <pre><code class="language-powershell">Remove-Item -Recurse -Force node_modules
64
+ bun install
65
+ bun run dev
66
+ </code></pre>
67
+
68
+ <h2 id="verify">Verify Installation</h2>
69
+ <pre><code class="language-bash">clew --version
70
+ # Should print v0.2.21 or later
71
+ </code></pre>
72
+ </div>
73
+ </div>
74
+
75
+ <script src="js/main.js"></script>
76
+ </body>
77
+ </html>