npm - clew-code - Versions diffs - 0.2.1 - Mend

clew-code 0.2.1

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 (38) hide show

package/LICENSE.md +71 -0
package/README.md +356 -0
package/bin/claudevil +2 -0
package/bin/claudevil.cjs +96 -0
package/bin/clew +2 -0
package/bin/clew.cjs +96 -0
package/dist/main.js +10766 -0
package/docs/.nojekyll +0 -0
package/docs/PLAN.md +304 -0
package/docs/_config.yml +3 -0
package/docs/architecture.html +144 -0
package/docs/commands.html +222 -0
package/docs/configuration.html +144 -0
package/docs/css/styles.css +790 -0
package/docs/daemon.html +139 -0
package/docs/features/bridge-mode.html +77 -0
package/docs/features/evals.html +160 -0
package/docs/features/searxng-search.html +129 -0
package/docs/features/sentry-setup.html +135 -0
package/docs/index.html +307 -0
package/docs/installation.html +102 -0
package/docs/internals/claude-ai-backend-dependencies.md +278 -0
package/docs/internals/growthbook-ab-testing.html +90 -0
package/docs/internals/hidden-features.html +126 -0
package/docs/js/main.js +272 -0
package/docs/mcp.html +136 -0
package/docs/models.html +108 -0
package/docs/permission-model.html +100 -0
package/docs/plugins.html +100 -0
package/docs/providers.html +116 -0
package/docs/quick-start.html +99 -0
package/docs/research-memory.html +90 -0
package/docs/skills.html +115 -0
package/docs/taste.html +181 -0
package/docs/taste1.html +177 -0
package/docs/tools.html +168 -0
package/docs/troubleshooting.html +104 -0
package/package.json +157 -0

package/docs/features/sentry-setup.html ADDED Viewed

