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/index.html DELETED Viewed

@@ -1,182 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Clew Code — Multi-Provider AI Coding Agent</title>
-<meta name="description" content="The open-source AI coding agent with 27 providers, LAN peer coordination, autonomous agent loop, MCP integration, and 50+ built-in tools.">
-<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">
-<section class="hero">
-  <div class="badge"><span class="dot"></span> v0.2.22 — Multi-Provider AI Coding Agent</div>
-  <h1>Code with <span class="hl">any</span> AI.</h1>
-  <p>Clew Code is an open-source AI coding agent that runs in your terminal,
-  coordinates across machines on your LAN, and works with 27 different
-  AI providers — no lock-in.</p>
-  <div class="hero-actions">
-    <a href="quick-start.html" class="btn btn-p">Get Started →</a>
-    <a href="installation.html" class="btn btn-ghost">Installation</a>
-    <a href="https://github.com/ClewCode/ClewCode" class="btn btn-ghost" target="_blank">GitHub</a>
-  </div>
-</section>
-<div class="term">
-  <div class="term-bar">
-    <span class="term-dot"></span><span class="term-dot"></span><span class="term-dot"></span>
-    <span class="term-title">clew</span>
-  </div>
-  <div class="term-body"><span class="p">❯</span> clew
-<span class="d">│  Starting Clew Code v0.2.22 …</span>
-<span class="d">│  Select a provider:</span>
-<span class="h">│  ● Anthropic</span>
-<span class="h">│  ● OpenAI</span>
-    ○ Google Gemini
-    ○ DeepSeek
-    ○ Ollama (local)
-      …
-<span class="p">❯</span> /model deepseek-v4-flash
-<span class="p">❯</span> /peer discover
-<span class="d">│  Found 2 peers on LAN</span>
-<span class="p">❯</span> write a web scraper in Go<span class="term-cursor"></span></div>
-</div>
-<div class="stats">
-  <div class="stat"><div class="stat-num">27</div><div class="stat-lbl">Providers</div></div>
-  <div class="stat"><div class="stat-num">50+</div><div class="stat-lbl">Built-in Tools</div></div>
-  <div class="stat"><div class="stat-num">15</div><div class="stat-lbl">Peer Tools</div></div>
-  <div class="stat"><div class="stat-num">7</div><div class="stat-lbl">Permission Modes</div></div>
-</div>
-<h2 id="features">Features</h2>
-<div class="grid">
-  <div class="card">
-    <h3><span class="card-icon">🤖</span>27 Providers</h3>
-    <p>Anthropic, OpenAI, Google Gemini, DeepSeek, Groq, Mistral, Ollama, OpenRouter, and 19 more. Switch mid-session with <code>/model</code>.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🌐</span>LAN Peer</h3>
-    <p>Discover peers, assign tasks, execute remote commands, and coordinate across machines via UDP multicast or file registry.</p>
-    <span class="tag">15 tools</span>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🔄</span>Autonomous Loop</h3>
-    <p>Persistent task queue, lease-based concurrency, exponential-backoff retry, dead-letter management, and cron scheduling.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🔌</span>MCP Integration</h3>
-    <p>Model Context Protocol via stdio, SSE with OAuth, or DirectConnect for in-process plugin servers.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🛠️</span>50+ Built-in Tools</h3>
-    <p>Read, Write, Edit, Bash, WebSearch, WebFetch, Browser (Playwright), PR, NotebookEdit, JsonPath, and more.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">⚡</span>3 Execution Layers</h3>
-    <p>Subagents (one-shot), Swarm/Teammates (long-running), Process Peer (Codex via exec/pty).</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🧩</span>Skills &amp; Plugins</h3>
-    <p>Extend via SKILL.md, plugin manifests with lifecycle hooks at every stage (PreToolUse, PostBash, and more).</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🔒</span>7 Permission Modes</h3>
-    <p>Default, ask, plan, auto, acceptEdits, bypassPermissions, dontAsk — with granular allow/deny rule patterns.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">📋</span>Plan Mode</h3>
-    <p>Full-access planning with bypass permissions. Explore, read, write, and edit freely. Plans persist with progress snapshots.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🧠</span>Memory System</h3>
-    <p>Persistent auto-memory, topic indexing, session digests with weekly/monthly consolidation — like human memory decay.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🌐</span>Web UI &amp; Remote</h3>
-    <p>Local WebSocket server with one-time auth tokens, optional NAT-traversal relay, and session management.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🎨</span>Image &amp; Video Generation</h3>
-    <p>AI-callable tools for DALL-E 3, Imagen 3, OpenRouter image models, and Runway Gen-4. Auto-discovers models from provider APIs.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">📦</span>Multi-Pass Compaction</h3>
-    <p>Automatic chunk-based context compression with recursive re-compaction when context exceeds the model window.</p>
-  </div>
-</div>
-<h2 id="quick-start">Quick Start</h2>
-<div class="code-block-wrap">
-  <div class="code-block-header">
-    <span>bash</span>
-    <button class="copy-btn" onclick="navigator.clipboard.writeText(this.nextElementSibling.textContent);this.textContent='Copied';setTimeout(()=>this.textContent='Copy',1500)">Copy</button>
-  </div>
-  <pre><code class="language-bash">npm install -g clew-code
-cd my-project
-clew
-# Inside the REPL:
-# /model openai      # pick a provider
-# /help              # list all commands
-# /peer discover     # find peers on LAN</code></pre>
-</div>
-<h2 id="concepts">Core Concepts</h2>
-<p>Clew Code has several execution layers, each serving a different purpose:</p>
-<div class="grid">
-  <div class="card">
-    <h3><span class="card-icon">🎯</span>Agent</h3>
-    <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>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🧪</span>Subagent</h3>
-    <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>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🐝</span>Teammate / Swarm</h3>
-    <p>A longer-lived agent team member with identity, mailbox, task coordination, and optional pane/tmux execution.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">🌐</span>LAN Peer</h3>
-    <p>A network of Clew instances on the same machine or LAN. <code>/peer</code> discovers peers, sends messages, and assigns tasks.</p>
-  </div>
-  <div class="card">
-    <h3><span class="card-icon">⚙️</span>Process Peer</h3>
-    <p>Local process-backed worker. Delegates prompts to external CLIs like Codex using exec or pty modes.</p>
-  </div>
-  </div>
-</div>
-</div>
-<button class="back-to-top" id="backToTop" onclick="window.scrollTo({top:0,behavior:'smooth'})">↑</button>
-<script src="js/main.js"></script>
-<script>
-  // Back to top button
-  (function(){
-    var btn = document.getElementById('backToTop');
-    if (!btn) return;
-    window.addEventListener('scroll', function(){
-      if (window.scrollY > 400) {
-        btn.classList.add('visible');
-      } else {
-        btn.classList.remove('visible');
-      }
-    });
-  })();
-</script>
-</body>
-</html>

