clew-code 0.2.1

package/LICENSE.md

@@ -0,0 +1,71 @@
+# License Notice
+
+## Nature of This Repository
+
+This repository contains an unofficial, reverse-engineered rebuild of Anthropic's Claude Code CLI. The code has been reconstructed and extended for research, local development, and self-hosted use.
+
+This repository is not an official Anthropic product. Anthropic has not authorized, endorsed, sponsored, or approved this project.
+
+The upstream Claude Code product is proprietary software owned by Anthropic PBC. Anthropic retains all rights in its original software, services, models, APIs, trademarks, and related materials.
+
+## No Claim to Anthropic IP
+
+The contributors to this repository do not claim ownership of Anthropic's original work.
+
+This repository does not grant any license to Anthropic's proprietary source code, binaries, models, hosted services, trademarks, trade dress, or other protected materials.
+
+Any use of Anthropic APIs, accounts, services, or names remains subject to Anthropic's applicable terms and policies.
+
+## Trademarks
+
+"Anthropic", "Claude", "Claude Code", and related marks are trademarks or registered trademarks of their respective owners.
+
+Any reference to those names in this repository is for identification and compatibility discussion only. This project must not be presented as an official Anthropic product, distribution, partner project, or supported implementation.
+
+## MIT License for Contributor Modifications
+
+Only original modifications, extensions, patches, documentation, tooling, and other contributions authored by this repository's contributors are licensed under the MIT License, to the extent the contributors have the legal right to license them.
+
+```
+MIT License
+
+Copyright (c) 2026 Claude Code contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of the contributor-authored modifications and original additions in this
+repository, to deal in those modifications without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of those modifications, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the contributor-authored modifications.
+
+THE CONTRIBUTOR-AUTHORED MODIFICATIONS ARE PROVIDED "AS IS", WITHOUT WARRANTY
+OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE CONTRIBUTOR-AUTHORED
+MODIFICATIONS OR THE USE OR OTHER DEALINGS IN THOSE MODIFICATIONS.
+```
+
+## Excluded Materials
+
+The MIT License above does not apply to any material owned by Anthropic or any third party, including proprietary source code, compiled binaries, service credentials, model access, API access, documentation copied from proprietary sources, trademarks, or other protected materials.
+
+## Distribution and Use
+
+You are responsible for evaluating whether you may clone, modify, redistribute, publish, deploy, or use this repository in your jurisdiction and under any applicable contract, platform policy, or third-party license.
+
+Public distribution, commercial use, hosted access, or packaging of this repository may carry legal risk if the repository contains or derives from proprietary material that you do not have permission to use.
+
+## Contributor Responsibility
+
+Contributors must only submit material they have the right to contribute and license.
+
+Do not submit proprietary code, leaked code, copied source, credentials, private keys, confidential documentation, or material that violates another party's rights.
+
+## No Legal Advice
+
+This notice is provided for repository documentation purposes only. It is not legal advice. Consult qualified counsel before relying on this repository for redistribution, commercial use, public hosting, or production deployment.

package/README.md

