npm - clew-code - Versions diffs - 0.3.1 → 0.3.3 - Mend

clew-code 0.3.1 → 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

package/README.md +181 -113
package/dist/generated/version.json +1 -1
package/dist/main.js +2948 -3258
package/package.json +1 -1
package/docs/.nojekyll +0 -0
package/docs/_config.yml +0 -3
package/docs/architecture.html +0 -90
package/docs/assets/clew-agent-loop.png +0 -0
package/docs/assets/clew-general-architecture.png +0 -0
package/docs/assets/clew-mcp-architecture.png +0 -0
package/docs/assets/clew-p2p-swarm.png +0 -0
package/docs/assets/clew.svg +0 -33
package/docs/changelog.html +0 -141
package/docs/cli-reference.html +0 -89
package/docs/commands.html +0 -161
package/docs/configuration.html +0 -85
package/docs/contributing.html +0 -91
package/docs/css/styles.css +0 -545
package/docs/daemon.html +0 -62
package/docs/features/bridge-mode.html +0 -62
package/docs/features/evals.html +0 -58
package/docs/features/searxng-search.html +0 -59
package/docs/features/sentry-setup.html +0 -62
package/docs/generated/providers.html +0 -625
package/docs/generated/tools.html +0 -559
package/docs/index.html +0 -182
package/docs/installation.html +0 -77
package/docs/internals/claude-ai-backend-dependencies.md +0 -278
package/docs/internals/growthbook-ab-testing.html +0 -70
package/docs/internals/hidden-features.html +0 -82
package/docs/internals/long-term-memory-design.md +0 -173
package/docs/js/main.js +0 -438
package/docs/loop.html +0 -69
package/docs/mcp.html +0 -99
package/docs/models.html +0 -81
package/docs/permission-model.html +0 -86
package/docs/personal-profile.html +0 -113
package/docs/plugins.html +0 -84
package/docs/providers.html +0 -625
package/docs/quick-start.html +0 -81
package/docs/research-memory.html +0 -71
package/docs/security.html +0 -71
package/docs/skills.html +0 -67
package/docs/swarm.html +0 -78
package/docs/tools.html +0 -559
package/docs/troubleshooting.html +0 -86
package/docs/voice-mode.html +0 -79

package/docs/quick-start.html DELETED Viewed

@@ -1,81 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Quick Start — Clew Code</title>
-<meta name="description" content="Get started with Clew Code in under a minute.">
-<link rel="icon" type="image/svg+xml" href="assets/clew.svg">
-<link rel="preconnect" href="https://fonts.googleapis.com">
-<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">
-<link rel="stylesheet" href="css/styles.css">
-</head>
-<body>
-<header class="header"></header>
-<div id="sidebarOverlay" class="sidebar-overlay"></div>
-<aside id="sidebar" class="sidebar"></aside>
-<div class="content-wrap">
-<div class="content">
-<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">Quick Start</span></div>
-<h1>Quick Start</h1>
-<p class="sub">Get Clew Code running in under a minute.</p>
-<h2 id="install">1. Install</h2>
-<pre><code class="language-bash">npm install -g clew-code
-</code></pre>
-<p>Requires <a href="https://bun.sh">Bun</a> 1.3+, Node.js 18+, Git, and one provider API key.</p>
-<h2 id="run">2. Run</h2>
-<pre><code class="language-bash">cd my-project
-clew
-</code></pre>
-<p>On first launch you'll be prompted to select a provider.</p>
-<h2 id="configure-provider">3. Configure a Provider</h2>
-<p>Inside the REPL, pick your provider and model:</p>
-<pre><code class="language-bash">❯ /model openai
-❯ /model gpt-5.5
-❯ /model deepseek-v4-pro
-❯ /model ollama/llama3.3
-</code></pre>
-<p>Or set environment variables before starting:</p>
-<pre><code class="language-bash">export ANTHROPIC_API_KEY=sk-ant-...
-export OPENAI_API_KEY=sk-...
-export GOOGLE_API_KEY=...
-export DEEPSEEK_API_KEY=...
-</code></pre>
-<h2 id="first-commands">4. Try Commands</h2>
-<pre><code class="language-bash">❯ /help           # list everything
-❯ /status         # current provider, model, context info
-❯ /peer discover  # find other Clew instances on LAN
-❯ /mcp list       # connected MCP servers
-</code></pre>
-<h2 id="one-shot">One-Shot Mode</h2>
-<p>Pipe-friendly single-use mode:</p>
-<pre><code class="language-bash">clew -p "summarize CHANGELOG.md"
-</code></pre>
-<h2 id="resume">Resume Last Session</h2>
-<pre><code class="language-bash">clew --resume last
-</code></pre>
-<h2 id="next">Next Steps</h2>
-<ul>
-  <li><a href="installation.html">Full installation guide</a></li>
-  <li><a href="configuration.html">Configuration reference</a></li>
-  <li><a href="providers.html">All 27 providers</a></li>
-  <li><a href="commands.html">Slash commands</a></li>
-</ul>
-</div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>