package/docs/installation.html DELETED Viewed

@@ -1,77 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Installation — Clew Code</title>
-<meta name="description" content="Install Clew Code via npm or build from source.">
-<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">Installation</span></div>
-<h1>Installation</h1>
-<h2 id="npm">Install via npm</h2>
-<pre><code class="language-bash">npm install -g clew-code
-# Verify installation
-clew --version
-</code></pre>
-<h2 id="build">Build from Source</h2>
-<pre><code class="language-bash">git clone https://github.com/ClewCode/ClewCode.git
-cd ClewCode
-bun install
-bun run build
-bun run start
-</code></pre>
-<h2 id="requirements">Requirements</h2>
-<table>
-  <thead>
-    <tr><th>Dependency</th><th>Minimum Version</th></tr>
-  </thead>
-  <tbody>
-    <tr><td>Bun</td><td>1.3+</td></tr>
-    <tr><td>Node.js</td><td>18+</td></tr>
-    <tr><td>Git</td><td>Any modern version</td></tr>
-    <tr><td>Provider API key</td><td>At least one (see <a href="providers.html">providers</a>)</td></tr>
-  </tbody>
-</table>
-<h2 id="platform">Platform Notes</h2>
-<h3>macOS</h3>
-<p>Works out of the box on both Apple Silicon and Intel Macs.</p>
-<h3>Linux</h3>
-<p>No special dependencies required.</p>
-<h3>Windows</h3>
-<p>Requires Git Bash, WSL, or PowerShell. Some features (e.g., ComputerUse) are Windows-only.</p>
-<pre><code class="language-powershell">Remove-Item -Recurse -Force node_modules
-bun install
-bun run dev
-</code></pre>
-<h2 id="verify">Verify Installation</h2>
-<pre><code class="language-bash">clew --version
-# Should print v0.2.22 or later
-</code></pre>
-</div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>

