clew-code 0.2.13 → 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
package/docs/features/peer.html CHANGED
@@ -1,178 +1,178 @@
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>Peer-to-Peer — LAN Collaboration — Clew</title>
7
- <meta name="description" content="LAN peer discovery, task delegation, and autonomous AI peer coordination in Clew.">
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
- <div class="header-inner">
17
- <a href="../index.html" class="logo">
18
- <span>Clew Code</span>
19
- </a>
20
- <nav class="header-nav">
21
- <a href="../index.html">Home</a>
22
- <a href="../index.html#features">Features</a>
23
- <a href="../index.html#commands">Commands</a>
24
- <a href="../quick-start.html" class="active">Docs</a>
25
- <a href="https://github.com/ClewCode/ClewCode" target="_blank">GitHub</a>
26
- <div class="lang-wrap">
27
- <button class="lang-btn">🌐</button>
28
- <div class="lang-menu">
29
- <a href="../../readme/README.th.md">ไทย</a>
30
- <a href="../../README.md">English</a>
31
- </div>
32
- </div>
33
- </nav>
34
- <button class="menu-btn" id="menuToggle" aria-label="Toggle navigation">
35
- <span></span><span></span><span></span>
36
- </button>
37
- </div>
38
- </header>
39
-
40
- <div class="app">
41
- <aside class="sidebar" id="sidebar"></aside>
42
- <div class="sidebar-overlay" id="sidebarOverlay"></div>
43
- <div class="content-wrap">
44
- <main class="content">
45
-
46
- <div class="breadcrumbs">
47
- <a href="../index.html">Home</a>
48
- <span>›</span>
49
- <span>Peer-to-Peer</span>
50
- </div>
51
-
52
- <h1>Peer-to-Peer Collaboration</h1>
53
- <p>
54
- Clew supports LAN peer discovery and task delegation, enabling a lead-worker model
55
- where one instance can coordinate multiple worker instances on the same network.
56
- </p>
57
-
58
- <h2>Architecture</h2>
59
- <p>
60
- Each peer runs a lightweight HTTP server (PeerServer) on a random port.
61
- Discovery uses UDP multicast broadcast (239.255.37.37:42069) plus a file-based
62
- registry (<code>~/.claude/peers/</code>) for same-machine peers.
63
- </p>
64
-
65
- <pre><code>Peer A (Lead) Peer B (Worker)
66
- | |
67
- |--- UDP multicast query ------->|
68
- |<--- response (host, port, cwd)-|
69
- | |
70
- |--- HTTP POST /peer-todo ------>| Assign task
71
- |--- HTTP POST /peer-exec ------>| Run command
72
- |<--- response ------------------| Return result</code></pre>
73
-
74
- <h2>Getting Started</h2>
75
-
76
- <h3>Worker Setup</h3>
77
- <pre><code># Start sharing (advertise on LAN)
78
- /peer share
79
-
80
- # Set display name and role
81
- /peer name Build Server
82
- /peer role builder</code></pre>
83
-
84
- <h3>Lead Setup</h3>
85
- <pre><code># Discover available peers
86
- /peer discover
87
-
88
- # Join a specific peer by port
89
- /peer join 127.0.0.1:59421
90
-
91
- # View connected peers
92
- /peer list</code></pre>
93
-
94
- <h3>Assign Tasks</h3>
95
- <pre><code># Direct task assignment
96
- /peer todo Build-Server "run the test suite"
97
-
98
- # Let the AI handle it
99
- > Assign a task to the build server to run all tests</code></pre>
100
-
101
- <h2>Commands</h2>
102
- <table>
103
- <thead>
104
- <tr><th>Command</th><th>Description</th></tr>
105
- </thead>
106
- <tbody>
107
- <tr><td><code>/peer</code></td><td>Open interactive peer menu</td></tr>
108
- <tr><td><code>/peer share</code></td><td>Start advertising as a worker</td></tr>
109
- <tr><td><code>/peer share stop</code></td><td>Stop advertising</td></tr>
110
- <tr><td><code>/peer discover</code></td><td>Scan LAN for peers (5s timeout)</td></tr>
111
- <tr><td><code>/peer join &lt;port&gt;</code></td><td>Connect to a peer by port or host:port</td></tr>
112
- <tr><td><code>/peer list</code></td><td>Open interactive peer list</td></tr>
113
- <tr><td><code>/peer todo &lt;peer&gt; &lt;task&gt;</code></td><td>Assign a task to a worker</td></tr>
114
- <tr><td><code>/peer todos</code></td><td>View received tasks</td></tr>
115
- <tr><td><code>/peer todo done &lt;id&gt;</code></td><td>Mark task as complete</td></tr>
116
- <tr><td><code>/peer name &lt;name&gt;</code></td><td>Set your display name</td></tr>
117
- <tr><td><code>/peer role &lt;role&gt;</code></td><td>Set your role (e.g., builder, tester)</td></tr>
118
- <tr><td><code>/peer inbox</code></td><td>View pending messages</td></tr>
119
- <tr><td><code>/peer spawn [options]</code></td><td>Spawn a new peer shell terminal</td></tr>
120
- <tr><td><code>/peer help</code></td><td>Show help</td></tr>
121
- </tbody>
122
- </table>
123
-
124
- <h2>AI Peer Tools</h2>
125
- <p>
126
- Clew AI can autonomously coordinate peers using these tools:
127
- </p>
128
- <table>
129
- <thead>
130
- <tr><th>Tool</th><th>Description</th></tr>
131
- </thead>
132
- <tbody>
133
- <tr><td><code>peer_discover</code></td><td>Scan for workers on LAN and same machine</td></tr>
134
- <tr><td><code>peer_join</code></td><td>Connect to a remote peer by host:port</td></tr>
135
- <tr><td><code>peer_send_task</code></td><td>Assign a task to a worker via HTTP POST</td></tr>
136
- <tr><td><code>peer_list_tasks</code></td><td>Check pending and completed tasks</td></tr>
137
- <tr><td><code>peer_list_roles</code></td><td>List all peers with names, roles, and IPs</td></tr>
138
- <tr><td><code>peer_run</code></td><td>Execute a shell command on a remote worker</td></tr>
139
- <tr><td><code>peer_share</code></td><td>Start or stop advertising as a worker</td></tr>
140
- <tr><td><code>peer_info</code></td><td>Get detailed info about a specific peer</td></tr>
141
- <tr><td><code>peer_set_name</code></td><td>Set display name for a peer</td></tr>
142
- <tr><td><code>peer_set_role</code></td><td>Set role for a peer</td></tr>
143
- </tbody>
144
- </table>
145
-
146
- <h2>Protocol</h2>
147
- <p>Discovery uses UDP multicast on <code>239.255.37.37:42069</code>. Peer info is broadcast every 30 seconds. Peers are evicted after 90 seconds of inactivity.</p>
148
- <p>Communication uses HTTP POST to registered peer endpoints:</p>
149
- <table>
150
- <thead>
151
- <tr><th>Endpoint</th><th>Method</th><th>Description</th></tr>
152
- </thead>
153
- <tbody>
154
- <tr><td><code>/peer-info</code></td><td>GET</td><td>Get peer metadata (host, port, cwd, name, role)</td></tr>
155
- <tr><td><code>/peer-todo</code></td><td>POST</td><td>Accept inbound task assignment</td></tr>
156
- <tr><td><code>/peer-msg</code></td><td>POST</td><td>Accept inbound message</td></tr>
157
- <tr><td><code>/peer-exec</code></td><td>POST</td><td>Accept shell command execution</td></tr>
158
- </tbody>
159
- </table>
160
-
161
- <!-- ─── Footer ─── -->
162
- <footer class="footer">
163
- <span>Clew v0.2.7 — Open Source</span>
164
- <div class="footer-links">
165
- <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
166
- <a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
167
- </div>
168
- </footer>
169
-
170
- </main>
171
- <nav class="toc-sidebar"></nav>
172
- </div>
173
- </div>
174
-
175
- <script src="../js/main.js"></script>
176
- </body>
177
- </html>
178
-
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>Peer-to-Peer — LAN Collaboration — Clew</title>
7
+ <meta name="description" content="LAN peer discovery, task delegation, and autonomous AI peer coordination in Clew.">
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
+ <div class="header-inner">
17
+ <a href="../index.html" class="logo">
18
+ <span>Clew Code</span>
19
+ </a>
20
+ <nav class="header-nav">
21
+ <a href="../index.html">Home</a>
22
+ <a href="../index.html#features">Features</a>
23
+ <a href="../index.html#commands">Commands</a>
24
+ <a href="../quick-start.html" class="active">Docs</a>
25
+ <a href="https://github.com/ClewCode/ClewCode" target="_blank">GitHub</a>
26
+ <div class="lang-wrap">
27
+ <button class="lang-btn">🌐</button>
28
+ <div class="lang-menu">
29
+ <a href="../../readme/README.th.md">ไทย</a>
30
+ <a href="../../README.md">English</a>
31
+ </div>
32
+ </div>
33
+ </nav>
34
+ <button class="menu-btn" id="menuToggle" aria-label="Toggle navigation">
35
+ <span></span><span></span><span></span>
36
+ </button>
37
+ </div>
38
+ </header>
39
+
40
+ <div class="app">
41
+ <aside class="sidebar" id="sidebar"></aside>
42
+ <div class="sidebar-overlay" id="sidebarOverlay"></div>
43
+ <div class="content-wrap">
44
+ <main class="content">
45
+
46
+ <div class="breadcrumbs">
47
+ <a href="../index.html">Home</a>
48
+ <span>›</span>
49
+ <span>Peer-to-Peer</span>
50
+ </div>
51
+
52
+ <h1>Peer-to-Peer Collaboration</h1>
53
+ <p>
54
+ Clew supports LAN peer discovery and task delegation, enabling a lead-worker model
55
+ where one instance can coordinate multiple worker instances on the same network.
56
+ </p>
57
+
58
+ <h2>Architecture</h2>
59
+ <p>
60
+ Each peer runs a lightweight HTTP server (PeerServer) on a random port.
61
+ Discovery uses UDP multicast broadcast (239.255.37.37:42069) plus a file-based
62
+ registry (<code>~/.claude/peers/</code>) for same-machine peers.
63
+ </p>
64
+
65
+ <pre><code>Peer A (Lead) Peer B (Worker)
66
+ | |
67
+ |--- UDP multicast query ------->|
68
+ |<--- response (host, port, cwd)-|
69
+ | |
70
+ |--- HTTP POST /peer-todo ------>| Assign task
71
+ |--- HTTP POST /peer-exec ------>| Run command
72
+ |<--- response ------------------| Return result</code></pre>
73
+
74
+ <h2>Getting Started</h2>
75
+
76
+ <h3>Worker Setup</h3>
77
+ <pre><code># Start sharing (advertise on LAN)
78
+ /peer share
79
+
80
+ # Set display name and role
81
+ /peer name Build Server
82
+ /peer role builder</code></pre>
83
+
84
+ <h3>Lead Setup</h3>
85
+ <pre><code># Discover available peers
86
+ /peer discover
87
+
88
+ # Join a specific peer by port
89
+ /peer join 127.0.0.1:59421
90
+
91
+ # View connected peers
92
+ /peer list</code></pre>
93
+
94
+ <h3>Assign Tasks</h3>
95
+ <pre><code># Direct task assignment
96
+ /peer todo Build-Server "run the test suite"
97
+
98
+ # Let the AI handle it
99
+ > Assign a task to the build server to run all tests</code></pre>
100
+
101
+ <h2>Commands</h2>
102
+ <table>
103
+ <thead>
104
+ <tr><th>Command</th><th>Description</th></tr>
105
+ </thead>
106
+ <tbody>
107
+ <tr><td><code>/peer</code></td><td>Open interactive peer menu</td></tr>
108
+ <tr><td><code>/peer share</code></td><td>Start advertising as a worker</td></tr>
109
+ <tr><td><code>/peer share stop</code></td><td>Stop advertising</td></tr>
110
+ <tr><td><code>/peer discover</code></td><td>Scan LAN for peers (5s timeout)</td></tr>
111
+ <tr><td><code>/peer join &lt;port&gt;</code></td><td>Connect to a peer by port or host:port</td></tr>
112
+ <tr><td><code>/peer list</code></td><td>Open interactive peer list</td></tr>
113
+ <tr><td><code>/peer todo &lt;peer&gt; &lt;task&gt;</code></td><td>Assign a task to a worker</td></tr>
114
+ <tr><td><code>/peer todos</code></td><td>View received tasks</td></tr>
115
+ <tr><td><code>/peer todo done &lt;id&gt;</code></td><td>Mark task as complete</td></tr>
116
+ <tr><td><code>/peer name &lt;name&gt;</code></td><td>Set your display name</td></tr>
117
+ <tr><td><code>/peer role &lt;role&gt;</code></td><td>Set your role (e.g., builder, tester)</td></tr>
118
+ <tr><td><code>/peer inbox</code></td><td>View pending messages</td></tr>
119
+ <tr><td><code>/peer spawn [options]</code></td><td>Spawn a new peer shell terminal</td></tr>
120
+ <tr><td><code>/peer help</code></td><td>Show help</td></tr>
121
+ </tbody>
122
+ </table>
123
+
124
+ <h2>AI Peer Tools</h2>
125
+ <p>
126
+ Clew AI can autonomously coordinate peers using these tools:
127
+ </p>
128
+ <table>
129
+ <thead>
130
+ <tr><th>Tool</th><th>Description</th></tr>
131
+ </thead>
132
+ <tbody>
133
+ <tr><td><code>peer_discover</code></td><td>Scan for workers on LAN and same machine</td></tr>
134
+ <tr><td><code>peer_join</code></td><td>Connect to a remote peer by host:port</td></tr>
135
+ <tr><td><code>peer_send_task</code></td><td>Assign a task to a worker via HTTP POST</td></tr>
136
+ <tr><td><code>peer_list_tasks</code></td><td>Check pending and completed tasks</td></tr>
137
+ <tr><td><code>peer_list_roles</code></td><td>List all peers with names, roles, and IPs</td></tr>
138
+ <tr><td><code>peer_run</code></td><td>Execute a shell command on a remote worker</td></tr>
139
+ <tr><td><code>peer_share</code></td><td>Start or stop advertising as a worker</td></tr>
140
+ <tr><td><code>peer_info</code></td><td>Get detailed info about a specific peer</td></tr>
141
+ <tr><td><code>peer_set_name</code></td><td>Set display name for a peer</td></tr>
142
+ <tr><td><code>peer_set_role</code></td><td>Set role for a peer</td></tr>
143
+ </tbody>
144
+ </table>
145
+
146
+ <h2>Protocol</h2>
147
+ <p>Discovery uses UDP multicast on <code>239.255.37.37:42069</code>. Peer info is broadcast every 30 seconds. Peers are evicted after 90 seconds of inactivity.</p>
148
+ <p>Communication uses HTTP POST to registered peer endpoints:</p>
149
+ <table>
150
+ <thead>
151
+ <tr><th>Endpoint</th><th>Method</th><th>Description</th></tr>
152
+ </thead>
153
+ <tbody>
154
+ <tr><td><code>/peer-info</code></td><td>GET</td><td>Get peer metadata (host, port, cwd, name, role)</td></tr>
155
+ <tr><td><code>/peer-todo</code></td><td>POST</td><td>Accept inbound task assignment</td></tr>
156
+ <tr><td><code>/peer-msg</code></td><td>POST</td><td>Accept inbound message</td></tr>
157
+ <tr><td><code>/peer-exec</code></td><td>POST</td><td>Accept shell command execution</td></tr>
158
+ </tbody>
159
+ </table>
160
+
161
+ <!-- ─── Footer ─── -->
162
+ <footer class="footer">
163
+ <span>Clew 0.2.13 — Open Source</span>
164
+ <div class="footer-links">
165
+ <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
166
+ <a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
167
+ </div>
168
+ </footer>
169
+
170
+ </main>
171
+ <nav class="toc-sidebar"></nav>
172
+ </div>
173
+ </div>
174
+
175
+ <script src="../js/main.js"></script>
176
+ </body>
177
+ </html>
178
+