package/docs/research-memory.html DELETED Viewed

@@ -1,71 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Research &amp; Memory — Clew Code</title>
-<meta name="description" content="Persistent memory and research system in Clew Code.">
-<link rel="icon" type="image/svg+xml" href="assets/clew.svg">
-<link rel="preconnect" href="https://fonts.googleapis.com">
-<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">
-<link rel="stylesheet" href="css/styles.css">
-</head>
-<body>
-<header class="header"></header>
-<div id="sidebarOverlay" class="sidebar-overlay"></div>
-<aside id="sidebar" class="sidebar"></aside>
-<div class="content-wrap">
-<div class="content">
-<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">Research &amp; Memory</span></div>
-<h1>Research &amp; Memory</h1>
-<p class="sub">Clew Code learns from your sessions over time. The memory system persists knowledge, preferences, and project context across sessions.</p>
-<h2 id="auto-memory">Auto-Memory</h2>
-<p>Clew Code automatically captures lessons from edit and exec sessions, storing them in <code>.moocode/memory.md</code>. The system tracks:</p>
-<ul>
-  <li>Project conventions and patterns</li>
-  <li>User preferences and workflow choices</li>
-  <li>Frequently used commands and tools</li>
-  <li>Architectural decisions and their rationale</li>
-</ul>
-<h2 id="ltm">Long-Term Memory</h2>
-<p>The long-term memory system uses SQLite (<code>~/.clew/projects/&lt;project&gt;/session-memory.db</code>) with a human-like consolidation model:</p>
-<table>
-  <thead>
-    <tr><th>Age</th><th>Level</th><th>Detail</th></tr>
-  </thead>
-  <tbody>
-    <tr><td>&lt; 7 days</td><td>Raw</td><td>Full session detail</td></tr>
-    <tr><td>1-4 weeks</td><td>Weekly digest</td><td>Summary + patterns</td></tr>
-    <tr><td>&gt; 1 month</td><td>Monthly digest</td><td>High-level trends</td></tr>
-    <tr><td>Ancient</td><td>Patterns only</td><td>Recurring topics preserved</td></tr>
-  </tbody>
-</table>
-<h2 id="memory-commands">Memory Commands</h2>
-<pre><code class="language-bash">❯ /memory save            # save session summary
-❯ /memory timeline        # show chronological session history
-❯ /memory stats           # activity density chart
-❯ /memory digest          # weekly/monthly digests
-❯ /memory preview         # preview sessions ready for consolidation
-❯ /memory consolidate     # mark old sessions as consolidated
-❯ /memory search &lt;q&gt;     # search stored memory entries
-</code></pre>
-<h2 id="research">Research System</h2>
-<p>The research system enables deep-dive investigations with persistent findings. Research results are indexed and searchable across sessions.</p>
-<pre><code class="language-bash">❯ /research start "topic"    # start a research session
-❯ /research list              # list all research topics
-❯ /research show &lt;id&gt;        # show research findings
-</code></pre>
-</div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>

package/docs/security.html DELETED Viewed