@@ -0,0 +1,135 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Sentry Error Reporting — Clew</title>
+  <meta name="description" content="Opt-in Sentry crash/error telemetry for Clew — default off, privacy-first.">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <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">
+  <div class="header-inner">
+    <a href="../index.html" class="logo"><span>Clew</span></a>
+    <nav class="header-nav">
+      <a href="../index.html">Home</a>
+      <a href="../index.html#features">Features</a>
+      <a href="../index.html#commands">Commands</a>
+      <a href="../quick-start.html" class="active">Docs</a>
+      <a href="https://github.com/JonusNattapong/ClewCode" target="_blank">GitHub</a>
+    </nav>
+    <button class="menu-btn" id="menuToggle" aria-label="Toggle navigation"><span></span><span></span><span></span></button>
+  </div>
+</header>
+<div class="app">
+  <aside class="sidebar" id="sidebar"></aside>
+  <div class="sidebar-overlay" id="sidebarOverlay"></div>
+  <div class="content-wrap">
+    <main class="content">
+      <div class="breadcrumbs"><a href="../index.html">Home</a><span class="sep">/</span><a href="../index.html#features">Features</a><span class="sep">/</span><span>Sentry Setup</span></div>
+      <h1>Sentry Error Reporting</h1>
+      <p class="section-subtitle">Optional, opt-in crash and error telemetry — <strong>completely disabled by default</strong>. No data leaves your machine unless you explicitly set <code>SENTRY_DSN</code>.</p>
+      <div class="callout callout-tip">
+        <strong>TL;DR</strong>
+        <code>SENTRY_DSN=https://key@sentry.io/123 claude</code> — that's it. Without it, zero network requests, zero telemetry.
+      </div>
+      <h2>Quick Start</h2>
+      <h3>Self-hosted Sentry</h3>
+      <pre><code>SENTRY_DSN=https://public_key@your-sentry.example.com/123 claude</code></pre>
+      <h3>Sentry Cloud</h3>
+      <pre><code>SENTRY_DSN=https://public_key@o123456.ingest.sentry.io/789 claude</code></pre>
+      <h3>Disable (default)</h3>
+      <pre><code>clew</code></pre>
+      <h2>Environment Variables</h2>
+      <table>
+        <tr><th>Variable</th><th>Required</th><th>Default</th><th>Description</th></tr>
+        <tr><td><code>SENTRY_DSN</code></td><td><strong>yes</strong></td><td>—</td><td>Sentry DSN to enable. Without this, everything is no-op.</td></tr>
+        <tr><td><code>SENTRY_ENVIRONMENT</code></td><td>no</td><td><code>NODE_ENV</code> or <code>production</code></td><td>Environment tag in Sentry dashboard</td></tr>
+        <tr><td><code>SENTRY_RELEASE</code></td><td>no</td><td>auto from package.json</td><td>Release version tag</td></tr>
+        <tr><td><code>SENTRY_SAMPLE_RATE</code></td><td>no</td><td><code>1.0</code></td><td>Error sample rate (0.0–1.0)</td></tr>
+      </table>
+      <h2>What Gets Sent</h2>
+      <p>Only error metadata — <strong>never prompts, responses, file contents, or command output</strong>:</p>
+      <ul>
+        <li>Error name, message, and stack trace (without local variable values)</li>
+        <li>Runtime info: OS platform, Node/Bun version</li>
+        <li>Mode: REPL, non-interactive, MCP server</li>
+        <li>Provider and model name (when applicable)</li>
+        <li>Version and release tag</li>
+      </ul>
+      <h2>What Does NOT Get Sent</h2>
+      <table>
+        <tr><th>Category</th><th>Examples</th></tr>
+        <tr><td><strong>Prompts</strong></td><td>user input, AI system prompts</td></tr>
+        <tr><td><strong>Responses</strong></td><td>model output, streaming chunks</td></tr>
+        <tr><td><strong>File content</strong></td><td>Read/Edit/Write payload, command stdout/stderr</td></tr>
+        <tr><td><strong>Credentials</strong></td><td>API keys, tokens, passwords, cookies</td></tr>
+        <tr><td><strong>Auth headers</strong></td><td>Authorization, x-api-key, Cookie, Set-Cookie</td></tr>
+        <tr><td><strong>OAuth tokens</strong></td><td>access_token, refresh_token, id_token</td></tr>
+        <tr><td><strong>Environment dump</strong></td><td>entire env block (individual vars may appear as tags)</td></tr>
+        <tr><td><strong>Local paths</strong></td><td>home directory anonymized to <code>[HOME]</code></td></tr>
+        <tr><td><strong>Breadcrumbs</strong></td><td>user actions are not tracked</td></tr>
+        <tr><td><strong>User identity</strong></td><td>user field stripped from all events</td></tr>
+      </table>
+      <h2>Privacy Scrubber</h2>
+      <p>Every event passes through a <code>beforeSend</code> hook that:</p>
+      <ol>
+        <li><strong>Scrubs strings</strong> — removes API key patterns (<code>sk-*</code>, <code>Bearer</code> tokens), auth headers, cookie values</li>
+        <li><strong>Strips stack frame variables</strong> — removes <code>vars</code>, <code>pre_context</code>, <code>context_line</code>, <code>post_context</code></li>
+        <li><strong>Removes breadcrumbs</strong> — user actions are never tracked</li>
+        <li><strong>Cleans request data</strong> — removes headers, cookies, query strings</li>
+        <li><strong>Anonymizes home directory</strong> — replaces paths with <code>[HOME]</code></li>
+        <li><strong>Drops oversized strings</strong> — over 2000 chars truncated</li>
+        <li><strong>Recursively scrubs nested objects</strong> — drops keys named prompt, response, content, message, input, output, text, body, data, payload, token, key, secret, password, auth, cookie</li>
+      </ol>
+      <h2>Checking Status</h2>
+      <pre><code># When disabled
+Sentry Telemetry: Disabled (set SENTRY_DSN to enable)
+# When enabled
+Sentry Telemetry: Enabled</code></pre>
+      <div class="callout callout-info">
+        <strong>DSN Masking</strong>
+        The DSN is masked in the UI — only the first 8 and last 4 characters of the key are shown. The full DSN is never displayed in any output.
+      </div>
+      <h2>Files</h2>
+      <table>
+        <tr><th>File</th><th>Purpose</th></tr>
+        <tr><td><code>src/utils/sentry.ts</code></td><td>Core wrapper — init, capture, close, scrubber</td></tr>
+        <tr><td><code>src/utils/sentry.test.ts</code></td><td>Unit tests (11 tests)</td></tr>
+        <tr><td><code>src/entrypoints/init.ts</code></td><td>Calls <code>initSentry()</code> at startup</td></tr>
+        <tr><td><code>src/utils/gracefulShutdown.ts</code></td><td>Calls <code>closeSentry()</code> before exit</td></tr>
+        <tr><td><code>src/utils/log.ts</code></td><td><code>logError()</code> sends to Sentry when enabled</td></tr>
+        <tr><td><code>src/components/SentryErrorBoundary.tsx</code></td><td>React error boundary for render crashes</td></tr>
+        <tr><td><code>src/components/App.tsx</code></td><td>Wraps app tree in <code>SentryErrorBoundary</code></td></tr>
+        <tr><td><code>src/utils/doctorDiagnostic.ts</code></td><td><code>/doctor</code> Sentry status display</td></tr>
+      </table>
+      <footer class="footer">
+        <span>Clew v0.1.2</span>
+        <div class="footer-links">
+          <a href="https://github.com/JonusNattapong/ClewCode">GitHub</a>
+          <a href="https://github.com/JonusNattapong/ClewCode/issues">Issues</a>
+        </div>
+      </footer>
+    </main>
+    <nav class="toc-sidebar"></nav>
+  </div>
+</div>
+<script src="../js/main.js"></script>
+</body>
+</html>

