claws-code 0.8.0

package/scripts/test-install.sh

@@ -0,0 +1,174 @@
+#!/bin/bash
+# Claws — post-install test + live demo of multi-terminal orchestration
+# Run after install.sh. Proves every feature works end-to-end.
+# Usage: bash scripts/test-install.sh
+
+set -e
+
+SOCK=".claws/claws.sock"
+PASS=0
+FAIL=0
+
+passed() { echo "  ✓ $1"; PASS=$((PASS+1)); }
+failed() { echo "  ✗ $1"; FAIL=$((FAIL+1)); }
+
+echo ""
+echo "  ╔═══════════════════════════════════════════╗"
+echo "  ║   CLAWS — Installation Test + Live Demo   ║"
+echo "  ╚═══════════════════════════════════════════╝"
+echo ""
+
+# Test 1: Socket exists
+echo "── Test 1: Socket connection ──"
+if [ -S "$SOCK" ]; then
+  passed "socket found at $SOCK"
+else
+  failed "no socket at $SOCK — did you reload VS Code?"
+  echo "  Run: Cmd+Shift+P → 'Developer: Reload Window'"
+  exit 1
+fi
+
+# Test 2: List terminals
+echo "── Test 2: List terminals ──"
+COUNT=$(node -e "
+const net=require('net');
+const s=net.createConnection('$SOCK');
+s.on('connect',()=>s.write(JSON.stringify({id:1,cmd:'list'})+'\n'));
+let b='';
+s.on('data',d=>{b+=d;if(b.includes('\n')){try{const d2=JSON.parse(b.split('\n')[0]);if(!d2.ok)throw new Error('not ok');console.log(d2.terminals.length)}catch(e){console.log('ERROR:'+e.message)};s.destroy()}});
+s.on('error',e=>{console.log('ERROR:'+e.message);s.destroy()});
+setTimeout(()=>{console.log('ERROR:timeout');s.destroy()},5000);
+" 2>/dev/null)
+if echo "$COUNT" | grep -q "^[0-9]"; then
+  passed "listed $COUNT terminal(s)"
+else
+  failed "list command failed: $COUNT"
+fi
+
+# Test 3: Node socket module
+echo "── Test 3: Node net module ──"
+if node -e "require('net'); console.log('OK')" 2>/dev/null; then
+  passed "node net module available (MCP server registered via settings.json)"
+else
+  failed "node not available or net module missing"
+fi
+
+# Test 4: Create + exec + read + close (full loop)
+echo "── Test 4: Full terminal lifecycle ──"
+node -e "
+const net=require('net'),fs=require('fs'),crypto=require('crypto');
+const SOCK='$SOCK';
+
+function send(cmd){return new Promise((resolve,reject)=>{const s=net.createConnection(SOCK);s.on('connect',()=>s.write(JSON.stringify(cmd)+'\n'));let b='';s.on('data',d=>{b+=d;if(b.includes('\n')){try{resolve(JSON.parse(b.split('\n')[0]))}catch(e){reject(e)};s.destroy()}});s.on('error',e=>reject(e));setTimeout(()=>reject(new Error('timeout')),10000)})}
+
+async function run(){
+  // Create terminal
+  const cr=await send({id:1,cmd:'create',name:'claws-test',wrapped:true});
+  if(!cr.ok)throw new Error('create failed: '+cr.error);
+  const tid=cr.id;
+
+  // Wait for terminal to start
+  await new Promise(r=>setTimeout(r,1500));
+
+  // Exec command via send + poll
+  const eid=crypto.randomBytes(4).toString('hex');
+  const base='/tmp/claws-exec';
+  try{fs.mkdirSync(base,{recursive:true})}catch(e){}
+  const outF=base+'/'+eid+'.out',doneF=base+'/'+eid+'.done';
+  const wrapper='{ echo CLAWS_TEST_PASS && date && uname -a; } > '+outF+' 2>&1; echo \$? > '+doneF;
+  await send({id:1,cmd:'send',id:tid,text:wrapper});
+
+  // Poll for completion
+  const deadline=Date.now()+30000;
+  while(Date.now()<deadline){if(fs.existsSync(doneF))break;await new Promise(r=>setTimeout(r,200))}
+  if(!fs.existsSync(doneF))throw new Error('exec timed out');
+  const exitCode=fs.readFileSync(doneF,'utf8').trim();
+  if(exitCode!=='0')throw new Error('exit code '+exitCode);
+  const output=fs.readFileSync(outF,'utf8');
+  if(!output.includes('CLAWS_TEST_PASS'))throw new Error('output missing marker');
+  try{fs.unlinkSync(outF)}catch(e){}
+  try{fs.unlinkSync(doneF)}catch(e){}
+
+  // Read log
+  const lr=await send({id:1,cmd:'readLog',id:tid,strip:true});
+  if(!lr.ok)throw new Error('readLog failed: '+lr.error);
+  if(!lr.bytes||lr.bytes.length===0)throw new Error('empty log');
+
+  // Close terminal
+  await send({id:1,cmd:'close',id:tid});
+  console.log('  ✓ create → exec → readLog → close — all passed');
+}
+
+run().catch(e=>{console.log('  ✗ lifecycle test failed: '+e.message);process.exit(1)});
+" 2>/dev/null
+
+# Test 5: Multi-terminal orchestration demo
+echo ""
+echo "── Test 5: LIVE DEMO — Multi-terminal orchestration ──"
+echo ""
+node -e "
+const net=require('net'),fs=require('fs'),crypto=require('crypto');
+const SOCK='$SOCK';
+
+function send(cmd){return new Promise((resolve,reject)=>{const s=net.createConnection(SOCK);s.on('connect',()=>s.write(JSON.stringify(cmd)+'\n'));let b='';s.on('data',d=>{b+=d;if(b.includes('\n')){try{resolve(JSON.parse(b.split('\n')[0]))}catch(e){reject(e)};s.destroy()}});s.on('error',e=>reject(e));setTimeout(()=>reject(new Error('timeout')),10000)})}
+
+async function run(){
+  // Spawn 3 workers
+  console.log('  Spawning 3 parallel workers...');
+  const workers={};
+  const specs=[
+    {name:'worker-alpha',cmd:\"echo 'Alpha reporting' && sleep 1 && echo 'Alpha done'\"},
+    {name:'worker-beta',cmd:\"echo 'Beta reporting' && ls -1 | head -5 && echo 'Beta done'\"},
+    {name:'worker-gamma',cmd:\"echo 'Gamma reporting' && date && whoami && echo 'Gamma done'\"}
+  ];
+  for(const spec of specs){
+    const cr=await send({id:1,cmd:'create',name:spec.name,wrapped:true});
+    workers[spec.name]={id:cr.id,cmd:spec.cmd};
+    await new Promise(r=>setTimeout(r,500));
+  }
+  console.log('  ✓ 3 terminals spawned: '+Object.keys(workers).join(', '));
+
+  // Fire all commands in parallel
+  console.log('  Firing commands into all 3...');
+  for(const [name,w] of Object.entries(workers)){
+    await send({id:1,cmd:'send',id:w.id,text:w.cmd});
+  }
+  console.log('  ✓ Commands sent to all 3 workers');
+
+  // Wait and collect results
+  console.log('  Waiting for results...');
+  await new Promise(r=>setTimeout(r,3000));
+
+  console.log('');
+  console.log('  ┌─────────────────────────────────────────────┐');
+  for(const [name,w] of Object.entries(workers)){
+    const lr=await send({id:1,cmd:'readLog',id:w.id,strip:true});
+    const log=lr.ok?(lr.bytes||''):'';
+    const lines=log.split('\n').filter(l=>l.trim()&&l.toLowerCase().includes('done'));
+    const status=lines.length>0?'DONE':'...';
+    console.log('  │  '+name.padEnd(20)+' ['+status+']');
+  }
+  console.log('  └─────────────────────────────────────────────┘');
+  console.log('');
+
+  // Cleanup
+  for(const [name,w] of Object.entries(workers)){
+    await send({id:1,cmd:'close',id:w.id});
+  }
+  console.log('  ✓ All 3 workers closed. Terminals cleaned up.');
+  console.log('');
+  console.log('  Multi-terminal orchestration works. You\\'re ready.');
+}
+
+run().catch(e=>{console.log('  ✗ demo failed: '+e.message);process.exit(1)});
+" 2>/dev/null
+
+echo ""
+echo "  ════════════════════════════════════════════"
+echo "  Results: $PASS passed"
+echo ""
+echo "  Your terminals are now programmable."
+echo "  Docs:    https://github.com/neunaha/claws"
+echo "  Website: https://neunaha.github.io/claws/"
+echo "  ════════════════════════════════════════════"
+echo ""

package/scripts/test-installer-parity.sh

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+# scripts/test-installer-parity.sh — parity harness: bash install.sh vs node bin/cli.js install
+#
+# Creates two temp project dirs, runs bash and node installers, diffs:
+#   .mcp.json claws entry (normalized), CLAUDE.md CLAWS:BEGIN block,
+#   .claude/settings.json hooks, .claws-bin/ file list, shell rc hook line.
+# Exits 0 on zero diff, 1 otherwise with concrete diff output.
+
+set -euo pipefail
+
+REPO="$(cd "$(dirname "$0")/.." && pwd)"
+TMP="$(mktemp -d /tmp/claws-parity-XXXXXX)"
+# Use same basename so {PROJECT_NAME} matches in both CLAUDE.md blocks
+A="$TMP/a/claws-parity-project"
+B="$TMP/b/claws-parity-project"
+SRC="$TMP/src"
+HOME_A="$TMP/home-a"
+HOME_B="$TMP/home-b"
+trap 'rm -rf "$TMP"' EXIT
+FAIL=0
+
+_ok()   { printf '  \033[32m✓\033[0m %s\n' "$1"; }
+_fail() { printf '  \033[31m✗\033[0m %s\n' "$1"; FAIL=$((FAIL+1)); }
+_diff() { diff -u "$1" "$2" 2>/dev/null | head -30 || true; }
+
+mkdir -p "$A" "$B" "$HOME_A/.claude" "$HOME_B/.claude"
+
+# ── Build source clone for bash installer ─────────────────────────────────────
+printf '\n[parity] cloning source for bash installer...\n'
+git clone --local --no-hardlinks -q "$REPO" "$SRC"
+# Pre-seed pre-built artifacts so bash skips extension build
+[ -d "$REPO/extension/dist"   ] && cp -R "$REPO/extension/dist"   "$SRC/extension/"
+[ -d "$REPO/extension/native" ] && cp -R "$REPO/extension/native" "$SRC/extension/"
+# Align .build-sha with clone HEAD so needs_build() returns false
+git -C "$SRC" rev-parse HEAD > "$SRC/extension/dist/.build-sha" 2>/dev/null || true
+# Touch bundle so find -newer finds no src files newer than it
+touch "$SRC/extension/dist/extension.js" 2>/dev/null || true
+
+# ── Run bash installer ────────────────────────────────────────────────────────
+printf '[parity] running bash install.sh in proj A...\n'
+(
+  cd "$A"
+  CLAWS_DIR="$SRC" CLAWS_NO_LOG=1 CLAWS_NO_GLOBAL_HOOKS=1 \
+  CLAWS_EDITOR=skip CLAWS_SKIP_EXTENSION_COPY=1 CLAWS_SKIP_VSCODE_RECOMMEND=1 \
+  HOME="$HOME_A" \
+  bash "$REPO/scripts/install.sh" 2>&1
+) | grep -E '^\s*(✓|!|✗|\[)' | head -20 || true
+
+# ── Run node installer ────────────────────────────────────────────────────────
+printf '[parity] running node bin/cli.js install in proj B...\n'
+(
+  cd "$B"
+  HOME="$HOME_B" CLAWS_SKIP_EXTENSION_COPY=1 \
+  node "$REPO/bin/cli.js" install --no-hooks 2>&1
+) | grep -E '^\s*(✓|!|\[)' | head -20 || true
+
+# ── Compare artifacts ─────────────────────────────────────────────────────────
+printf '\n[parity] comparing artifacts...\n'
+
+# (a) .mcp.json: normalize absolute paths → relative before comparing
+_norm_mcp() {
+  node -e "
+    const c = JSON.parse(require('fs').readFileSync(process.argv[1],'utf8'));
+    const e = (c.mcpServers||{}).claws || {};
+    const args = (e.args||[]).map(a => a.replace(/^.*\\/\\.claws-bin\\//, '.claws-bin/'));
+    process.stdout.write(JSON.stringify({ command: e.command||'', args }) + '\n');
+  " "$1"
+}
+if [ -f "$A/.mcp.json" ] && [ -f "$B/.mcp.json" ]; then
+  A_MCP="$(_norm_mcp "$A/.mcp.json")"; B_MCP="$(_norm_mcp "$B/.mcp.json")"
+  if [ "$A_MCP" = "$B_MCP" ]; then _ok ".mcp.json"
+  else _fail ".mcp.json"; printf '    bash: %s\n    node: %s\n' "$A_MCP" "$B_MCP"; fi
+else
+  _fail ".mcp.json missing: bash=$( [ -f "$A/.mcp.json" ] && echo Y || echo N) node=$( [ -f "$B/.mcp.json" ] && echo Y || echo N)"
+fi
+
+# (b) CLAUDE.md CLAWS:BEGIN block (normalize project-name and cmds-list lines)
+_extract_block() {
+  awk '/<!-- CLAWS:BEGIN/,/<!-- CLAWS:END/{print}' "$1" 2>/dev/null \
+    | grep -vE '\{PROJECT_NAME\}|claws-parity-project|^.*\bclaws-[a-z-]+\b.*$|CMDS_COUNT|CMDS_LIST|Slash commands \([0-9]+\)' \
+    || true
+}
+if [ -f "$A/CLAUDE.md" ] && [ -f "$B/CLAUDE.md" ]; then
+  BA="$(_extract_block "$A/CLAUDE.md")"; BB="$(_extract_block "$B/CLAUDE.md")"
+  if [ "$BA" = "$BB" ] && [ -n "$BA" ]; then _ok "CLAUDE.md CLAWS:BEGIN block"
+  else _fail "CLAUDE.md CLAWS:BEGIN block"; _diff <(echo "$BA") <(echo "$BB"); fi
+else
+  _fail "CLAUDE.md missing: bash=$( [ -f "$A/CLAUDE.md" ] && echo Y || echo N) node=$( [ -f "$B/CLAUDE.md" ] && echo Y || echo N)"
+fi
+
+# (c) .claude/settings.json hooks (both --no-hooks → should be absent)
+_get_hooks() {
+  [ -f "$1" ] && node -e "
+    try{ const c=JSON.parse(require('fs').readFileSync(process.argv[1],'utf8'));
+    process.stdout.write(JSON.stringify(c.hooks||{})); }catch{process.stdout.write('{}')}
+  " "$1" 2>/dev/null || printf '{}'
+}
+HA="$(_get_hooks "$HOME_A/.claude/settings.json")"
+HB="$(_get_hooks "$HOME_B/.claude/settings.json")"
+if [ "$HA" = "$HB" ]; then _ok ".claude/settings.json hooks"
+else _fail ".claude/settings.json hooks differ"; printf '    bash: %s\n    node: %s\n' "$HA" "$HB"; fi
+
+# (d) .claws-bin/ file list
+FILES_A="$(cd "$A" && find .claws-bin -type f 2>/dev/null | sort || true)"
+FILES_B="$(cd "$B" && find .claws-bin -type f 2>/dev/null | sort || true)"
+if [ "$FILES_A" = "$FILES_B" ] && [ -n "$FILES_A" ]; then _ok ".claws-bin/ file list"
+else _fail ".claws-bin/ file list"; _diff <(echo "$FILES_A") <(echo "$FILES_B"); fi
+
+# (e) Shell rc-file: both must reference shell-hook.sh
+RC_A="$(grep -rh 'shell-hook\.sh' "$HOME_A"/.zshrc "$HOME_A"/.bashrc 2>/dev/null | head -1 || true)"
+RC_B="$(grep -rh 'shell-hook\.sh' "$HOME_B"/.zshrc "$HOME_B"/.bashrc 2>/dev/null | head -1 || true)"
+if [ -n "$RC_A" ] && [ -n "$RC_B" ]; then _ok "shell rc-file (shell-hook.sh sourced in both)"
+else _fail "shell rc-file: bash='${RC_A:-MISSING}' node='${RC_B:-MISSING}'"; fi
+
+# (f) Project-local .claude/rules/ and .claude/skills/ — W7-6 regression guard
+# Both installers must write claws-default-behavior.md into <project>/.claude/rules/
+# and at least one skill dir into <project>/.claude/skills/.
+RULES_A="$([ -d "$A/.claude/rules" ] && echo "Y" || echo "N")"
+RULES_B="$([ -d "$B/.claude/rules" ] && echo "Y" || echo "N")"
+SKILLS_A="$([ -d "$A/.claude/skills" ] && echo "Y" || echo "N")"
+SKILLS_B="$([ -d "$B/.claude/skills" ] && echo "Y" || echo "N")"
+if [ "$RULES_A" = "Y" ] && [ "$RULES_B" = "Y" ]; then _ok ".claude/rules/ project-local (both)"
+else _fail ".claude/rules/ project-local: bash=$RULES_A node=$RULES_B"; fi
+if [ "$SKILLS_A" = "Y" ] && [ "$SKILLS_B" = "Y" ]; then _ok ".claude/skills/ project-local (both)"
+else _fail ".claude/skills/ project-local: bash=$SKILLS_A node=$SKILLS_B"; fi
+# Guard: neither installer should put rules/skills into the fake HOME
+RULES_HOME_A="$([ -d "$HOME_A/.claude/rules" ] && echo "Y" || echo "N")"
+RULES_HOME_B="$([ -d "$HOME_B/.claude/rules" ] && echo "Y" || echo "N")"
+if [ "$RULES_HOME_A" = "N" ] && [ "$RULES_HOME_B" = "N" ]; then _ok ".claude/rules/ not leaked to HOME (both)"
+else _fail ".claude/rules/ leaked to HOME: bash=$RULES_HOME_A node=$RULES_HOME_B"; fi
+
+printf '\n[parity] '
+[ "$FAIL" -eq 0 ] && printf '\033[32mPASS\033[0m — all %d checks green\n' 8 || \
+  printf '\033[31mFAIL\033[0m — %d check(s) failed\n' "$FAIL"
+[ "$FAIL" -eq 0 ] && exit 0 || exit 1

package/scripts/test-template-enforcement.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT='/Users/ANISH.NEUNAHA/Desktop/Claws'
+TMPDIR=$(mktemp -d)
+TMPHOME=$(mktemp -d)
+trap 'rm -rf "$TMPDIR" "$TMPHOME"' EXIT
+
+fail() { echo "FAIL: $*" >&2; exit 1; }
+
+VERSION=$(node -e "console.log(require('$ROOT/package.json').version)")
+
+# 1. Run project injector against TMPDIR
+mkdir -p "$TMPDIR/.claude/commands"
+cp "$ROOT/.claude/commands/"claws*.md "$TMPDIR/.claude/commands/" 2>/dev/null || true
+node "$ROOT/scripts/inject-claude-md.js" "$TMPDIR" >/dev/null
+PROJECT_MD="$TMPDIR/CLAUDE.md"
+[ -f "$PROJECT_MD" ] || fail "project CLAUDE.md not created"
+
+# 2. Run global injector with HOME redirected
+HOME="$TMPHOME" node "$ROOT/scripts/inject-global-claude-md.js" >/dev/null
+GLOBAL_MD="$TMPHOME/.claude/CLAUDE.md"
+[ -f "$GLOBAL_MD" ] || fail "global CLAUDE.md not created"
+
+# 3. PROJECT presence assertions
+for s in 'claws_done' '__CLAWS_DONE__' 'claws_fleet' 'claws_dispatch_subworker' 'claws_drain_events' 'claws_workers_wait' 'SESSION-BOOT' 'SESSION-END'; do
+  grep -q -- "$s" "$PROJECT_MD" || fail "project: missing required string '$s'"
+done
+grep -q "<!-- CLAWS:BEGIN v$VERSION -->" "$PROJECT_MD" || fail "project: missing versioned sentinel v$VERSION"
+
+# 4. PROJECT absence assertions
+for s in 'MARK_M??_OK_COLOR' 'bypass permissions' 'No marker required'; do
+  grep -q -- "$s" "$PROJECT_MD" && fail "project: forbidden string '$s' present" || true
+done
+
+# 5. GLOBAL presence assertions
+for s in 'claws_done' '__CLAWS_DONE__' 'SESSION-BOOT' 'SESSION-END' 'FAILED' 'mode-aware'; do
+  grep -q -- "$s" "$GLOBAL_MD" || fail "global: missing required string '$s'"
+done
+grep -q "<!-- CLAWS-GLOBAL:BEGIN v$VERSION -->" "$GLOBAL_MD" || fail "global: missing versioned sentinel v$VERSION"
+
+# 6. GLOBAL absence assertions
+for s in 'MARK_M??_OK_COLOR' 'bypass permissions' 'No marker required'; do
+  grep -q -- "$s" "$GLOBAL_MD" && fail "global: forbidden string '$s' present" || true
+done
+
+# 7. Tool-list completeness: extracted tools must equal mcp_server.js dispatch surface
+INJECTED_TOOLS=$(grep -oE 'claws_[a-z_]+' "$PROJECT_MD" | sort -u)
+ACTUAL_TOOLS=$(grep -oE "name === 'claws_[a-z_]+'" "$ROOT/mcp_server.js" | grep -oE 'claws_[a-z_]+' | sort -u)
+if [ "$INJECTED_TOOLS" != "$ACTUAL_TOOLS" ]; then
+  echo 'TOOL DRIFT:' >&2
+  diff <(echo "$INJECTED_TOOLS") <(echo "$ACTUAL_TOOLS") >&2 || true
+  fail 'project: injected tool list does not match mcp_server.js surface'
+fi
+
+# 8. Phase completeness: phases in injected block must equal Phase enum in lifecycle-store.ts
+ACTUAL_PHASES=$(grep -oE "'[A-Z][A-Z0-9-]+'" "$ROOT/extension/src/lifecycle-store.ts" | head -20 | tr -d "'" | sort -u)
+for phase in $ACTUAL_PHASES; do
+  grep -q -- "$phase" "$PROJECT_MD" || fail "project: missing phase '$phase'"
+done
+
+# 9. Idempotence: second run should report unchanged
+SECOND=$(node "$ROOT/scripts/inject-claude-md.js" "$TMPDIR")
+echo "$SECOND" | grep -q 'already has the current Claws block' || fail "project injector not idempotent: $SECOND"
+
+# 10. Sentinel migration: pre-seed an old unversioned sentinel and verify it's replaced
+MIG=$(mktemp -d)
+mkdir -p "$MIG/.claude/commands"
+printf '# old project\n\n<!-- CLAWS:BEGIN -->\nlegacy text\n<!-- CLAWS:END -->\n' > "$MIG/CLAUDE.md"
+node "$ROOT/scripts/inject-claude-md.js" "$MIG" >/dev/null
+BLOCKS=$(grep -c '<!-- CLAWS:BEGIN' "$MIG/CLAUDE.md" || true)
+[ "$BLOCKS" = '1' ] || fail "sentinel migration: expected 1 BEGIN block, found $BLOCKS"
+grep -q "<!-- CLAWS:BEGIN v$VERSION -->" "$MIG/CLAUDE.md" || fail "sentinel migration: new versioned sentinel not present after upgrade"
+rm -rf "$MIG"
+
+echo 'OK — all template enforcement checks passed (v'"$VERSION"', '"$(echo "$ACTUAL_TOOLS" | wc -l | tr -d ' ')"' tools)'

package/scripts/uninstall.sh

@@ -0,0 +1,143 @@
+#!/usr/bin/env bash
+# Claws — uninstall script
+# Removes all Claws artifacts from the current project and the user's shell config.
+# Idempotent: re-running is safe even if some components were already removed.
+#
+# Usage (from your project root or any directory):
+#   bash ~/.claws-src/scripts/uninstall.sh
+#   bash /path/to/claws/scripts/uninstall.sh
+#
+# What is NOT removed automatically (requires manual steps):
+#   - The VS Code extension — run: code --uninstall-extension neunaha.claws
+#   - The Claws source repo (~/.claws-src) — remove manually if desired: rm -rf ~/.claws-src
+
+set -eo pipefail
+
+# ── Colour helpers ────────────────────────────────────────────────────────────
+if [ -t 1 ]; then
+  C_RESET='\033[0m'; C_BOLD='\033[1m'
+  C_BLUE='\033[0;34m'; C_GREEN='\033[0;32m'; C_YELLOW='\033[0;33m'; C_RED='\033[0;31m'; C_DIM='\033[2m'
+else
+  C_RESET=''; C_BOLD=''; C_BLUE=''; C_GREEN=''; C_YELLOW=''; C_RED=''; C_DIM=''
+fi
+
+ok()   { printf "  ${C_GREEN}✓${C_RESET} %s\n" "$*"; }
+warn() { printf "  ${C_YELLOW}!${C_RESET} %s\n" "$*"; }
+info() { printf "  ${C_DIM}%s${C_RESET}\n" "$*"; }
+step() { printf "\n${C_BOLD}${C_BLUE}%s${C_RESET}\n" "$*"; }
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+INSTALL_DIR="$(dirname "$SCRIPT_DIR")"
+PROJECT_ROOT="${PWD}"
+
+echo ""
+printf "${C_BOLD}${C_BLUE}Claws Uninstaller${C_RESET}\n"
+printf "${C_DIM}Project root: %s${C_RESET}\n" "$PROJECT_ROOT"
+printf "${C_DIM}Claws source: %s${C_RESET}\n" "$INSTALL_DIR"
+echo ""
+
+# ── Step 1: Deregister lifecycle hooks from ~/.claude/settings.json ──────────
+step "[1/5] Removing lifecycle hooks from ~/.claude/settings.json"
+HOOKS_SCRIPT="$INSTALL_DIR/scripts/inject-settings-hooks.js"
+if [ -f "$HOOKS_SCRIPT" ]; then
+  if node "$HOOKS_SCRIPT" --remove 2>/dev/null; then
+    ok "hooks deregistered"
+  else
+    warn "hook removal returned non-zero — hooks may already be absent"
+  fi
+else
+  warn "inject-settings-hooks.js not found at $HOOKS_SCRIPT — skipping hook removal"
+fi
+
+# ── Step 2: Strip CLAWS:BEGIN/END blocks from CLAUDE.md files ────────────────
+step "[2/5] Stripping CLAWS:BEGIN blocks from CLAUDE.md files"
+
+strip_claws_block() {
+  local file="$1"
+  if [ ! -f "$file" ]; then
+    info "not found: $file — skipping"
+    return
+  fi
+  if ! grep -q "CLAWS:BEGIN" "$file" 2>/dev/null; then
+    info "no CLAWS:BEGIN block in $file — nothing to strip"
+    return
+  fi
+  local tmp
+  tmp=$(mktemp)
+  awk '/# CLAWS:BEGIN/,/# CLAWS:END/{next} {print}' "$file" > "$tmp" && mv "$tmp" "$file"
+  ok "stripped CLAWS:BEGIN block from $file"
+}
+
+strip_claws_block "$PROJECT_ROOT/CLAUDE.md"
+strip_claws_block "$HOME/.claude/CLAUDE.md"
+
+# ── Step 3: Remove shell hook source line from rc files ──────────────────────
+step "[3/5] Removing shell hook from rc files"
+
+remove_hook_from_rc() {
+  local rcfile="$1"
+  if [ ! -f "$rcfile" ]; then
+    return
+  fi
+  if ! grep -q "CLAWS terminal hook\|shell-hook\.sh" "$rcfile" 2>/dev/null; then
+    return
+  fi
+  local tmp
+  tmp=$(mktemp)
+  awk '
+    /# CLAWS terminal hook/ { skip=1; next }
+    skip && /shell-hook\.sh/ { skip=0; next }
+    skip { skip=0; print }
+    { print }
+  ' "$rcfile" > "$tmp" && mv "$tmp" "$rcfile"
+  ok "removed Claws hook from $rcfile"
+}
+
+remove_hook_from_rc "$HOME/.zshrc"
+remove_hook_from_rc "$HOME/.bashrc"
+remove_hook_from_rc "$HOME/.bash_profile"
+
+FISH_CONF="${XDG_CONFIG_HOME:-$HOME/.config}/fish/conf.d/claws.fish"
+if [ -f "$FISH_CONF" ]; then
+  rm -f "$FISH_CONF"
+  ok "removed $FISH_CONF"
+fi
+
+NUSHELL_ENV="${XDG_CONFIG_HOME:-$HOME/.config}/nushell/env.nu"
+if [ -f "$NUSHELL_ENV" ] && grep -q "CLAWS_DIR\|claws" "$NUSHELL_ENV" 2>/dev/null; then
+  _nu_tmp=$(mktemp)
+  grep -v "CLAWS_DIR\|claws" "$NUSHELL_ENV" > "$_nu_tmp" && mv "$_nu_tmp" "$NUSHELL_ENV"
+  ok "removed Claws lines from $NUSHELL_ENV"
+fi
+
+# ── Step 4: Remove project-local Claws directories ───────────────────────────
+step "[4/5] Removing .claws-bin/ and .claws/ from project root"
+
+if [ -d "$PROJECT_ROOT/.claws-bin" ]; then
+  rm -rf "$PROJECT_ROOT/.claws-bin"
+  ok "removed $PROJECT_ROOT/.claws-bin"
+else
+  info ".claws-bin/ not found — already removed"
+fi
+
+if [ -d "$PROJECT_ROOT/.claws" ]; then
+  rm -rf "$PROJECT_ROOT/.claws"
+  ok "removed $PROJECT_ROOT/.claws"
+else
+  info ".claws/ not found — already removed"
+fi
+
+# ── Step 5: Manual step — uninstall VS Code extension ────────────────────────
+step "[5/5] VS Code extension (manual step required)"
+echo ""
+printf "  Run this command to uninstall the Claws VS Code extension:\n\n"
+printf "  ${C_YELLOW}NOTE: this uninstalls Claws machine-wide from your editor (not just this project).${C_RESET}\n"
+printf "  ${C_YELLOW}If Claws is installed in other projects you want to keep, do NOT run this.${C_RESET}\n\n"
+printf "    ${C_BOLD}code --uninstall-extension neunaha.claws${C_RESET}\n\n"
+printf "  (If you use Cursor: ${C_BOLD}cursor --uninstall-extension neunaha.claws${C_RESET})\n"
+printf "  (If you use Windsurf: ${C_BOLD}windsurf --uninstall-extension neunaha.claws${C_RESET})\n\n"
+
+echo ""
+ok "Claws uninstall complete."
+info "You may also remove the source repo: rm -rf $INSTALL_DIR"
+echo ""