@@ -1,71 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Security — Clew Code</title>
-<meta name="description" content="Security model, license, and responsible disclosure for Clew Code.">
-<link rel="icon" type="image/svg+xml" href="assets/clew.svg">
-<link rel="preconnect" href="https://fonts.googleapis.com">
-<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">
-<link rel="stylesheet" href="css/styles.css">
-</head>
-<body>
-<header class="header"></header>
-<div id="sidebarOverlay" class="sidebar-overlay"></div>
-<aside id="sidebar" class="sidebar"></aside>
-<div class="content-wrap">
-<div class="content">
-<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">Security</span></div>
-<h1>Security</h1>
-<h2 id="overview">License Notice</h2>
-<p>Clew Code is an unofficial, reverse-engineered rebuild of Anthropic's Claude Code CLI, renamed and extended for research, local development, and self-hosted use. This repository is not an official Anthropic product. Anthropic has not authorized, endorsed, or sponsored this project.</p>
-<p>The upstream Claude Code product is proprietary software owned by Anthropic PBC.</p>
-<h2 id="api-keys">API Key Safety</h2>
-<p>Clew Code reads API keys from environment variables or <code>.env</code> files. Keys are never committed or shared:</p>
-<ul>
-  <li>Keep API keys in environment variables or <code>.env</code> (already in <code>.gitignore</code>)</li>
-  <li>Never include keys in prompts or tool calls</li>
-  <li>Use <code>/doctor</code> to verify provider connectivity without exposing secrets</li>
-</ul>
-<h2 id="permissions">Permission Security</h2>
-<p>Clew Code's 7-tier permission model prevents unauthorized operations:</p>
-<ul>
-  <li><strong>default/ask</strong> — user must approve every action</li>
-  <li><strong>auto</strong> — safe operations auto-approved, destructive ones still ask</li>
-  <li><strong>dontAsk</strong> — full trust. Use only in sandboxed environments</li>
-</ul>
-<p>See <a href="permission-model.html">Permission Model</a> for details.</p>
-<h2 id="safety">Safety Gates</h2>
-<p>The built-in safety gate system validates:</p>
-<ul>
-  <li>Command paths — blocks dangerous shell commands</li>
-  <li>File paths — prevents writes outside project boundaries</li>
-  <li>Output limits — 100 MB bash output cap</li>
-  <li>Malformed tool call guard — prevents injection attacks</li>
-  <li>PowerShell rule enforcement on Windows</li>
-</ul>
-<h2 id="responsible-disclosure">Responsible Disclosure</h2>
-<p>If you discover a security vulnerability, please open an issue on <a href="https://github.com/ClewCode/ClewCode/issues">GitHub</a> rather than posting publicly. Do not submit vulnerabilities as regular issues — use the security issue template.</p>
-<h2 id="reporting">Reporting a Vulnerability</h2>
-<p>To report a security issue, please:</p>
-<ol>
-  <li>Go to <a href="https://github.com/ClewCode/ClewCode/security">github.com/ClewCode/ClewCode/security</a></li>
-  <li>Click "Report a vulnerability"</li>
-  <li>Include as much context as possible (OS, version, steps to reproduce)</li>
-</ol>
-</div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>

package/docs/skills.html DELETED Viewed

@@ -1,67 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Skills — Clew Code</title>
-<meta name="description" href="The skills system in Clew Code — Claude Code compatible.">
-<link rel="icon" type="image/svg+xml" href="assets/clew.svg">
-<link rel="preconnect" href="https://fonts.googleapis.com">
-<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">
-<link rel="stylesheet" href="css/styles.css">
-</head>
-<body>
-<header class="header"></header>
-<div id="sidebarOverlay" class="sidebar-overlay"></div>
-<aside id="sidebar" class="sidebar"></aside>
-<div class="content-wrap">
-<div class="content">
-<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">Skills</span></div>
-<h1>Skills</h1>
-<p class="sub">Skills are reusable, invocable capabilities that extend Clew Code with domain-specific expertise. The skills system is Claude Code compatible.</p>
-<h2 id="overview">Overview</h2>
-<p>Skills are defined in <code>SKILL.md</code> files and matched by name or description. When a user or agent invokes a skill, its prompt is loaded into the conversation, providing specialized instructions and context.</p>
-<h2 id="builtin">Built-in Skills</h2>
-<table>
-  <thead>
-    <tr><th>Skill</th><th>Description</th></tr>
-  </thead>
-  <tbody>
-    <tr><td><code>/verify</code></td><td>Run full verification — typecheck, lint, and tests</td></tr>
-    <tr><td><code>/precommit</code></td><td>Pre-commit review with verification and git diff summary</td></tr>
-    <tr><td><code>/commit</code></td><td>Stage, commit, and push git changes with conventional commits</td></tr>
-    <tr><td><code>/code-review</code></td><td>Review code for correctness bugs at configurable effort</td></tr>
-    <tr><td><code>/loop</code></td><td>Run a prompt or command on a recurring interval</td></tr>
-    <tr><td><code>/update-config</code></td><td>Configure Clew Code via settings.json</td></tr>
-    <tr><td><code>/scrapling</code></td><td>Web scraping using Scrapling framework</td></tr>
-  </tbody>
-</table>
-<h2 id="creating">Creating a Skill</h2>
-<p>Create a <code>SKILL.md</code> file in your project:</p>
-<pre><code class="language-markdown"># my-skill
-Invoke with `/my-skill [args]`.
-## Instructions
-Provide detailed instructions for what this skill should do.
-Include context, constraints, and examples.
-</code></pre>
-<p>Skills are automatically discovered from the project root.</p>
-<h2 id="skill-commands">Skill Commands</h2>
-<pre><code class="language-bash">❯ /skills           # list all available skills
-❯ /my-skill args    # invoke a specific skill with arguments
-</code></pre>
-</div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>

