clew-code 0.2.1

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

@@ -0,0 +1,278 @@
+# 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

@@ -0,0 +1,90 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>GrowthBook A/B Testing — Clew</title>
+  <meta name="description" content="GrowthBook A/B testing system for feature flags, experiments, and gradual rollouts in Clew.">
+  <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">Internals</a><span class="sep">/</span><span>A/B Testing</span></div>
+  <h1>GrowthBook A/B Testing</h1>
+  <p class="section-subtitle">Feature flagging and experiment management using GrowthBook for gradual rollouts, A/B tests, and targeted feature releases.</p>
+
+  <div class="callout callout-warn">
+    <strong>Internal Infrastructure</strong>
+    GrowthBook integration is used for Clew's own product development telemetry and experiment tracking. It is not a user-facing feature — this documentation is for contributors and integrators.
+  </div>
+
+  <h2>Overview</h2>
+  <p>GrowthBook provides feature flagging and A/B testing within Clew. It enables controlled rollouts of new features, experiment tracking, and targeted feature releases based on user segments. The SDK is initialized at startup and evaluates flags locally with caching for minimal latency.</p>
+
+  <h2>Architecture</h2>
+  <ul>
+    <li><strong>Feature Flags</strong> — Boolean, string, number, and JSON flag types evaluated locally</li>
+    <li><strong>Experiments</strong> — Multi-variant A/B tests with statistical tracking and automatic analysis</li>
+    <li><strong>Forced Variations</strong> — Override flag values for testing and debugging</li>
+    <li><strong>Sticky Bucketing</strong> — Consistent user experience across sessions based on stable identifiers</li>
+    <li><strong>Local Caching</strong> — Feature definitions cached after initial fetch for offline resilience</li>
+  </ul>
+
+  <h2>Usage in Code</h2>
+  <pre><code>// Check if a feature is enabled (cached evaluation)
+const isEnabled = getFeatureValue_CACHED_MAY_BE_STALE(
+  'tengu_plum_vx3',  // Feature key
+  false              // Default value
+);
+// Use the feature value
+if (isEnabled) {
+  // New behavior path
+} else {
+  // Control behavior path
+}</code></pre>
+
+  <h2>Configuration</h2>
+  <table>
+    <tr><th>Variable</th><th>Purpose</th></tr>
+    <tr><td><code>GROWTHBOOK_API_HOST</code></td><td>GrowthBook API endpoint (self-hosted or cloud)</td></tr>
+    <tr><td><code>GROWTHBOOK_CLIENT_KEY</code></td><td>Client-side SDK key for feature flag access</td></tr>
+    <tr><td><code>GROWTHBOOK_FORCE_VARIATION</code></td><td>Force a specific variation for testing</td></tr>
+  </table>
+
+  <h2>How It Works</h2>
+  <ol>
+    <li>On startup, Clew initializes the GrowthBook SDK with the configured API host and client key</li>
+    <li>Feature definitions are fetched from the GrowthBook server and cached locally</li>
+    <li>Throughout the session, code checks feature flags using the cached evaluation function</li>
+    <li>Flag values are re-evaluated periodically or on explicit refresh</li>
+    <li>Experiment results are tracked and sent back to GrowthBook for statistical analysis</li>
+    <li>Forced variations can override normal bucket assignment for testing</li>
+  </ol>
+
+  <h2>Best Practices</h2>
+  <ul>
+    <li>Always provide a sensible default value (usually <code>false</code> for features not yet released)</li>
+    <li>Use descriptive, unique feature keys</li>
+    <li>Cache-aware design: do not rely on flag values being real-time; they are evaluated at session start</li>
+    <li>Clean up stale flags after experiments conclude</li>
+  </ul>
+
+  <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>
+    </div>
+  </footer>
+</main>
+<nav class="toc-sidebar"></nav>
+</div>
+</div>
+<script src="../js/main.js"></script>
+</body>
+</html>

package/docs/internals/hidden-features.html