package/docs/internals/claude-ai-backend-dependencies.md DELETED Viewed

@@ -1,278 +0,0 @@
-# Systems That Depend on the claude.ai / Anthropic Backend
-Audit of the clewcode (claudecode) codebase: subsystems that hardcode the
-claude.ai OAuth / CCR (Claude Code Remote) backend and therefore **do not
-work when the user is signed in with a non-Anthropic provider** (OpenAI,
-Google, DeepSeek, OpenRouter, xAI, Mistral, Groq, Ollama, etc.).
-A subsystem is considered claude.ai-bound if it requires:
-- the `getClaudeAIOAuthTokens()` access token, **or**
-- the `isClaudeAISubscriber()` / `hasProfileScope()` account state, **or**
-- a direct HTTP call to a `claude.ai` / `api.claude.ai` / `cse_*` / `session_*`
-  endpoint, **or**
-- the `BRIDGE_MODE` build flag plus a GrowthBook gate.
-Everything else (core query loop, most tools, commands, agents, plugins,
-skills, memory) routes through `ProviderManager` and works with any
-configured provider.
----
-## 1. Authentication and account
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| OAuth login | `src/services/oauth/client.ts`, `src/commands/login/login.tsx`, `src/commands/logout/logout.tsx` | `claude auth login` opens a browser to `claude.ai/oauth/authorize`; tokens are stored against `oauthAccount` |
-| Auth core | `src/utils/auth.ts` | Exports `getClaudeAIOAuthTokens`, `isClaudeAISubscriber`, `hasProfileScope`, `getOauthAccountInfo` — all read from the claude.ai OAuth keychain |
-| API-key verification | `src/hooks/useApiKeyVerification.ts` | POSTs the key to `api.anthropic.com/v1/messages` to confirm it is live |
-**Provider-agnostic path available:** the LLM call itself routes through
-`ProviderManager`. Auth-only checks (do we have a key for provider X?) are
-the bound part; the actual generation is fine.
----
-## 2. Bridge / Remote Control (CCR)
-Two parallel systems:
-### 2a. Legacy CCR bridge (claude.ai-bound)
-~30 files in `src/bridge/` — the original Claude Code Remote, tied to
-claude.ai OAuth.
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| Bridge main loop | `src/bridge/bridgeMain.ts` | WebSocket dialer to `wss://…claude.ai`, spawns workers, requires OAuth token |
-| Entitlement gate | `src/bridge/bridgeEnabled.ts` | `feature('BRIDGE_MODE')` + `isClaudeAISubscriber()` + GrowthBook `tengu_ccr_bridge`; emits a specific error if any check fails |
-| Remote core | `src/bridge/remoteBridgeCore.ts`, `src/bridge/replBridge.ts`, `src/bridge/replBridgeHandle.ts`, `src/bridge/replBridgeTransport.ts` | Long-lived socket for forwarding events between local session and claude.ai |
-| API client | `src/bridge/bridgeApi.ts`, `src/bridge/codeSessionApi.ts`, `src/bridge/bridgeConfig.ts` | Hit `BASE_API_URL` (claude.ai) with bearer token; includes 403 suppression for bridge-specific errors |
-| Auth/secret handshake | `src/bridge/workSecret.ts`, `src/bridge/trustedDevice.ts`, `src/bridge/jwtUtils.ts` | Decode worker secrets signed by claude.ai; cache trusted device tokens |
-| Session spawning | `src/bridge/sessionRunner.ts`, `src/bridge/createSession.ts`, `src/bridge/types.ts` | Spawn sessions in claude.ai-hosted workers |
-| Session ID compat | `src/bridge/sessionIdCompat.ts` | `cse_*` ↔ `session_*` shim against the claude.ai frontend |
-| Init paths | `src/bridge/initReplBridge.ts`, `src/bridge/envLessBridgeConfig.ts`, `src/bridge/replBridge.ts` | v1 (env) and v2 (env-less) startup paths |
-| UI | `src/components/BridgeDialog.tsx`, `src/hooks/useReplBridge.tsx` | Renders the "share to claude.ai" affordance |
-| Command | `src/commands/bridge/bridge.tsx` | `/bridge` slash command |
-| SDK transports | `src/cli/transports/ccrClient.ts`, `WebSocketTransport.ts`, `SSETransport.ts`, `HybridTransport.ts`, `transportUtils.ts` | Wire format the headless SDK uses to talk to CCR |
-| Background remote | `src/utils/background/remote/preconditions.ts`, `src/utils/background/remote/remoteSession.ts` | Background reconnection, polling, alive checks |
-### 2b. Bridge v2 — provider-agnostic Remote Control (clewcode fork)
-New standalone system in `src/remote/` that works without claude.ai.
-Runs a local WebSocket server with one-time auth tokens, session
-management, and an optional relay for NAT traversal.
-| Subsystem | Key files | Description |
-| --- | --- | --- |
-| Server | `src/remote/RemoteServer.ts` | WebSocket server with HTTP health/metrics API |
-| Auth | `src/remote/tokenStore.ts` | SHA-256 hashed one-time token generation and validation |
-| Relay | `src/remote/RelayClient.ts` | Optional NAT-traversal relay mode |
-| Types | `src/remote/types.ts` | Shared types for the v2 protocol |
-| Command | `src/commands/remote/remote.ts`, `src/commands/remote/index.ts` | `/remote listen|connect|token` |
-| UI | `src/hooks/useRemoteBridge.tsx`, `src/components/RemoteServerStatus.tsx` | Session bridge hook + connection status component |
-| Tests | `src/remote/RemoteServer.test.ts` | 5 tests: health, auth, session lifecycle |
----
-## 3. MCP — claude.ai Connectors
-User-installed MCP servers (Gmail, Calendar, Notion, etc.) are
-provisioned through the claude.ai web UI and addressed by
-`/v1/mcp/connectors/...` on the claude.ai backend.
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| Connector client | `src/services/mcp/claudeai.ts` | Lists and connects MCP servers known to the user's claude.ai account |
-| Channel notifications | `src/services/mcp/channelNotification.ts` | Channel-based message routing via claude.ai |
-| Settings UI | `src/components/mcp/MCPSettings.tsx`, `src/components/mcp/MCPRemoteServerMenu.tsx` | Toggles claude.ai-managed servers |
-| Discovery/normalization | `src/services/mcp/normalize.ts`, `src/services/mcp/config.ts`, `src/services/mcp/client.ts`, `src/services/mcp/useManageMCPConnections.ts` | Treat the claude.ai connector list as one of the MCP sources |
-| Utility | `src/services/mcp/utils.ts` | Shared helpers; some paths assume OAuth token presence |
-**Provider-agnostic path available:** standard MCP servers configured
-locally in `~/.claude.json` or `.mcp.json` work fine. The bound part is
-the **claude.ai-hosted** connector directory.
----
-## 4. Claude-in-Chrome Extension
-The official browser-automation extension talks back to a claude.ai
-control plane for install telemetry, deep-link handoff, and an
-extension-managed MCP server.
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| Onboarding | `src/components/ClaudeInChromeOnboarding.tsx` | Wizard assumes claude.ai login |
-| Install command | `src/commands/chrome/chrome.tsx` | `claude chrome install` flow |
-| Portable setup | `src/utils/claudeInChrome/setupPortable.ts` | Bundles the extension |
-| MCP server | `src/utils/claudeInChrome/mcpServer.ts` | Exposes Chrome tools; tied to extension auth |
-| Notification hook | `src/hooks/useChromeExtensionNotification.tsx` | Surfaces extension events to the TUI |
----
-## 5. Teleport / Desktop Handoff
-Move a running session between machines via a claude.ai-mediated
-relay.
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| Teleport core | `src/utils/teleport.tsx`, `src/utils/teleport/api.ts`, `src/utils/teleport/gitBundle.ts`, `src/utils/teleport/environments.ts` | Encodes session state, POSTs to claude.ai, decodes on the other side |
-| Setup command | `src/commands/remote-setup/api.ts` | `/remote-setup` |
-| Env command | `src/commands/remote-env/index.ts` | `/remote-env` |
-| UI | `src/components/DesktopHandoff.tsx` | Pairing screen |
----
-## 6. Remote Agents / Tasks
-Spin work off to a claude.ai-hosted worker instead of running locally.
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| Task type | `src/tasks/RemoteAgentTask/RemoteAgentTask.tsx` | Lifecycle of a remote-task entry |
-| Tool | `src/tools/RemoteTriggerTool/RemoteTriggerTool.ts`, `src/tools/RemoteTriggerTool/prompt.ts` | LLM-callable tool to trigger a remote job |
-| Skill | `src/skills/bundled/scheduleRemoteAgents.ts` | Bundled skill for scheduled remote runs |
-| Spawning | `src/utils/swarm/spawnUtils.ts` | Worker spawn helper |
----
-## 7. Subscription, billing, and quotas
-Anything that displays "you have N requests left" or "upgrade to Pro" is
-talking to claude.ai's entitlements API.
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| Limits | `src/services/claudeAiLimits.ts` | Per-user, per-model rate-limit numbers |
-| Quota | `src/services/api/ultrareviewQuota.ts`, `src/commands/review/ultrareviewCommand.tsx` | Ultrareview credit balance |
-| Extra usage | `src/utils/extraUsage.ts` | Overage toggle state |
-| Billing | `src/utils/billing.ts` | Subscription tier, payment method display |
-| Rate-limit UI | `src/components/messages/RateLimitMessage.tsx`, `src/commands/rate-limit-options/index.ts` | Renders claude.ai-shaped limit messages |
-| Upgrade | `src/commands/upgrade/upgrade.tsx` | Links to claude.ai/upgrade |
-| Cost | `src/commands/cost/cost.ts`, `src/commands/cost/index.ts` | Pulls usage from claude.ai billing |
-| Switch-subscription hook | `src/hooks/notifs/useCanSwitchToExistingSubscription.tsx` | Tells the UI whether to show the "switch plan" banner |
----
-## 8. Settings / policy sync
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| User settings sync | `src/services/settingsSync/index.ts` | `theme`, `notifChannels`, etc. mirrored to claude.ai |
-| Managed settings | `src/services/remoteManagedSettings/index.ts`, `src/services/remoteManagedSettings/syncCache.ts` | Org admin policies (allowed tools, blocked commands) |
-| Team memory | `src/services/teamMemorySync/index.ts` | Shared memdir scoped to a workspace |
-| Policy limits | `src/services/policyLimits/index.ts` | Org-level rate caps |
----
-## 9. Voice input
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| STT streaming | `src/services/voiceStreamSTT.ts` | Streams audio to a claude.ai WebSocket for transcription |
-| Mode gate | `src/voice/voiceModeEnabled.ts`, `src/hooks/useVoiceEnabled.ts` | Checks subscription before exposing the mic button |
----
-## 10. Reviews and PR automations
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| Review (remote) | `src/commands/review/reviewRemote.ts` | Off-host review of a PR |
-| Ultrareview | `src/commands/review/ultrareviewCommand.tsx`, `src/services/api/ultrareviewQuota.ts` | Heavy async review job with quota |
-| Autofix PR | `src/commands/autofix-pr/autofixPr.ts` | Opens a remediation PR on a remote worker |
-| Git helpers | `src/utils/git.ts`, `src/utils/gitDiff.ts` | Some code paths push to claude.ai endpoints (PR preview, comment posting) |
----
-## 11. Fast mode / model capabilities
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| Fast mode | `src/utils/fastMode.ts` | "turbo" preference stored on claude.ai side |
-| 1M context gate | `src/utils/model/check1mAccess.ts` | Per-user entitlement check |
-| Capabilities | `src/utils/model/modelCapabilities.ts`, `src/utils/model/modelOptions.ts` | Some flags only resolve for claude.ai-issued tokens |
-| Beta flags | `src/utils/betas.ts` | Reads user's claude.ai beta opt-ins |
----
-## 12. Telemetry and analytics
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| BigQuery export | `src/utils/telemetry/bigqueryExporter.ts` | Forwards events to Anthropic's first-party tables |
-| First-party event log | `src/services/analytics/firstPartyEventLoggingExporter.ts` | Hardcoded endpoint |
-| Metrics opt-out | `src/services/api/metricsOptOut.ts` | Reads the per-user telemetry preference from claude.ai |
-| Referral | `src/services/api/referral.ts` | Referral credit API on claude.ai |
-| Auth check | `src/services/api/claude.ts`, `src/services/api/withRetry.ts`, `src/services/api/usage.ts`, `src/services/api/errors.ts`, `src/services/api/anthropicClient.ts`, `src/services/api/bootstrap.ts` | `getClaudeAIOAuthTokens()` callers |
-| API base | `src/constants/oauth.ts` | Defines `BASE_API_URL` (claude.ai) and OAuth client ID |
----
-## 13. Notices and supporting UI
-| Subsystem | Key files | Why it is bound |
-| --- | --- | --- |
-| Channels notice | `src/components/LogoV2/ChannelsNotice.tsx` | Subscription-channel cross-promo |
-| Status notices | `src/utils/statusNoticeDefinitions.tsx`, `src/utils/status.tsx` | Some notices render only for claude.ai subscribers |
-| Logo V2 utils | `src/utils/logoV2Utils.ts` | Feature flag for claude.ai-only logo |
-| `useApiKeyVerification` | `src/hooks/useApiKeyVerification.ts` | Verifies Anthropic API key shape |
----
-## Provider-agnostic systems (for contrast)
-These are the major surfaces that **do** work with any provider:
-- `src/query.ts`, `src/QueryEngine.ts` — message building, tool loop
-- `src/services/ai/ProviderManager.ts`, `src/services/ai/providerRegistry.ts`,
-  `src/services/ai/providers.json`, `src/services/ai/adapter/*` — provider
-  routing and adapters
-- `src/services/ai/contentBlockUtils.ts`, `toolCallParser.ts`,
-  `errorNormalizer.ts`, `usageNormalizer.ts` — cross-provider normalization
-- All built-in tools in `src/tools/` that do not call claude.ai
-  (Bash, FileEdit, FileRead, Grep, Glob, WebFetch, WebSearch via
-  provider-agnostic providers, ExitPlanMode, etc.)
-- `src/services/tools/`, `src/services/tools/StreamingToolExecutor.ts` —
-  tool execution pipeline
-- `src/commands/` slash commands that do not call bridge/MCP-connector
-  endpoints
-- `src/agentRuntime/`, `src/services/autonomous/`, `src/coordinator/` —
-  agent and task infrastructure
-- `src/plugins/`, `src/skills/` — plugin and skill systems
-- `src/memdir/`, `src/research/` — local memory and research
-- `src/services/Supervisor/`, `src/services/SessionLifecycle/`,
-  `src/services/SessionMemory/` — session and supervision
-- `src/services/lsp/` — language server integration
-- `src/voice/sherpa-onnx-tts`, local TTS paths
-- `src/upstreamproxy/`, `src/services/api/` pure HTTP helpers
-- `src/state/`, `src/screens/`, `src/components/` — generic TUI
----
-## Implications for the fork
-If the goal of the clewcode fork is to be a **truly multi-provider
-coding agent**, the following are the load-bearing claude.ai dependencies
-that need a strategy (stub, replace, or accept the limitation):
-1. **CCR bridge** (`src/bridge/`, `src/remote/`, `src/cli/transports/*`)
-   — by far the largest single bound surface. Either re-target at a
-   self-hosted relay or accept it as claude.ai-only.
-2. **MCP claude.ai connectors** (`src/services/mcp/claudeai.ts`,
-   related UI) — separate from local MCP, this is the user's claude.ai
-   connector directory.
-3. **OAuth login** (`src/services/oauth/client.ts`) — the entry point
-   to everything above. A non-Anthropic provider login leaves the entire
-   bound surface off-limits.
-4. **Subscription / billing / quota** displays — pure UI; trivial to
-   guard, but the data sources are claude.ai-only.
-5. **Claude-in-Chrome extension** — a bundled extension tightly coupled
-   to claude.ai auth.
-6. **Teleport, autofix PR, ultrareview, remote agents** — feature
-   groups that depend on CCR workers.
-Everything outside the list above should already work with the configured
-provider through `ProviderManager`.