package/docs/swarm.html DELETED Viewed

@@ -1,78 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Swarm System — Clew Code</title>
-<meta name="description" content="Multi-agent swarm coordination in Clew Code.">
-<link rel="icon" type="image/svg+xml" href="assets/clew.svg">
-<link rel="preconnect" href="https://fonts.googleapis.com">
-<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">
-<link rel="stylesheet" href="css/styles.css">
-</head>
-<body>
-<header class="header"></header>
-<div id="sidebarOverlay" class="sidebar-overlay"></div>
-<aside id="sidebar" class="sidebar"></aside>
-<div class="content-wrap">
-<div class="content">
-<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">Swarm System</span></div>
-<h1>Swarm System</h1>
-<p class="sub">Coordinate multiple AI agents working together on complex tasks.</p>
-<h2 id="overview">Overview</h2>
-<p>The swarm system enables multiple agent instances to work together as a team. Each agent has an identity, mailbox, task queue, and can communicate with other agents in the swarm.</p>
-<h2 id="architecture">Architecture</h2>
-<pre><code>Agent A (Coordinator)
-  ├── Agent B (Researcher)
-  │   └── Agent D (Data Collector)
-  ├── Agent C (Implementer)
-  └── Agent E (Reviewer)
-</code></pre>
-<p>Agents communicate via a message bus. Each agent has its own:</p>
-<ul>
-  <li><strong>Identity</strong> — name, role, capabilities</li>
-  <li><strong>Mailbox</strong> — receives messages from other agents</li>
-  <li><strong>Task queue</strong> — pending and completed tasks</li>
-  <li><strong>Result channel</strong> — output is collected by the coordinator</li>
-</ul>
-<h2 id="execution">Execution Modes</h2>
-<table>
-  <thead>
-    <tr><th>Mode</th><th>Description</th></tr>
-  </thead>
-  <tbody>
-    <tr><td>Pane/tmux</td><td>Each agent runs in its own terminal pane</td></tr>
-    <tr><td>In-process</td><td>Agents run as lightweight coroutines within the same process</td></tr>
-  </tbody>
-</table>
-<h2 id="vs-subagent">Swarm vs. Subagent</h2>
-<table>
-  <thead>
-    <tr><th>Subagent</th><th>Swarm/Teammate</th></tr>
-  </thead>
-  <tbody>
-    <tr><td>One-shot, isolated</td><td>Persistent, collaborative</td></tr>
-    <tr><td>No inter-agent communication</td><td>Full mailbox system</td></tr>
-    <tr><td>Results returned once</td><td>Continuous coordination</td></tr>
-    <tr><td>Best for exploration</td><td>Best for long-running complex tasks</td></tr>
-  </tbody>
-</table>
-<h2 id="commands">Swarm Commands</h2>
-<pre><code class="language-bash">❯ /agents              # open agent dashboard
-❯ /agent dispatch ...  # dispatch a subagent
-</code></pre>
-</div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>