@@ -0,0 +1,126 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Hidden Features & Internals — Clew</title>
+  <meta name="description" content="Feature-gated commands, internal-only tools, and beta flags in Clew.">
+  <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">Internals</a><span class="sep">/</span><span>Hidden Features</span></div>
+      <h1>Hidden Features &amp; Internals</h1>
+      <p class="section-subtitle">Feature-gated commands, internal-only tools, and beta flags — not visible in the standard help menu.</p>
+
+      <div class="callout callout-warn">
+        <strong>Internal / Beta</strong>
+        These features may change without notice. Most require specific environment variables or build-time feature flags.
+      </div>
+
+      <h2>Feature-Gated Commands</h2>
+      <p>From <code>src/commands.ts</code> — enabled via environment variables:</p>
+      <table>
+        <tr><th>Command</th><th>Env Variable</th><th>Description</th></tr>
+        <tr><td><code>/bridge</code></td><td><code>BRIDGE_MODE=1</code></td><td>WebSocket remote control and collaboration</td></tr>
+        <tr><td><code>/voice</code></td><td><code>VOICE_MODE=1</code></td><td>Toggle voice mode</td></tr>
+        <tr><td><code>/brief</code></td><td><code>KAIROS=1</code></td><td>Brief command for quick context</td></tr>
+        <tr><td><code>/assistant</code></td><td><code>KAIROS=1</code></td><td>Assistant mode with proactive behavior</td></tr>
+      </table>
+
+      <h2>Internal-Only Commands</h2>
+      <p>Defined in <code>INTERNAL_ONLY_COMMANDS</code> in <code>src/commands.ts</code>:</p>
+      <table>
+        <tr><th>Command</th><th>Description</th></tr>
+        <tr><td><code>/backfill-sessions</code></td><td>Backfill session data</td></tr>
+        <tr><td><code>/break-cache</code></td><td>Break internal caches</td></tr>
+        <tr><td><code>/bughunter</code></td><td>Automated bug hunting workflow</td></tr>
+        <tr><td><code>/commit-push-pr</code></td><td>Commit, push, and PR creation</td></tr>
+        <tr><td><code>/ctx-viz</code></td><td>Context visualization</td></tr>
+        <tr><td><code>/init-verifiers</code></td><td>Initialize verifiers</td></tr>
+        <tr><td><code>/issue</code></td><td>Issue management</td></tr>
+        <tr><td><code>/mock-limits</code></td><td>Mock usage limits for testing</td></tr>
+        <tr><td><code>/reset-limits</code></td><td>Reset usage limits</td></tr>
+        <tr><td><code>/ultraplan</code></td><td>Extended plan mode</td></tr>
+        <tr><td><code>/version</code></td><td>Show version</td></tr>
+        <tr><td><code>/bridge-kick</code></td><td>Bridge session management</td></tr>
+        <tr><td><code>/onboarding</code></td><td>Interactive onboarding wizard</td></tr>
+        <tr><td><code>/team-onboarding</code></td><td>Generate teammate ramp-up guide</td></tr>
+        <tr><td><code>/share</code></td><td>Share session</td></tr>
+        <tr><td><code>/summary</code></td><td>Summarize conversation</td></tr>
+        <tr><td><code>/teleport</code></td><td>Teleport session</td></tr>
+        <tr><td><code>/ant-trace</code></td><td>Anthropic-internal tracing</td></tr>
+        <tr><td><code>/perf-issue</code></td><td>Performance issue reporting</td></tr>
+        <tr><td><code>/env</code></td><td>Environment inspection</td></tr>
+        <tr><td><code>/oauth-refresh</code></td><td>OAuth token refresh</td></tr>
+        <tr><td><code>/debug-tool-call</code></td><td>Tool call debugging</td></tr>
+        <tr><td><code>/autofix-pr</code></td><td>Autofix PR workflow</td></tr>
+      </table>
+
+      <h2>Feature-Gated Tools</h2>
+      <table>
+        <tr><th>Tool</th><th>Flag / Feature</th></tr>
+        <tr><td><code>LSPTool</code></td><td><code>ENABLE_LSP_TOOL=1</code></td></tr>
+        <tr><td><code>ComputerUseTool</code></td><td><code>ENABLE_COMPUTER_USE=1</code> (Windows)</td></tr>
+        <tr><td><code>CodeIndexTool</code></td><td><code>CODE_INDEX</code> feature flag</td></tr>
+        <tr><td><code>EnterWorktreeTool / ExitWorktreeTool</code></td><td>Worktree mode enabled</td></tr>
+        <tr><td><code>PowerShellTool</code></td><td>PowerShell tool enabled in settings</td></tr>
+        <tr><td><code>CronCreateTool / CronDeleteTool / CronListTool</code></td><td><code>AGENT_TRIGGERS</code> feature</td></tr>
+        <tr><td><code>PushNotificationTool</code></td><td><code>KAIROS</code> feature</td></tr>
+        <tr><td><code>REPLTool</code></td><td><code>USER_TYPE=ant</code></td></tr>
+        <tr><td><code>ConfigTool / TungstenTool</code></td><td><code>USER_TYPE=ant</code></td></tr>
+      </table>
+
+      <h2>Build-Time Feature Flags</h2>
+      <ul>
+        <li><code>TRANSCRIPT_CLASSIFIER</code> — Enables auto permission mode with transcript-based classification</li>
+        <li><code>CHICAGO_MCP</code> — Enables Chicago MCP protocol features</li>
+      </ul>
+
+      <h2>Runtime Feature Detection</h2>
+      <p>Features are checked via <code>feature('FEATURE_NAME')</code> (compile-time) and <code>isEnvTruthy()</code> (runtime):</p>
+      <ul>
+        <li><code>PROACTIVE</code> / <code>KAIROS</code> — Proactive agent behavior</li>
+        <li><code>AGENT_TRIGGERS</code> — Scheduled and remote agent triggers</li>
+        <li><code>KAIROS_GITHUB_WEBHOOKS</code> — GitHub webhook subscriptions</li>
+        <li><code>KAIROS_PUSH_NOTIFICATION</code> — Push notification support</li>
+        <li><code>CONTEXT_COLLAPSE</code> — Context collapse inspection</li>
+        <li><code>MCP_SKILLS</code> — MCP-provided skills</li>
+        <li><code>CODE_INDEX</code> — Code indexing and search</li>
+        <li><code>COORDINATOR_MODE</code> — Multi-agent coordinator mode</li>
+      </ul>
+
+      <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>
+        </div>
+      </footer>
+    </main>
+    <nav class="toc-sidebar"></nav>
+  </div>
+</div>
+<script src="../js/main.js"></script>
+</body>
+</html>