@@ -0,0 +1,356 @@
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/3447b2ee-d405-4c7f-8510-f881b969bf3d" alt="Clew" width="480" />
+</p>
+
+<p align="center">
+  <strong>Language:</strong>
+  <a href="README.md"><strong>English</strong></a> ·
+  <a href="readme/README.zh.md">中文 (简体)</a> ·
+  <a href="readme/README.th.md">ไทย</a>
+</p>
+
+# Clew 🪽
+
+Clew is an unofficial, research-oriented CLI for AI-assisted software development.
+
+It is a source-built reconstruction and extension project designed for local development, debugging, self-hosted workflows, and provider choice.
+
+This repository is not an official Anthropic product, distribution, partner project, or supported implementation.
+
+> **Disclaimer:** Anthropic, Claude, and Claude Code are trademarks of their respective owners. This project is not affiliated with, endorsed by, sponsored by, or approved by Anthropic PBC. Anthropic's official Claude Code product is proprietary software. Read [LICENSE.md](LICENSE.md) before using, modifying, redistributing, or deploying this repository.
+
+## What This Project Provides
+
+| Area                   | Description                                                                                                                    |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| Source-built CLI       | A Bun/TypeScript terminal application that can be built, tested, inspected, and modified locally.                              |
+| Multi-provider routing | Support for multiple AI providers through provider adapters and model selection commands.                                      |
+| Developer tooling      | Commands for context inspection, code review, simplification, research, plugins, MCP, LSP, sessions, and background workflows. |
+| Local extensibility    | Support for plugins, hooks, skills, custom tools, scheduled tasks, and project-level configuration.                            |
+| Research use           | A transparent codebase for studying AI coding agent architecture, terminal UX, provider routing, and tool execution.           |
+
+## Features
+
+Clew runs directly in your terminal. It can inspect and edit local codebases, execute shell commands with permissions, switch model providers, and coordinate longer-running agent workflows.
+
+Key features:
+
+* **Multi-provider AI routing** — Supports Anthropic, OpenAI, Google Gemini, OpenRouter, Ollama, GitHub Copilot, and OpenAI-compatible endpoints.
+* **Runtime model switching** — Switch models or providers during a session using `/model`.
+* **Tool-driven workflows** — Read, search, edit, and write files; execute shell commands; query LSPs; run MCP tools; and integrate browser automation.
+* **Plugin hooks** — Hook into prompts, shell execution, tool calls, message display, session start, and file editing actions.
+* **Dynamic skills** — Load bundled and project-level skills from `.claude/skills/`.
+* **Code review tools** — Use `/code-review --fix` to review changed code and apply fixes. Use `/simplify` for cleanup-focused review.
+* **Guardian auto-review** — `/guardian` routes permission requests to an LLM reviewer with circuit breaker.
+* **PR management** — `/pr create`, `list`, `view`, `review`, `merge`, `status`.
+* **Provider-agnostic Remote Control** — `/remote` for WebSocket-based CLI sharing without claude.ai.
+* **Model picker** — Choose global or session-only model defaults.
+* **Plugin marketplace support** — Includes support for `skipLfs` when downloading plugin sources.
+* **Local research workflow** — Use `/research <query>` for local-first web research and scraping workflows where configured.
+* **Agents and supervisor** — Manage background agents, multi-step workflows, summaries, task status, approvals, and session state.
+* **Background shell commands** — Run long-lived commands with `!bg <command>`.
+* **Scheduled tasks** — Create one-shot or recurring tasks through `/task`.
+* **Sessions and bridge mode** — Save, resume, and coordinate development sessions.
+
+## Quick Start
+
+### Install Globally
+
+```bash
+npm install -g clew-code
+```
+
+Or:
+
+```bash
+bun install -g clew-code
+```
+
+Run the CLI inside a project directory:
+
+```bash
+clew
+```
+
+> The global launcher requires Bun to be installed on your machine.
+
+### Run From Source
+
+```bash
+git clone https://github.com/JonusNattapong/ClewCode.git
+cd claudecode
+
+bun install
+bun run build
+bun run start
+```
+
+For development:
+
+```bash
+bun run dev
+```
+
+## System Requirements
+
+* Bun 1.3 or higher
+* Node.js 18 or higher
+* Git
+* Windows, macOS, Linux, or WSL2
+* At least one supported provider API key, unless using a local provider such as Ollama
+
+## Provider Configuration
+
+Set provider keys in your shell or in a local `.env` file.
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+export OPENAI_API_KEY=sk-...
+export GOOGLE_API_KEY=...
+export OPENROUTER_API_KEY=sk-or-...
+export OLLAMA_HOST=http://localhost:11434
+```
+
+Switch models or providers inside a session:
+
+```text
+/model
+/model list
+/model openai/gpt-4o
+/model google/gemini-2.5-pro
+```
+
+Provider documentation:
+
+```text
+docs/providers.html
+```
+
+## Frequently Used Commands
+
+```text
+/model        Switch models or providers
+/taste        Open taste preference-learning menu
+/status       Show provider, session, and context status
+/doctor       Run diagnostics
+/context      Inspect active context usage
+/compact      Compress conversation history
+/mcp          Manage Model Context Protocol servers
+/code-review  Review changed code for bugs
+/simplify     Run cleanup-focused review
+/plugin       Manage plugins and hooks
+/bridge       Configure bridge mode
+/agent        Manage background agent workflows
+/daemon       Open autonomous daemon dashboard
+/task         Create or manage scheduled tasks
+```
+
+Type `/` in the CLI prompt to view available commands.
+
+## Scheduled Tasks
+
+The scheduled task system is available through `/task`.
+
+```text
+/task
+```
+
+Examples:
+
+```text
+/task
+Name: Server Check
+Schedule: Daily
+Time: 20:00
+Prompt: Verify the status of local servers
+Storage: Durable
+```
+
+```text
+/task
+Name: Commit Reminder
+Schedule: In N minutes
+Delay: 10
+Prompt: Remind me to commit the code
+Storage: Session-only
+```
+
+Task behavior:
+
+* Durable tasks are saved to `.claude/scheduled_tasks.json`.
+* Session-only tasks run only during the active session.
+* Recurring tasks use standard 5-field cron syntax.
+* One-shot tasks are removed after they run.
+* Local machine timezone is used for scheduled execution.
+
+## Taste
+
+Taste is a local-first preference-learning runtime. It learns from accept, reject, edit, test, lint, and manual rules. It combines symbolic rules, semantic preference scoring, and contextual bandit optimization to adapt Clew to your coding style. It does not fine-tune the base LLM.
+
+```text
+/taste                Open interactive menu
+/taste learn <rule>   Add a manual rule
+/taste forget <id>    Remove a rule
+/taste profile        Show all rules
+/taste events         Show recent events
+/taste decay          Apply confidence decay
+/taste eval           Run self-evaluation
+/taste export         Export high-confidence rules
+/taste import <file>  Import rules from file
+/taste on             Enable taste
+/taste off            Disable taste
+```
+
+### Key Capabilities
+
+- **Interactive menu** — Arrow-key navigable Dialog with 11 actions, Spinner loading for async ops
+- **Edit validation** — Scans edits during permission request, warns when changes violate learned rules
+- **Config live-reload** — Subscribes to `settings.json` changes via `subscribeToSettingsChanges()`
+- **Status line** — `ⓘ taste: N rules` shown in PromptInputFooter alongside workflow status
+- **Prompt injection** — Injects `<clew_taste>` XML block with up to 8 relevant rules into system prompt
+- **Signal collection** — Fire-and-forget accept/reject/tool signals from PermissionContext and tool execution
+- **Decay engine** — Gradual confidence reduction for unused rules (half-life based, default 30 days)
+
+See [docs/taste.html](docs/taste.html) for full documentation.
+
+## Development
+
+```bash
+bun run dev              # Start development mode
+bun run start            # Run the CLI from source
+bun run build            # Build into dist/
+bun test                 # Run tests
+bun x tsc --noEmit       # Type check
+bun run lint:check       # Check Biome lint rules
+bun run format:check     # Check Biome formatting
+bun run check:ci         # Run Biome CI validation
+```
+
+Developer utilities:
+
+```bash
+bun run preload <module>     # Preload module context
+bun run session <command>    # Save, list, or restore session context
+bun run codegraph            # Generate module dependency graphs
+bun run ast-grep -- <args>   # Run structural AST search or rewrite
+```
+
+## Project Structure
+
+```text
+src/
+├── main.tsx              # Terminal UI bootstrap and main loop
+├── query.ts              # Query processing and system prompt logic
+├── QueryEngine.ts        # Query orchestration, caching, deduplication, and rate limits
+├── agentRuntime/         # Agent orchestration and persistent run stores
+├── commands/             # Slash command implementations
+├── tools/                # Built-in developer tools
+├── services/
+│   ├── ai/               # Provider manager, adapters, normalizers, and providers.json
+│   ├── mcp/              # Model Context Protocol clients
+│   ├── plugins/          # Plugin lifecycle hooks and interceptors
+│   ├── tools/            # Tool execution service
+│   ├── lsp/              # Language Server Protocol integration
+│   ├── Supervisor/       # Background agent supervisor
+│   └── SessionMemory/    # Persistent session memory
+├── skills/               # Dynamic skill loader
+├── cli/                  # Terminal UI contexts
+├── components/           # Terminal UI components
+├── bridge/               # WebSocket bridge
+├── coordinator/          # Multi-agent coordinator
+├── keybindings/          # Keyboard shortcut mappings
+├── state/                # Reactive stores
+└── vim/                  # Vim-like navigation mode
+```
+
+## Architecture
+
+```text
+Terminal UI
+  -> Command registry and keybindings
+  -> Provider manager and AI adapters
+  -> Query engine and streaming loops
+  -> Tool executor service
+  -> Plugins, MCP, LSP, agents, session memory, and bridge
+```
+
+## Documentation
+
+* [Installation](docs/installation.html)
+* [Quick Start](docs/quick-start.html)
+* [Configuration](docs/configuration.html)
+* [AI Providers](docs/providers.html)
+* [Models](docs/models.html)
+* [Commands](docs/commands.html)
+* [Tools](docs/tools.html)
+* [Plugins](docs/plugins.html)
+* [Skills](docs/skills.html)
+* [Architecture](docs/architecture.html)
+* [Permission Model](docs/permission-model.html)
+* [Bridge Mode](docs/features/bridge-mode.html)
+* [SearXNG Search](docs/features/searxng-search.html)
+* [Troubleshooting](docs/troubleshooting.html)
+* [Evals](docs/features/evals.html)
+* [Taste](docs/taste.html)
+
+## Debugging
+
+```bash
+DEBUG=1 bun run src/main.tsx
+DEBUG=provider:anthropic bun run src/main.tsx
+```
+
+## Platform Notes
+
+### Windows
+
+```powershell
+Remove-Item -Recurse -Force node_modules
+bun install
+bun run dev
+```
+
+A precompiled `ripgrep` binary for Windows may be bundled under:
+
+```text
+src/utils/vendor/ripgrep/x64-win32/rg.exe
+```
+
+## Contributing
+
+Read these files before contributing:
+
+* [CONTRIBUTING.md](CONTRIBUTING.md)
+* [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+* [SECURITY.md](SECURITY.md)
+* [LICENSE.md](LICENSE.md)
+
+Do not submit proprietary code, copied source, leaked material, credentials, private keys, or content you do not have the right to license.
+
+## Security
+
+Do not open public issues for security vulnerabilities.
+
+Use the private reporting process described in [SECURITY.md](SECURITY.md).
+
+## Changelog
+
+### 0.2.1 (2026-06-05)
+
+- **Taste system** — local-first preference-learning runtime. Interactive `/taste` menu with Spinner loading, edit validation in FileEditPermissionRequest, status line in PromptInputFooter, config live-reload via settings change subscription, XML tag `<clew_taste>` prompt injection.
+- **Model picker** — `/model` now shows all models from all providers grouped by provider section.
+- **Provider auto-persist** — last-used provider+model saved to `provider.json` without `--global`.
+- **Security hardening** — PowerShell prefix/wildcard rules for native executables, malformed tool call guard, bash runtime 100MB output limit.
+- **Guardian auto-review** — LLM-based permission reviewer with circuit breaker and `/approve` override.
+- **Bridge v2** — Provider-agnostic Remote Control via WebSocket, relay client, REPL bridging.
+- **PR commands** — `/pr create`, `list`, `view`, `review`, `merge`, `status`.
+- **Dynamic Workflow** — Ultracode bootstrap, progress UI polling `.claude/runs/`, transcript classifier suggestion.
+- Fixed blank screen (SentryErrorBoundary + TDZ in REPL.tsx), autocomplete hint duplication, ProviderManager base URL resolution for session-level overrides.
+
+See [CHANGELOG.md](CHANGELOG.md) for full history.
+
+## License
+
+See [LICENSE.md](LICENSE.md).
+
+Only contributor-authored modifications and original additions are licensed as described in `LICENSE.md`. This repository does not grant rights to Anthropic proprietary software, services, models, trademarks, or other protected materials.

package/bin/claudevil

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import '../dist/main.js';

package/bin/claudevil.cjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+const { spawn, spawnSync } = require('child_process');
+const { existsSync } = require('fs');
+const path = require('path');
+
+function resolveWindowsBunShim(candidate) {
+  const candidateDir = path.dirname(candidate);
+  const npmBunExe = path.join(candidateDir, 'node_modules', 'bun', 'bin', 'bun.exe');
+
+  if (existsSync(npmBunExe)) {
+    return npmBunExe;
+  }
+
+  return null;
+}
+
+function resolveBunCommand() {
+  const whichCommand = process.platform === 'win32' ? 'where' : 'which';
+  const result = spawnSync(whichCommand, ['bun'], {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'ignore'],
+    shell: false,
+  });
+
+  if (result.status !== 0 || !result.stdout) {
+    return null;
+  }
+
+  const candidates = result.stdout
+    .split(/\r?\n/)
+    .map(line => line.trim())
+    .filter(Boolean);
+
+  if (process.platform === 'win32') {
+    const exeCandidate = candidates.find(candidate => candidate.toLowerCase().endsWith('.exe'));
+    if (exeCandidate) {
+      return exeCandidate;
+    }
+
+    for (const candidate of candidates) {
+      const shimTarget = resolveWindowsBunShim(candidate);
+      if (shimTarget) {
+        return shimTarget;
+      }
+    }
+
+    return candidates.find(candidate => candidate.toLowerCase().endsWith('.cmd')) || candidates[0];
+  }
+
+  return candidates[0];
+}
+
+function printBunInstallHelp() {
+  const installCommand =
+    process.platform === 'win32'
+      ? 'powershell -c "irm bun.sh/install.ps1 | iex"'
+      : 'curl -fsSL https://bun.sh/install | bash';
+
+  console.error('Claudevil requires Bun at runtime.');
+  console.error('This npm package installs the launcher, but the CLI itself runs with Bun.');
+  console.error('');
+  console.error('Install Bun, then run `claudevil` again:');
+  console.error(`  ${installCommand}`);
+}
+
+const mainJs = path.join(__dirname, '..', 'dist', 'main.js');
+const bunCommand = resolveBunCommand();
+
+if (!bunCommand) {
+  printBunInstallHelp();
+  process.exit(1);
+}
+
+try {
+  const child = spawn(bunCommand, [mainJs, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    shell: false,
+  });
+
+  child.on('error', e => {
+    console.error('Error executing Bun:', e.message || e);
+    process.exit(1);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+
+    process.exit(code ?? 0);
+  });
+} catch (e) {
+  console.error('Error executing Bun:', e.message || e);
+  process.exit(e.status ?? 1);
+}

package/bin/clew

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import '../dist/main.js';

package/bin/clew.cjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+const { spawn, spawnSync } = require('child_process');
+const { existsSync } = require('fs');
+const path = require('path');
+
+function resolveWindowsBunShim(candidate) {
+  const candidateDir = path.dirname(candidate);
+  const npmBunExe = path.join(candidateDir, 'node_modules', 'bun', 'bin', 'bun.exe');
+
+  if (existsSync(npmBunExe)) {
+    return npmBunExe;
+  }
+
+  return null;
+}
+
+function resolveBunCommand() {
+  const whichCommand = process.platform === 'win32' ? 'where' : 'which';
+  const result = spawnSync(whichCommand, ['bun'], {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'ignore'],
+    shell: false,
+  });
+
+  if (result.status !== 0 || !result.stdout) {
+    return null;
+  }
+
+  const candidates = result.stdout
+    .split(/\r?\n/)
+    .map(line => line.trim())
+    .filter(Boolean);
+
+  if (process.platform === 'win32') {
+    const exeCandidate = candidates.find(candidate => candidate.toLowerCase().endsWith('.exe'));
+    if (exeCandidate) {
+      return exeCandidate;
+    }
+
+    for (const candidate of candidates) {
+      const shimTarget = resolveWindowsBunShim(candidate);
+      if (shimTarget) {
+        return shimTarget;
+      }
+    }
+
+    return candidates.find(candidate => candidate.toLowerCase().endsWith('.cmd')) || candidates[0];
+  }
+
+  return candidates[0];
+}
+
+function printBunInstallHelp() {
+  const installCommand =
+    process.platform === 'win32'
+      ? 'powershell -c "irm bun.sh/install.ps1 | iex"'
+      : 'curl -fsSL https://bun.sh/install | bash';
+
+  console.error('Clew requires Bun at runtime.');
+  console.error('This npm package installs the launcher, but the CLI itself runs with Bun.');
+  console.error('');
+  console.error('Install Bun, then run `clew` again:');
+  console.error(`  ${installCommand}`);
+}
+
+const mainJs = path.join(__dirname, '..', 'dist', 'main.js');
+const bunCommand = resolveBunCommand();
+
+if (!bunCommand) {
+  printBunInstallHelp();
+  process.exit(1);
+}
+
+try {
+  const child = spawn(bunCommand, [mainJs, ...process.argv.slice(2)], {
+    stdio: 'inherit',
+    shell: false,
+  });
+
+  child.on('error', e => {
+    console.error('Error executing Bun:', e.message || e);
+    process.exit(1);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+
+    process.exit(code ?? 0);
+  });
+} catch (e) {
+  console.error('Error executing Bun:', e.message || e);
+  process.exit(e.status ?? 1);
+}