package/docs/index.html ADDED Viewed

@@ -0,0 +1,307 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Clew — Multi-Provider AI Coding Assistant</title>
+  <meta name="description" content="Terminal-based AI coding assistant with 15+ AI providers, 80+ slash commands, extensible plugin system.">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <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 ─── -->
+<header class="header">
+  <div class="header-inner">
+    <a href="index.html" class="logo">
+      <span class="logo-mark">C</span>
+      <span>Clew</span>
+    </a>
+    <nav class="header-nav">
+      <a href="index.html" class="active">Home</a>
+      <a href="#features">Features</a>
+      <a href="#commands">Commands</a>
+      <a href="quick-start.html">Docs</a>
+      <a href="https://github.com/JonusNattapong/ClewCode" target="_blank">GitHub</a>
+    </nav>
+    <button class="menu-btn" id="menuToggle" aria-label="Toggle navigation">
+      <span></span><span></span><span></span>
+    </button>
+  </div>
+</header>
+<div class="app">
+  <!-- ─── Sidebar ─── -->
+  <aside class="sidebar" id="sidebar"></aside>
+  <div class="sidebar-overlay" id="sidebarOverlay"></div>
+  <!-- ─── Content Wrap ─── -->
+  <div class="content-wrap">
+    <main class="content">
+      <!-- ─── Breadcrumbs ─── -->
+      <div class="breadcrumbs">
+        <a href="index.html">Home</a>
+      </div>
+      <!-- ─── Hero ─── -->
+      <section class="hero">
+        <div class="hero-badge">
+          <span class="dot"></span>
+          v0.2.1 — Multi-Provider AI CLI
+        </div>
+        <h1>
+          Code with<br>
+          <span class="highlight">any model</span>
+        </h1>
+        <p>
+          A terminal-based AI coding assistant with multi-provider routing,
+          extensible plugin architecture, and a comprehensive tool system
+          for professional development workflows.
+        </p>
+        <div class="hero-actions">
+          <a href="https://npmjs.com/package/clew-code" class="btn btn-primary">
+            npm install -g clew-code
+          </a>
+          <a href="https://github.com/JonusNattapong/ClewCode" class="btn btn-ghost" target="_blank">
+            GitHub →
+          </a>
+        </div>
+      </section>
+      <!-- ─── Terminal Demo ─── -->
+      <div class="terminal-window">
+        <div class="terminal-bar">
+          <span class="terminal-dot"></span>
+          <span class="terminal-dot"></span>
+          <span class="terminal-dot"></span>
+          <span class="terminal-title">clew — ~/project</span>
+        </div>
+        <div class="terminal-body">
+          <span class="line"><span class="prompt">$</span> <span class="cmd">clew</span></span>
+          <span class="line"><span class="output">╭──────────────────────────────────────────╮</span></span>
+          <span class="line"><span class="output">│ <span class="highlight-amber">Clew</span> · model: <span class="highlight-cyan">deepseek-v4-flash</span>  │</span></span>
+          <span class="line"><span class="output">│ provider: <span class="highlight-cyan">DeepSeek</span> · context: <span class="highlight-amber">78%</span>  │</span></span>
+          <span class="line"><span class="output">╰──────────────────────────────────────────╯</span></span>
+          <span class="line"><span class="prompt">></span> <span class="cmd">"find all unused exports in src/"</span></span>
+          <span class="line"><span class="output">Searching <span class="highlight-cyan">3 files</span>... Found <span class="highlight-amber">2 unused exports</span>.</span></span>
+        </div>
+      </div>
+      <!-- ─── Stats ─── -->
+      <div class="stats-grid">
+        <div class="stat-card">
+          <div class="stat-number">27</div>
+          <div class="stat-label">AI Providers</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-number">80+</div>
+          <div class="stat-label">Slash Commands</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-number">50+</div>
+          <div class="stat-label">Built-in Tools</div>
+        </div>
+        <div class="stat-card">
+          <div class="stat-number">100%</div>
+          <div class="stat-label">Open Source</div>
+        </div>
+      </div>
+      <!-- ─── Features ─── -->
+      <h2 class="section-title" id="features">Features</h2>
+      <p class="section-subtitle">
+        Everything you need for AI-assisted development — from a single terminal.
+      </p>
+      <div class="feature-grid">
+        <div class="feature-card">
+          <h3>Multi-Provider Routing</h3>
+          <p>Switch between Anthropic, OpenAI, Google Gemini, DeepSeek, OpenRouter, Ollama, xAI, Mistral, Groq, Cohere, Copilot, KiloCode, and OpenAI-compatible endpoints at runtime.</p>
+          <span class="feature-tag">/model</span>
+          <span class="feature-tag">/provider</span>
+        </div>
+        <div class="feature-card">
+          <h3>65+ Built-in Tools</h3>
+          <p>Read, Edit, Write, Glob, Grep, Bash, Web Search, Research, MCP, LSP, Agent, Task, Monitor, and Workflow tools.</p>
+          <span class="feature-tag">/tools</span>
+        </div>
+        <div class="feature-card">
+          <h3>Plugin System</h3>
+          <p>Extend with commands, agents, skills, hooks, and <a href="mcp.html">MCP servers</a>. Pre/post tool hooks for custom automation.</p>
+          <span class="feature-tag">/plugin</span>
+          <span class="feature-tag">/skill</span>
+        </div>
+        <div class="feature-card">
+          <h3>Agent View</h3>
+          <p>Multi-session dashboard with supervisor daemon, background tasks, IPC communication, worktree isolation, PR column display, dispatch autocomplete, and keyboard shortcuts.</p>
+          <span class="feature-tag">/agents</span>
+        </div>
+        <div class="feature-card">
+          <h3>Background Shell</h3>
+          <p>Run long-lived commands as persistent background agent tasks with <code>!bg &lt;command&gt;</code>. Live status, exit codes, stderr capture, and full dashboard integration.</p>
+          <span class="feature-tag">!bg</span>
+        </div>
+        <div class="feature-card">
+          <a href="daemon.html" style="color:inherit;text-decoration:none"><h3>24/7 Autonomous Mode</h3>
+          <p>Persistent daemon with task queue, auto-scheduling, health checks, auto-respawn, and worker session orchestration.</p></a>
+          <span class="feature-tag">/daemon</span>
+          <span class="feature-tag">/task</span>
+        </div>
+        <div class="feature-card">
+          <a href="research-memory.html" style="color:inherit;text-decoration:none"><h3>Smart Memory</h3>
+          <p>Cross-lingual semantic search, hybrid recall (local + LLM), auto-memory capture, and team sync.</p></a>
+          <span class="feature-tag">/memory</span>
+        </div>
+        <div class="feature-card">
+          <h3>Bridge Mode</h3>
+          <p>WebSocket remote collaboration with session sharing, team onboarding, and mobile/web clients.</p>
+          <span class="feature-tag">Bridge</span>
+        </div>
+        <div class="feature-card">
+          <h3>KiloCompact</h3>
+          <p>Local context compaction: log/trace snipping, failed-state consolidation, semantic turn pruning.</p>
+          <span class="feature-tag">/compact</span>
+        </div>
+        <div class="feature-card">
+          <h3>Permission Modes</h3>
+          <p>Default, Auto, Plan, YOLO Lite, YOLO, YOLO MAX — granular control over tool execution safety.</p>
+          <span class="feature-tag">/permissions</span>
+        </div>
+        <div class="feature-card">
+          <h3>Preference Learning</h3>
+          <p>Local-first taste system that learns your coding style from accept/reject/edit signals. Interactive menu, edit validation, config live-reload, and prompt injection.</p>
+          <span class="feature-tag">/taste</span>
+        </div>
+      </div>
+      <!-- ─── Usage ─── -->
+      <h2 class="section-title" id="usage">Quick Start</h2>
+      <p class="section-subtitle">From zero to coding in under a minute.</p>
+      <div class="code-block-wrap">
+        <div class="code-block-header">
+          <span>bash</span>
+        </div>
+        <pre><code><span class="cmd-muted">$</span> <span class="cmd-primary">npm install -g clew-code</span>
+<span class="cmd-muted">$</span> <span class="cmd-primary">export ANTHROPIC_API_KEY=sk-ant-...</span>
+<span class="cmd-muted">$</span> <span class="cmd-primary">clew</span>
+<span class="cmd-muted"># Ask a question</span>
+<span class="cmd-muted">></span> <span class="cmd-primary">"find all unused exports in src/"</span>
+<span class="cmd-muted"># Switch model on the fly</span>
+<span class="cmd-muted">></span> <span class="cmd-primary">/model deepseek-v4-flash</span>
+<span class="cmd-muted"># Context management</span>
+<span class="cmd-muted">></span> <span class="cmd-primary">/clear</span>    <span class="cmd-muted"># Fresh start</span>
+<span class="cmd-muted">></span> <span class="cmd-primary">/compact</span> <span class="cmd-muted"># Compress context</span>
+<span class="cmd-muted">></span> <span class="cmd-primary">/resume</span>  <span class="cmd-muted"># Resume last session</span></code></pre>
+      </div>
+      <!-- ─── Slash Commands ─── -->
+      <h2 class="section-title" id="commands">Slash Commands</h2>
+      <p class="section-subtitle">80+ commands to control every aspect of your workflow.</p>
+      <table>
+        <thead>
+          <tr><th>Category</th><th>Commands</th><th>Description</th></tr>
+        </thead>
+        <tbody>
+          <tr><td><span class="cmd-accent">Files</span></td><td><code>/read</code> <code>/edit</code> <code>/write</code> <code>/glob</code> <code>/grep</code></td><td>Read, edit, create, and search files</td></tr>
+          <tr><td><span class="cmd-accent">Git</span></td><td><code>/diff</code> <code>/commit</code> <code>/branch</code></td><td>Version control operations</td></tr>
+          <tr><td><span class="cmd-accent">Model</span></td><td><code>/model</code> <code>/provider</code> <code>/cost</code> <code>/usage</code> <code>/stats</code></td><td>Switch models and track usage</td></tr>
+          <tr><td><span class="cmd-accent">Session</span></td><td><code>/clear</code> <code>/compact</code> <code>/resume</code> <code>/session</code> <code>/rewind</code></td><td>Context and session management</td></tr>
+          <tr><td><span class="cmd-accent">Config</span></td><td><code>/permissions</code> <code>/plan</code> <code>/config</code> <code>/theme</code></td><td>Settings and preferences</td></tr>
+          <tr><td><span class="cmd-accent">Extend</span></td><td><code>/plugin</code> <code>/skill</code> <code>/agent</code> <code>/agents</code> <code>/mcp</code></td><td>Plugins, skills, agents, MCP</td></tr>
+          <tr><td><span class="cmd-accent">Daemon</span></td><td><code>/daemon</code> <code>/task</code> <code>/loop</code></td><td>24/7 autonomous agent, task queue, and recurring tasks</td></tr>
+          <tr><td><span class="cmd-accent">Automation</span></td><td><code>/autofix-pr</code></td><td>Fix CI errors and review comments on a PR via Clew on the web</td></tr>
+          <tr><td><span class="cmd-accent">System</span></td><td><code>/help</code> <code>/status</code> <code>/doctor</code> <code>/exit</code></td><td>Help, diagnostics, and exit</td></tr>
+        </tbody>
+      </table>
+      <!-- ─── Providers ─── -->
+      <h2 class="section-title" id="providers">AI Providers</h2>
+      <p class="section-subtitle">Bring your own key — use the model that works best for each task.</p>
+      <table>
+        <thead>
+          <tr><th>Provider</th><th>Config</th><th>Models</th></tr>
+        </thead>
+        <tbody>
+          <tr><td><span class="cmd-info">Anthropic</span></td><td><code>ANTHROPIC_API_KEY</code></td><td>claude-opus-4-7, claude-sonnet-4-6</td></tr>
+          <tr><td><span class="cmd-info">OpenAI</span></td><td><code>OPENAI_API_KEY</code></td><td>gpt-5.5, gpt-5.4-mini</td></tr>
+          <tr><td><span class="cmd-info">Google</span></td><td><code>GOOGLE_API_KEY</code></td><td>gemini-3.1-pro, gemini-3.1-flash</td></tr>
+          <tr><td><span class="cmd-info">DeepSeek</span></td><td><code>DEEPSEEK_API_KEY</code></td><td>deepseek-v4-pro, deepseek-v4-flash</td></tr>
+          <tr><td><span class="cmd-info">OpenRouter</span></td><td><code>OPENROUTER_API_KEY</code></td><td>100+ models via routed API</td></tr>
+          <tr><td><span class="cmd-info">Ollama</span></td><td><code>OLLAMA_HOST</code></td><td>llama3.3, llama4:70b, qwen3.6</td></tr>
+          <tr><td><span class="cmd-info">xAI</span></td><td><code>XAI_API_KEY</code></td><td>grok-4.3</td></tr>
+          <tr><td><span class="cmd-info">Mistral</span></td><td><code>MISTRAL_API_KEY</code></td><td>mistral-large-3, mistral-small-4</td></tr>
+          <tr><td><span class="cmd-info">Groq</span></td><td><code>GROQ_API_KEY</code></td><td>llama-3.3-70b, deepseek-v4</td></tr>
+          <tr><td><span class="cmd-info">Cohere</span></td><td><code>COHERE_API_KEY</code></td><td>command-a-plus</td></tr>
+          <tr><td><span class="cmd-info">Copilot</span></td><td><code>COPILOT_GITHUB_TOKEN</code></td><td>claude, GPT models</td></tr>
+          <tr><td><span class="cmd-info">KiloCode</span></td><td><code>KILOCODE_API_KEY</code></td><td>kilo-auto/free, kilo-auto/balanced</td></tr>
+        </tbody>
+      </table>
+      <!-- ─── Plugins ─── -->
+      <h2 class="section-title" id="plugins">Plugins &amp; Skills</h2>
+      <p class="section-subtitle">Extend functionality with built-in and marketplace plugins.</p>
+      <table>
+        <thead>
+          <tr><th>Plugin</th><th>Description</th></tr>
+        </thead>
+        <tbody>
+          <tr><td><code>commit-commands</code></td><td>Git workflow: commit, push, PR creation</td></tr>
+          <tr><td><code>code-review</code></td><td>Automated PR code review</td></tr>
+          <tr><td><code>feature-dev</code></td><td>Guided feature development with agents</td></tr>
+          <tr><td><code>frontend-design</code></td><td>Production-grade UI/UX generation</td></tr>
+          <tr><td><code>verify</code></td><td>Typecheck, lint, build, and test</td></tr>
+          <tr><td><code>debug</code></td><td>Debugging assistance</td></tr>
+          <tr><td><code>commit</code></td><td>Conventional git commits</td></tr>
+          <tr><td><code>simplify</code></td><td>Code quality and reuse review</td></tr>
+          <tr><td><code>web-search</code></td><td>Multi-provider web search</td></tr>
+          <tr><td><code>scrapling</code></td><td>Web scraping with Scrapling</td></tr>
+          <tr><td><code>skillify</code></td><td>Create skills from workflows</td></tr>
+          <tr><td><code>remember</code></td><td>Save user preferences</td></tr>
+        </tbody>
+      </table>
+      <!-- ─── Changelog ─── -->
+      <h2 class="section-title" id="updates">v0.2.1 Updates</h2>
+      <ul>
+        <li><strong>Taste system</strong> — Local-first preference-learning runtime. Interactive <code>/taste</code> menu with Spinner loading, edit validation in permission dialogs, status line in footer, config live-reload, and prompt injection with <code>&lt;clew_taste&gt;</code> block.</li>
+        <li><strong>Model picker grouped by provider</strong> — <code>/model</code> now shows all models from all providers in separate named sections instead of only the active provider's models.</li>
+        <li><strong>Provider auto-persist</strong> — Last-used provider+model saved to <code>provider.json</code> without <code>--global</code>.</li>
+        <li><strong>Security hardening</strong> — PowerShell prefix/wildcard rules, malformed tool call guard, bash 100MB output limit, Guardian auto-review with circuit breaker.</li>
+        <li><strong>Bridge v2</strong> — Provider-agnostic WebSocket remote control, relay client, REPL bridging.</li>
+        <li><strong>PR commands</strong> — <code>/pr create</code>, <code>list</code>, <code>view</code>, <code>review</code>, <code>merge</code>, <code>status</code>.</li>
+      </ul>
+      <div style="margin-top:var(--space-lg)">
+        <a href="https://github.com/JonusNattapong/ClewCode/blob/main/CHANGELOG.md" class="btn btn-ghost">Full Changelog →</a>
+      </div>
+      <!-- ─── Footer ─── -->
+      <footer class="footer">
+        <span>Clew v0.2.1 — Open Source</span>
+        <div class="footer-links">
+          <a href="https://github.com/JonusNattapong/ClewCode">GitHub</a>
+          <a href="https://github.com/JonusNattapong/ClewCode/issues">Issues</a>
+          <a href="https://npmjs.com/package/clew-code">npm</a>
+        </div>
+      </footer>
+    </main>
+    <!-- ─── Right TOC ─── -->
+    <nav class="toc-sidebar"></nav>
+  </div>
+</div>
+<script src="js/main.js"></script>
+</body>
+</html>