package/docs/internals/growthbook-ab-testing.html DELETED Viewed

@@ -1,70 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>A/B Testing — Clew Code</title>
-<meta name="description" content="Feature flags and A/B testing with GrowthBook 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">A/B Testing</span></div>
-<h1>A/B Testing with GrowthBook</h1>
-<p class="sub">Feature flags and experimentation using GrowthBook.</p>
-<h2 id="overview">Overview</h2>
-<p>Clew Code integrates with <a href="https://www.growthbook.io/">GrowthBook</a> for feature flag management and A/B testing. This allows gradual rollout of new features, targeted experiments, and configuration-driven behavior changes.</p>
-<h2 id="architecture">Architecture</h2>
-<p>GrowthBook is integrated via the <code>@growthbook/growthbook</code> SDK. Feature flags are evaluated at runtime and can control:</p>
-<ul>
-  <li>UI component visibility</li>
-  <li>Behavioral variations (e.g., different prompt templates)</li>
-  <li>Provider selection defaults</li>
-  <li>Beta feature access</li>
-  <li>Experimental tool availability</li>
-</ul>
-<h2 id="configuration">Configuration</h2>
-<p>Set the GrowthBook API key in your environment:</p>
-<pre><code class="language-bash">export GROWTHBOOK_API_KEY=your-api-key
-</code></pre>
-<p>Or configure in <code>.clew/settings.json</code>:</p>
-<pre><code class="language-json">{
-  "growthbook": {
-    "apiKey": "your-api-key",
-    "attributes": {
-      "environment": "development"
-    }
-  }
-}
-</code></pre>
-<h2 id="current-flags">Current Feature Flags</h2>
-<table>
-  <thead>
-    <tr><th>Flag</th><th>Purpose</th></tr>
-  </thead>
-  <tbody>
-    <tr><td><code>BRIDGE_MODE</code></td><td>Enable/disable Bridge v1 (CCR) functionality</td></tr>
-    <tr><td><code>tengu_ccr_bridge</code></td><td>GrowthBook-gated CCR bridge access</td></tr>
-  </tbody>
-</table>
-</div>
-</div>
-<script src="../js/main.js"></script>
-</body>
-</html>