clew-code 0.2.28 → 0.2.29
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 +38 -28
- package/dist/main.js +2318 -2331
- package/docs/architecture.html +90 -91
- package/docs/changelog.html +141 -150
- package/docs/cli-reference.html +89 -90
- package/docs/commands.html +10 -9
- package/docs/daemon.html +62 -62
- package/docs/generated/providers.html +625 -0
- package/docs/generated/tools.html +559 -0
- package/docs/index.html +10 -13
- package/docs/personal-profile.html +3 -3
- package/docs/providers.html +625 -87
- package/docs/quick-start.html +81 -81
- package/docs/tools.html +551 -175
- package/docs/troubleshooting.html +86 -86
- package/package.json +162 -165
package/docs/cli-reference.html
CHANGED
|
@@ -1,90 +1,89 @@
|
|
|
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>CLI Reference — Clew Code</title>
|
|
7
|
-
<meta name="description" content="Command-line interface reference 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">CLI Reference</span></div>
|
|
22
|
-
|
|
23
|
-
<h1>CLI Reference</h1>
|
|
24
|
-
<p class="sub">Complete reference for Clew Code command-line flags and arguments.</p>
|
|
25
|
-
|
|
26
|
-
<h2 id="usage">Usage</h2>
|
|
27
|
-
<pre><code class="language-bash">clew [flags]
|
|
28
|
-
clew [command] [flags]
|
|
29
|
-
</code></pre>
|
|
30
|
-
|
|
31
|
-
<h2 id="global">Global Flags</h2>
|
|
32
|
-
<table>
|
|
33
|
-
<thead>
|
|
34
|
-
<tr><th>Flag</th><th>Description</th></tr>
|
|
35
|
-
</thead>
|
|
36
|
-
<tbody>
|
|
37
|
-
<tr><td><code>-p, --prompt <text></code></td><td>One-shot mode: run a prompt in non-interactive mode and exit</td></tr>
|
|
38
|
-
<tr><td><code>--resume <id></code></td><td>Resume a previous session by ID. Use <code>last</code> for the most recent session</td></tr>
|
|
39
|
-
<tr><td><code>--version</code></td><td>Print version and exit</td></tr>
|
|
40
|
-
<tr><td><code>--help</code></td><td>Show help message</td></tr>
|
|
41
|
-
</tbody>
|
|
42
|
-
</table>
|
|
43
|
-
|
|
44
|
-
<h2 id="exec">Exec Commands</h2>
|
|
45
|
-
<table>
|
|
46
|
-
<thead>
|
|
47
|
-
<tr><th>Command</th><th>Description</th></tr>
|
|
48
|
-
</thead>
|
|
49
|
-
<tbody>
|
|
50
|
-
<tr><td><code>clew . <prompt></code></td><td>Run prompt in current directory</td></tr>
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
<
|
|
56
|
-
<
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
<tr><td><code>
|
|
62
|
-
<tr><td><code>
|
|
63
|
-
<tr><td><code>
|
|
64
|
-
<tr><td><code>
|
|
65
|
-
<tr><td><code>
|
|
66
|
-
<tr><td><code>
|
|
67
|
-
<tr><td><code>
|
|
68
|
-
<tr><td><code>
|
|
69
|
-
<tr><td><code>
|
|
70
|
-
<tr><td><code>
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
<
|
|
76
|
-
<
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
<tr><td><code>
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
</
|
|
85
|
-
</div>
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
</
|
|
90
|
-
</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>CLI Reference — Clew Code</title>
|
|
7
|
+
<meta name="description" content="Command-line interface reference 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">CLI Reference</span></div>
|
|
22
|
+
|
|
23
|
+
<h1>CLI Reference</h1>
|
|
24
|
+
<p class="sub">Complete reference for Clew Code command-line flags and arguments.</p>
|
|
25
|
+
|
|
26
|
+
<h2 id="usage">Usage</h2>
|
|
27
|
+
<pre><code class="language-bash">clew [flags]
|
|
28
|
+
clew [command] [flags]
|
|
29
|
+
</code></pre>
|
|
30
|
+
|
|
31
|
+
<h2 id="global">Global Flags</h2>
|
|
32
|
+
<table>
|
|
33
|
+
<thead>
|
|
34
|
+
<tr><th>Flag</th><th>Description</th></tr>
|
|
35
|
+
</thead>
|
|
36
|
+
<tbody>
|
|
37
|
+
<tr><td><code>-p, --prompt <text></code></td><td>One-shot mode: run a prompt in non-interactive mode and exit</td></tr>
|
|
38
|
+
<tr><td><code>--resume <id></code></td><td>Resume a previous session by ID. Use <code>last</code> for the most recent session</td></tr>
|
|
39
|
+
<tr><td><code>--version</code></td><td>Print version and exit</td></tr>
|
|
40
|
+
<tr><td><code>--help</code></td><td>Show help message</td></tr>
|
|
41
|
+
</tbody>
|
|
42
|
+
</table>
|
|
43
|
+
|
|
44
|
+
<h2 id="exec">Exec Commands</h2>
|
|
45
|
+
<table>
|
|
46
|
+
<thead>
|
|
47
|
+
<tr><th>Command</th><th>Description</th></tr>
|
|
48
|
+
</thead>
|
|
49
|
+
<tbody>
|
|
50
|
+
<tr><td><code>clew . <prompt></code></td><td>Run prompt in current directory</td></tr>
|
|
51
|
+
</tbody>
|
|
52
|
+
</table>
|
|
53
|
+
|
|
54
|
+
<h2 id="env">Environment Variables</h2>
|
|
55
|
+
<table>
|
|
56
|
+
<thead>
|
|
57
|
+
<tr><th>Variable</th><th>Description</th></tr>
|
|
58
|
+
</thead>
|
|
59
|
+
<tbody>
|
|
60
|
+
<tr><td><code>ANTHROPIC_API_KEY</code></td><td>Anthropic Claude API key</td></tr>
|
|
61
|
+
<tr><td><code>OPENAI_API_KEY</code></td><td>OpenAI API key</td></tr>
|
|
62
|
+
<tr><td><code>GOOGLE_API_KEY</code></td><td>Google Gemini API key</td></tr>
|
|
63
|
+
<tr><td><code>DEEPSEEK_API_KEY</code></td><td>DeepSeek API key</td></tr>
|
|
64
|
+
<tr><td><code>GROQ_API_KEY</code></td><td>Groq API key</td></tr>
|
|
65
|
+
<tr><td><code>MISTRAL_API_KEY</code></td><td>Mistral API key</td></tr>
|
|
66
|
+
<tr><td><code>OPENROUTER_API_KEY</code></td><td>OpenRouter API key</td></tr>
|
|
67
|
+
<tr><td><code>OLLAMA_HOST</code></td><td>Ollama server URL (default: http://localhost:11434)</td></tr>
|
|
68
|
+
<tr><td><code>SEARXNG_URL</code></td><td>SearXNG instance URL</td></tr>
|
|
69
|
+
<tr><td><code>SENTRY_DSN</code></td><td>Sentry DSN for error tracking</td></tr>
|
|
70
|
+
<tr><td><code>GROWTHBOOK_API_KEY</code></td><td>GrowthBook API key for feature flags</td></tr>
|
|
71
|
+
</tbody>
|
|
72
|
+
</table>
|
|
73
|
+
|
|
74
|
+
<h2 id="exit-codes">Exit Codes</h2>
|
|
75
|
+
<table>
|
|
76
|
+
<thead>
|
|
77
|
+
<tr><th>Code</th><th>Meaning</th></tr>
|
|
78
|
+
</thead>
|
|
79
|
+
<tbody>
|
|
80
|
+
<tr><td><code>0</code></td><td>Success</td></tr>
|
|
81
|
+
<tr><td><code>1</code></td><td>General error</td></tr>
|
|
82
|
+
</tbody>
|
|
83
|
+
</table>
|
|
84
|
+
</div>
|
|
85
|
+
</div>
|
|
86
|
+
|
|
87
|
+
<script src="js/main.js"></script>
|
|
88
|
+
</body>
|
|
89
|
+
</html>
|
package/docs/commands.html
CHANGED
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">Commands</span></div>
|
|
22
22
|
|
|
23
23
|
<h1>Commands</h1>
|
|
24
|
-
<p class="sub">Clew Code provides 35+ slash commands for managing providers, sessions,
|
|
24
|
+
<p class="sub">Clew Code provides 35+ slash commands for managing providers, sessions, peer networking, MCP, plugins, and more.</p>
|
|
25
25
|
|
|
26
26
|
<h2 id="session">Session Commands</h2>
|
|
27
27
|
<table>
|
|
@@ -54,19 +54,19 @@
|
|
|
54
54
|
</tbody>
|
|
55
55
|
</table>
|
|
56
56
|
|
|
57
|
-
<h2 id="
|
|
57
|
+
<h2 id="peer">Peer & Networking Commands</h2>
|
|
58
58
|
<table>
|
|
59
59
|
<thead>
|
|
60
60
|
<tr><th>Command</th><th>Description</th></tr>
|
|
61
61
|
</thead>
|
|
62
62
|
<tbody>
|
|
63
|
-
<tr><td><code>/
|
|
64
|
-
<tr><td><code>/
|
|
65
|
-
<tr><td><code>/
|
|
66
|
-
<tr><td><code>/
|
|
67
|
-
<tr><td><code>/
|
|
68
|
-
<tr><td><code>/
|
|
69
|
-
<tr><td><code>/
|
|
63
|
+
<tr><td><code>/peer discover</code></td><td>Find other Clew instances on the LAN</td></tr>
|
|
64
|
+
<tr><td><code>/peer share</code></td><td>Share this instance as a worker</td></tr>
|
|
65
|
+
<tr><td><code>/peer run <peer> <cmd></code></td><td>Run a command on a remote peer</td></tr>
|
|
66
|
+
<tr><td><code>/peer send <peer> <msg></code></td><td>Send a message to a peer</td></tr>
|
|
67
|
+
<tr><td><code>/peer list</code></td><td>List discovered peers</td></tr>
|
|
68
|
+
<tr><td><code>/peer info <peer></code></td><td>Show peer details</td></tr>
|
|
69
|
+
<tr><td><code>/peer help</code></td><td>Peer command reference</td></tr>
|
|
70
70
|
</tbody>
|
|
71
71
|
</table>
|
|
72
72
|
|
|
@@ -158,3 +158,4 @@
|
|
|
158
158
|
<script src="js/main.js"></script>
|
|
159
159
|
</body>
|
|
160
160
|
</html>
|
|
161
|
+
|
package/docs/daemon.html
CHANGED
|
@@ -1,62 +1,62 @@
|
|
|
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>Daemon Mode — Clew Code</title>
|
|
7
|
-
<meta name="description" content="Run Clew Code as a background daemon for autonomous operations.">
|
|
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">Daemon Mode</span></div>
|
|
22
|
-
|
|
23
|
-
<h1>Daemon Mode</h1>
|
|
24
|
-
<p class="sub">Run Clew Code as a persistent background process for autonomous task execution, scheduled jobs, and continuous monitoring.</p>
|
|
25
|
-
|
|
26
|
-
<h2 id="overview">Overview</h2>
|
|
27
|
-
<p>Daemon mode keeps Clew Code running in the background, processing tasks from a persistent queue, executing scheduled jobs via cron, and coordinating with
|
|
28
|
-
|
|
29
|
-
<h2 id="daemon-commands">Daemon Commands</h2>
|
|
30
|
-
<pre><code class="language-bash">❯ /daemon # Open daemon dashboard
|
|
31
|
-
❯ /daemon status # Check daemon status
|
|
32
|
-
</code></pre>
|
|
33
|
-
|
|
34
|
-
<h2 id="task-queue">Task Queue</h2>
|
|
35
|
-
<p>The daemon uses a file-backed persistent task queue with:</p>
|
|
36
|
-
<ul>
|
|
37
|
-
<li><strong>Lease-based concurrency</strong> — max 3 concurrent workers</li>
|
|
38
|
-
<li><strong>Exponential backoff retry</strong> — failed tasks are retried with increasing delays</li>
|
|
39
|
-
<li><strong>Dead-letter management</strong> — tasks that exceed retry limits are moved to dead-letter storage</li>
|
|
40
|
-
</ul>
|
|
41
|
-
|
|
42
|
-
<h2 id="scheduling">Scheduling</h2>
|
|
43
|
-
<p>Use cron syntax to schedule recurring tasks:</p>
|
|
44
|
-
<pre><code class="language-bash">❯ /task add "0 9 * * *" "daily standup summary"
|
|
45
|
-
❯ /task list # list scheduled tasks
|
|
46
|
-
❯ /task remove <id> # remove a task
|
|
47
|
-
</code></pre>
|
|
48
|
-
|
|
49
|
-
<h2 id="loop">Agent Loop</h2>
|
|
50
|
-
<p>The daemon integrates with the autonomous agent loop for 24/7 operation:</p>
|
|
51
|
-
<pre><code class="language-bash">❯ /loop start # start the autonomous loop
|
|
52
|
-
❯ /loop stop # stop the loop
|
|
53
|
-
❯ /loop status # check loop status
|
|
54
|
-
</code></pre>
|
|
55
|
-
|
|
56
|
-
<p>See <a href="loop.html">Agent Loop</a> for details.</p>
|
|
57
|
-
</div>
|
|
58
|
-
</div>
|
|
59
|
-
|
|
60
|
-
<script src="js/main.js"></script>
|
|
61
|
-
</body>
|
|
62
|
-
</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>Daemon Mode — Clew Code</title>
|
|
7
|
+
<meta name="description" content="Run Clew Code as a background daemon for autonomous operations.">
|
|
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">Daemon Mode</span></div>
|
|
22
|
+
|
|
23
|
+
<h1>Daemon Mode</h1>
|
|
24
|
+
<p class="sub">Run Clew Code as a persistent background process for autonomous task execution, scheduled jobs, and continuous monitoring.</p>
|
|
25
|
+
|
|
26
|
+
<h2 id="overview">Overview</h2>
|
|
27
|
+
<p>Daemon mode keeps Clew Code running in the background, processing tasks from a persistent queue, executing scheduled jobs via cron, and coordinating with other peers — all without an active terminal session.</p>
|
|
28
|
+
|
|
29
|
+
<h2 id="daemon-commands">Daemon Commands</h2>
|
|
30
|
+
<pre><code class="language-bash">❯ /daemon # Open daemon dashboard
|
|
31
|
+
❯ /daemon status # Check daemon status
|
|
32
|
+
</code></pre>
|
|
33
|
+
|
|
34
|
+
<h2 id="task-queue">Task Queue</h2>
|
|
35
|
+
<p>The daemon uses a file-backed persistent task queue with:</p>
|
|
36
|
+
<ul>
|
|
37
|
+
<li><strong>Lease-based concurrency</strong> — max 3 concurrent workers</li>
|
|
38
|
+
<li><strong>Exponential backoff retry</strong> — failed tasks are retried with increasing delays</li>
|
|
39
|
+
<li><strong>Dead-letter management</strong> — tasks that exceed retry limits are moved to dead-letter storage</li>
|
|
40
|
+
</ul>
|
|
41
|
+
|
|
42
|
+
<h2 id="scheduling">Scheduling</h2>
|
|
43
|
+
<p>Use cron syntax to schedule recurring tasks:</p>
|
|
44
|
+
<pre><code class="language-bash">❯ /task add "0 9 * * *" "daily standup summary"
|
|
45
|
+
❯ /task list # list scheduled tasks
|
|
46
|
+
❯ /task remove <id> # remove a task
|
|
47
|
+
</code></pre>
|
|
48
|
+
|
|
49
|
+
<h2 id="loop">Agent Loop</h2>
|
|
50
|
+
<p>The daemon integrates with the autonomous agent loop for 24/7 operation:</p>
|
|
51
|
+
<pre><code class="language-bash">❯ /loop start # start the autonomous loop
|
|
52
|
+
❯ /loop stop # stop the loop
|
|
53
|
+
❯ /loop status # check loop status
|
|
54
|
+
</code></pre>
|
|
55
|
+
|
|
56
|
+
<p>See <a href="loop.html">Agent Loop</a> for details.</p>
|
|
57
|
+
</div>
|
|
58
|
+
</div>
|
|
59
|
+
|
|
60
|
+
<script src="js/main.js"></script>
|
|
61
|
+
</body>
|
|
62
|
+
</html>
|