package/docs/installation.html ADDED Viewed

@@ -0,0 +1,102 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Installation — Clew</title>
+  <meta name="description" content="Install Clew via npm, run from source, or use the prebuilt binary.">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <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"><div class="header-inner"><a href="index.html" class="logo"><span>Clew</span></a><nav class="header-nav"><a href="index.html">Home</a><a href="index.html#features">Features</a><a href="index.html#commands">Commands</a><a href="quick-start.html" class="active">Docs</a><a href="https://github.com/JonusNattapong/ClewCode" target="_blank">GitHub</a></nav><button class="menu-btn" id="menuToggle" aria-label="Toggle navigation"><span></span><span></span><span></span></button></div></header>
+<div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
+<div class="content-wrap"><main class="content">
+  <div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Installation</span></div>
+  <h1>Installation</h1>
+  <p class="section-subtitle">Clew runs on Windows, macOS, Linux, and WSL2. Runtime: Bun 1.3+.</p>
+  <h2>Prerequisites</h2>
+  <ul>
+    <li><strong>Bun 1.3+</strong> — required runtime for both global installs and source builds</li>
+    <li>At least one AI provider API key</li>
+  </ul>
+  <h2>Via npm (global)</h2>
+  <pre><code>npm install -g clew-code
+clew
+# Verify
+clew --version</code></pre>
+  <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>
+  <h2>Via Bun (global)</h2>
+  <pre><code>bun install -g clew-code
+clew</code></pre>
+  <h2>From Source</h2>
+  <pre><code>git clone https://github.com/JonusNattapong/ClewCode.git
+cd ClewCode
+bun install
+bun run build
+bun run start
+# Development mode with watch
+bun run dev</code></pre>
+  <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>
+  <h2>Platform-Specific Notes</h2>
+  <h3>Windows</h3>
+  <ul>
+    <li>Both cmd and PowerShell supported as shell targets</li>
+    <li>ripgrep bundled at <code>src/utils/vendor/ripgrep/x64-win32/rg.exe</code></li>
+    <li>WSL2 recommended for best experience</li>
+    <li>Windows argv normalization in <code>src/entry.ts</code></li>
+    <li>TTY polyfill for Ink compatibility in <code>src/main.tsx</code></li>
+  </ul>
+  <h3>macOS</h3>
+  <ul>
+    <li>Native support with menu bar app integration (moltbot)</li>
+    <li>Voice Wake and Talk Mode overlays</li>
+    <li>Keychain prefetch for faster OAuth startup</li>
+    <li>WebChat and debug tools available</li>
+  </ul>
+  <h3>Linux</h3>
+  <ul>
+    <li>Full support via terminal</li>
+    <li>Tailscale Serve/Funnel for remote gateway access</li>
+  </ul>
+  <h2>Release Channels</h2>
+  <table>
+    <tr><th>Channel</th><th>npm Tag</th><th>Description</th></tr>
+    <tr><td>stable</td><td><code>latest</code></td><td>Tagged releases (vYYYY.M.D)</td></tr>
+    <tr><td>beta</td><td><code>beta</code></td><td>Prereleases (vYYYY.M.D-beta.N)</td></tr>
+    <tr><td>dev</td><td><code>dev</code></td><td>Moving main branch</td></tr>
+  </table>
+  <h2>Verifying Installation</h2>
+  <pre><code>/doctor     # Run environment diagnostics
+/status     # Check version, model, account, API connectivity</code></pre>
+  <footer class="footer">
+    <span>Clew v0.1.2 — Open Source</span>
+    <div class="footer-links">
+      <a href="https://github.com/JonusNattapong/ClewCode">GitHub</a>
+      <a href="https://github.com/JonusNattapong/ClewCode/issues">Issues</a>
+      <a href="https://npmjs.com/package/clew-code">npm</a>
+    </div>
+  </footer>
+</main>
+<nav class="toc-sidebar"></nav>
+</div>
+</div>
+<script src="js/main.js"></script>
+</body>
+</html>