claws-code 0.8.0

package/scripts/shell-hook.fish

@@ -0,0 +1,164 @@
+# CLAWS — Terminal Control Bridge
+# Native fish hook — sourced from ~/.config/fish/conf.d/claws.fish
+# No bass dependency. Pure fish syntax.
+
+if not status is-interactive
+    exit
+end
+
+# Avoid showing banner more than once per session
+if set -q CLAWS_BANNER_SHOWN
+    # Still define functions even if banner already shown
+else
+    set -gx CLAWS_BANNER_SHOWN 1
+
+    # Detect socket status.
+    # Walk up from $PWD — the extension creates the socket at
+    # <workspace-root>/.claws/claws.sock, not relative to $PWD.
+    set -l sock ""
+    if test -n "$CLAWS_SOCKET"
+        set sock $CLAWS_SOCKET
+    else
+        set -l _walk (pwd)
+        while test -n "$_walk"; and test "$_walk" != "/"
+            if test -S "$_walk/.claws/claws.sock"
+                set sock "$_walk/.claws/claws.sock"
+                break
+            end
+            set -l _parent (dirname $_walk)
+            if test "$_parent" = "$_walk"
+                break
+            end
+            set _walk $_parent
+        end
+    end
+    set -l claws_status ""
+    set -l claws_terms "-"
+
+    if test -n "$sock"; and test -S $sock
+        set claws_status "\033[32m● connected\033[0m"
+        set claws_terms (node -e "
+const net=require('net');
+const s=net.createConnection('$sock');
+s.on('connect',()=>s.write(JSON.stringify({id:0,cmd:'list'})+'\n'));
+let b='';
+s.on('data',d=>{b+=d;if(b.includes('\n')){try{process.stdout.write(String(JSON.parse(b.split('\n')[0]).terminals.length))}catch(e){process.stdout.write('?')};s.destroy()}});
+s.on('error',()=>{process.stdout.write('?');s.destroy()});
+setTimeout(()=>{process.stdout.write('?');s.destroy()},2000);
+" 2>/dev/null; or echo "?")
+    else
+        set claws_status "\033[33m○ socket not found\033[0m"
+    end
+
+    # Detect wrapped
+    set -l claws_wrap ""
+    if test -n "$CLAWS_WRAPPED" && test "$CLAWS_WRAPPED" = "1"
+        set claws_wrap "\033[32m● wrapped\033[0m (pty logged)"
+    else
+        set claws_wrap "\033[90m○ unwrapped\033[0m"
+    end
+
+    set -l T "\033[38;2;200;90;62m"
+    set -l W "\033[1;37m"
+    set -l D "\033[90m"
+    set -l R "\033[0m"
+
+    printf "\n"
+    printf "  $T╔═══════════════════════════════════════════════╗$R\n"
+    printf "  $T║$R                                               $T║$R\n"
+    printf "  $T║$R   $T ██████╗██╗      █████╗ ██╗    ██╗███████╗$R $T║$R\n"
+    printf "  $T║$R   $T██╔════╝██║     ██╔══██╗██║    ██║██╔════╝$R $T║$R\n"
+    printf "  $T║$R   $T██║     ██║     ███████║██║ █╗ ██║███████╗$R $T║$R\n"
+    printf "  $T║$R   $T██║     ██║     ██╔══██║██║███╗██║╚════██║$R $T║$R\n"
+    printf "  $T║$R   $T╚██████╗███████╗██║  ██║╚███╔███╔╝███████║$R $T║$R\n"
+    printf "  $T║$R   $T ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚══════╝$R $T║$R\n"
+    printf "  $T║$R                                               $T║$R\n"
+    printf "  $T║$R   ${D}Terminal Control Bridge$R                     $T║$R\n"
+    printf "  $T║$R                                               $T║$R\n"
+    printf "  $T║$R   Bridge:    $claws_status                   $T║$R\n"
+    printf "  $T║$R   Terminals: $W$claws_terms$R active                        $T║$R\n"
+    printf "  $T║$R   This term: $claws_wrap                   $T║$R\n"
+    printf "  $T║$R                                               $T║$R\n"
+    printf "  $T║$R   ${D}claws-ls$R    list terminals                 $T║$R\n"
+    printf "  $T║$R   ${D}claws-new$R   create wrapped terminal        $T║$R\n"
+    printf "  $T║$R   ${D}claws-run$R   exec command in terminal       $T║$R\n"
+    printf "  $T║$R   ${D}claws-log$R   read wrapped terminal log      $T║$R\n"
+    printf "  $T║$R                                               $T║$R\n"
+    printf "  $T╚═══════════════════════════════════════════════╝$R\n"
+    printf "\n"
+end
+
+# ── Shell functions ─────────────────────────────────────────────────────────
+
+function _claws_find_sock
+    if test -n "$CLAWS_SOCKET"
+        echo $CLAWS_SOCKET; return
+    end
+    set -l _w (pwd)
+    while test -n "$_w"; and test "$_w" != "/"
+        if test -S "$_w/.claws/claws.sock"
+            echo "$_w/.claws/claws.sock"; return
+        end
+        set -l _p (dirname $_w)
+        if test "$_p" = "$_w"
+            break
+        end
+        set _w $_p
+    end
+    echo ".claws/claws.sock"
+end
+
+function claws-ls
+    set -l sock (_claws_find_sock)
+    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]);(d2.terminals||[]).forEach(t=>{const w=t.logPath?'WRAPPED':'       ';const a=t.active?'*':' ';console.log(a+' '+String(t.id).padStart(3)+' '+String(t.name||'').padEnd(25)+' pid='+t.pid+'  ['+w+']')})}catch(e){console.log('error: '+e.message)};s.destroy()}});
+s.on('error',e=>{console.log('error: '+e.message+' — is the Claws extension running?');s.destroy()});
+setTimeout(()=>{console.log('error: timeout');s.destroy()},5000);
+" 2>/dev/null; or echo "error: node not available"
+end
+
+function claws-new
+    set -l name (test -n "$argv[1]" && echo $argv[1] || echo "claws")
+    set -l sock (_claws_find_sock)
+    node -e "
+const net=require('net');
+const s=net.createConnection('$sock');
+s.on('connect',()=>s.write(JSON.stringify({id:1,cmd:'create',name:'$name',wrapped:true})+'\n'));
+let b='';
+s.on('data',d=>{b+=d;if(b.includes('\n')){try{const r=JSON.parse(b.split('\n')[0]);console.log('created terminal id='+r.id+(r.logPath?' log='+r.logPath:''))}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; or echo "error: node not available"
+end
+
+function claws-run
+    set -l cmd (string join " " $argv)
+    set -l sock (_claws_find_sock)
+    node -e "
+const net=require('net');
+const s=net.createConnection('$sock');
+s.on('connect',()=>s.write(JSON.stringify({id:1,cmd:'exec',command:'$cmd'})+'\n'));
+let b='';
+s.on('data',d=>{b+=d;if(b.includes('\n')){try{const r=JSON.parse(b.split('\n')[0]);console.log(r.output||'');process.exit(r.exitCode||0)}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()},30000);
+" 2>/dev/null; or echo "error: node not available"
+end
+
+function claws-log
+    set -l id $argv[1]
+    set -l sock (_claws_find_sock)
+    node -e "
+const net=require('net');
+const s=net.createConnection('$sock');
+s.on('connect',()=>s.write(JSON.stringify({id:1,cmd:'readLog',id:'$id',strip:true})+'\n'));
+let b='';
+s.on('data',d=>{b+=d;if(b.includes('\n')){try{const r=JSON.parse(b.split('\n')[0]);process.stdout.write(r.bytes||'')}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; or echo "error: node not available"
+end

package/scripts/shell-hook.ps1

@@ -0,0 +1,33 @@
+# CLAWS terminal hook (auto-generated — do not edit)
+# Sourced from $PROFILE on PowerShell startup.
+# Only shows banner when running inside a Claws-wrapped terminal.
+# CLAWS_WRAPPED is set by the VS Code extension (claws-pty.ts) when a real
+# pty session is active; it is never set in ordinary PowerShell sessions.
+
+if ($env:CLAWS_WRAPPED -ne '1') { return }
+if ($env:CLAWS_BANNER_SHOWN -eq '1') { return }
+$env:CLAWS_BANNER_SHOWN = '1'
+
+# ASCII-only banner — Unicode box chars render as ? in PS 5.1 / legacy CP437 consoles.
+# Matches install.ps1 format.
+Write-Host ""
+Write-Host "  +-------------------------------------------+" -ForegroundColor DarkYellow
+Write-Host "  |                                           |" -ForegroundColor DarkYellow
+Write-Host "  |   CLAWS  Terminal Control Bridge          |" -ForegroundColor DarkYellow
+Write-Host "  |                                           |" -ForegroundColor DarkYellow
+Write-Host "  +-------------------------------------------+" -ForegroundColor DarkYellow
+Write-Host ""
+
+# Wrap / pipe-mode state
+$_wrapState = if ($env:CLAWS_PIPE_MODE -eq '1') {
+    "pipe-mode (degraded)"
+} else {
+    "wrapped (pty logged)"
+}
+Write-Host ("  This term  " + $_wrapState)
+if ($env:CLAWS_TERMINAL_ID) {
+    Write-Host ("  Term ID    " + $env:CLAWS_TERMINAL_ID) -ForegroundColor DarkGray
+}
+Write-Host ""
+
+Remove-Variable -Name '_wrapState' -ErrorAction SilentlyContinue

package/scripts/shell-hook.sh

@@ -0,0 +1,232 @@
+# ═══════════════════════════════════════════════════════════════
+# CLAWS — Terminal Control Bridge
+# This hook is sourced by .zshrc/.bashrc after install.
+# It displays a startup banner and adds claws shell functions.
+# ═══════════════════════════════════════════════════════════════
+
+# Export CLAWS_DIR so slash commands (/claws-fix, /claws-update) can locate scripts
+# without hardcoding ~/.claws-src. Shell-hook.sh lives at $INSTALL_DIR/scripts/,
+# so we walk up one level to get the repo root.
+if [ -z "${CLAWS_DIR:-}" ]; then
+  _hook_dir=""
+  [ -n "${BASH_SOURCE[0]:-}" ] && _hook_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd -P)"
+  [ -z "$_hook_dir" ] && [ -n "${ZSH_SCRIPT:-}" ] && _hook_dir="$(cd "$(dirname "$ZSH_SCRIPT")" 2>/dev/null && pwd -P)"
+  if [ -n "$_hook_dir" ]; then
+    export CLAWS_DIR="${_hook_dir%/scripts}"
+  else
+    export CLAWS_DIR="$HOME/.claws-src"
+  fi
+  unset _hook_dir
+fi
+
+# Only show banner in interactive shells
+if [[ $- == *i* ]] && [[ -z "${CLAWS_BANNER_SHOWN:-}" ]]; then
+  # NOTE: do NOT export — the flag must scope to the current shell only.
+  # Exporting leaks into every child process (including VS Code itself if
+  # VS Code was launched from a banner-painted shell), and every terminal
+  # VS Code spawns inherits the flag pre-set, suppressing the banner
+  # forever in that window. Plain shell variable: child processes start
+  # fresh and paint their own banner once.
+  CLAWS_BANNER_SHOWN=1
+
+  # ── Version: CLAWS_VERSION env > nearest package.json from script dir ──
+  if [ -n "${CLAWS_VERSION:-}" ]; then
+    _CLAWS_VERSION="$CLAWS_VERSION"
+  elif command -v node >/dev/null 2>&1; then
+    # BASH_SOURCE[0] in bash; ZSH_SCRIPT (zsh 5.3+) in zsh; fallback to common install path
+    _csd=""
+    [ -n "${BASH_SOURCE[0]:-}" ] && _csd="$(cd "$(dirname "${BASH_SOURCE[0]}")" 2>/dev/null && pwd -P)"
+    [ -z "$_csd" ] && [ -n "${ZSH_SCRIPT:-}" ] && _csd="$(cd "$(dirname "$ZSH_SCRIPT")" 2>/dev/null && pwd -P)"
+    [ -z "$_csd" ] && _csd="$HOME/.claws-src/scripts"
+    _CLAWS_VERSION=$(node -e "
+const path=require('path'),fs=require('fs');
+let d=path.resolve('$_csd');
+for(let i=0;i<8&&d&&d!=='/';i++,d=path.dirname(d)){
+  try{const v=JSON.parse(fs.readFileSync(path.join(d,'package.json'),'utf8')).version;
+      if(v){process.stdout.write(v);process.exit(0)}}catch(e){}
+}
+process.stdout.write('?.?.?');
+" 2>/dev/null || echo "?.?.?")
+    unset _csd
+  else
+    _CLAWS_VERSION="?.?.?"
+  fi
+
+  # ── Socket detection ──
+  CLAWS_SOCK="${CLAWS_SOCKET:-}"
+  if [ -z "$CLAWS_SOCK" ]; then
+    _walk="$PWD"
+    while [ -n "$_walk" ] && [ "$_walk" != "/" ]; do
+      if [ -S "$_walk/.claws/claws.sock" ]; then
+        CLAWS_SOCK="$_walk/.claws/claws.sock"
+        break
+      fi
+      _walk="${_walk%/*}"
+    done
+    unset _walk
+  fi
+
+  # ── Colors (ANSI-C quoting — expand cleanly in printf) ──
+  if [ -t 1 ] && [ -z "${NO_COLOR:-}" ]; then
+    _GRN=$'\033[32m'; _AMB=$'\033[33m'
+    _ORG=$'\033[38;5;208m'; _BLD=$'\033[1;37m'; _DIM=$'\033[2m'; _RST=$'\033[0m'
+  else
+    _GRN=''; _AMB=''; _ORG=''; _BLD=''; _DIM=''; _RST=''
+  fi
+
+  # ── Bridge status ──
+  if [ -S "${CLAWS_SOCK:-}" ] 2>/dev/null; then
+    _bstxt="● connected"
+    _bsansi="${_GRN}● connected${_RST}"
+    _CLAWS_TERMS=$(node -e "
+const net=require('net');
+const s=net.createConnection('$CLAWS_SOCK');
+let done=false;
+const finish=(out)=>{if(done)return;done=true;process.stdout.write(out);try{s.destroy()}catch(e){};process.exit(0)};
+s.on('connect',()=>s.write(JSON.stringify({id:0,cmd:'list'})+'\n'));
+let b='';
+s.on('data',d=>{b+=d;if(b.includes('\n')){
+  try{finish(String(JSON.parse(b.split('\n')[0]).terminals.length))}
+  catch(e){finish('?')}}});
+s.on('error',()=>finish('?'));
+setTimeout(()=>finish('?'),2000);
+" 2>/dev/null || echo "?")
+  else
+    _bstxt="○ socket not found"
+    _bsansi="${_AMB}○ socket not found${_RST}"
+    _CLAWS_TERMS="-"
+  fi
+
+  # ── Wrap / pipe-mode state ──
+  if [ "${CLAWS_WRAPPED:-}" = "1" ]; then
+    if [ "${CLAWS_PIPE_MODE:-}" = "1" ]; then
+      _wrtxt="◑ pipe-mode (degraded)"
+      _wransi="${_AMB}◑ pipe-mode (degraded)${_RST}"
+    else
+      _wrtxt="● wrapped (pty logged)"
+      _wransi="${_GRN}● wrapped (pty logged)${_RST}"
+    fi
+  else
+    _wrtxt="○ unwrapped"
+    _wransi="${_DIM}○ unwrapped${_RST}"
+  fi
+
+  # ── Banner — orange CLAWS ASCII, no border ──
+  printf "\n"
+  printf "  ${_ORG} ██████╗██╗      █████╗ ██╗    ██╗███████╗${_RST}\n"
+  printf "  ${_ORG}██╔════╝██║     ██╔══██╗██║    ██║██╔════╝${_RST}\n"
+  printf "  ${_ORG}██║     ██║     ███████║██║ █╗ ██║███████╗${_RST}\n"
+  printf "  ${_ORG}██║     ██║     ██╔══██║██║███╗██║╚════██║${_RST}\n"
+  printf "  ${_ORG}╚██████╗███████╗██║  ██║╚███╔███╔╝███████║${_RST}\n"
+  printf "  ${_ORG} ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚══════╝${_RST}\n"
+  printf "\n"
+  printf "  ${_DIM}Terminal Control Bridge  v%s${_RST}\n" "$_CLAWS_VERSION"
+  printf "\n"
+  printf "  %-11s %s\n"          "Bridge"    "$_bsansi"
+  printf "  %-11s %s active\n"   "Terminals" "$_CLAWS_TERMS"
+  printf "  %-11s %s\n"          "This term" "$_wransi"
+  printf "\n"
+
+  unset _GRN _AMB _ORG _BLD _DIM _RST
+  unset _bstxt _bsansi _CLAWS_TERMS _wrtxt _wransi
+  unset CLAWS_SOCK _CLAWS_VERSION
+fi
+
+# ═══════════════════════════════════════════════════════════════
+# Shell commands — type these in any terminal
+# ═══════════════════════════════════════════════════════════════
+
+_claws_find_sock() {
+  if [ -n "${CLAWS_SOCKET:-}" ]; then echo "$CLAWS_SOCKET"; return; fi
+  local _w="$PWD"
+  while [ -n "$_w" ] && [ "$_w" != "/" ]; do
+    [ -S "$_w/.claws/claws.sock" ] && { echo "$_w/.claws/claws.sock"; return; }
+    _w="${_w%/*}"
+  done
+  echo ""
+}
+
+_claws_require_sock() {
+  local _s; _s="$(_claws_find_sock)"
+  if [ -z "$_s" ]; then
+    echo "claws: no socket found — open a Claws project in VS Code first" >&2
+    return 1
+  fi
+  echo "$_s"
+}
+
+claws-ls() {
+  local sock; sock="$(_claws_require_sock)" || return 1
+  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='';
+const t=setTimeout(()=>{console.log('error: timeout — is VS Code open with the Claws extension?');s.destroy()},5000);
+s.on('data',d=>{b+=d;if(b.includes('\n')){clearTimeout(t);try{const d2=JSON.parse(b.split('\n')[0]);(d2.terminals||[]).forEach(t=>{const w=t.logPath?'WRAPPED':'       ';const a=t.active?'*':' ';console.log(a+' '+String(t.id).padStart(3)+' '+String(t.name||'').padEnd(25)+' pid='+t.pid+'  ['+w+']')})}catch(e){console.log('error: '+e.message)};s.destroy()}});
+s.on('error',e=>{clearTimeout(t);console.log('error: '+e.message+' — is the Claws extension running?');s.destroy()});
+" 2>/dev/null || echo "error: node not available"
+}
+
+claws-new() {
+  local name="${1:-claws}"
+  local sock; sock="$(_claws_require_sock)" || return 1
+  node -e "
+const net=require('net');
+const s=net.createConnection('$sock');
+s.on('connect',()=>s.write(JSON.stringify({id:1,cmd:'create',name:'$name',wrapped:true})+'\n'));
+let b='';
+const t=setTimeout(()=>{console.log('error: timeout');s.destroy()},5000);
+s.on('data',d=>{b+=d;if(b.includes('\n')){clearTimeout(t);try{const d2=JSON.parse(b.split('\n')[0]);if(d2.ok){console.log('created terminal '+d2.id+' — log: '+(d2.logPath||'none'))}else{console.log('error: '+d2.error)}}catch(e){console.log('error: '+e.message)};s.destroy()}});
+s.on('error',e=>{clearTimeout(t);console.log('error: '+e.message);s.destroy()});
+" 2>/dev/null || echo "error: node not available"
+}
+
+claws-run() {
+  if [ -z "$1" ] || [ -z "$2" ]; then
+    echo "usage: claws-run <terminal-id> <command>"
+    return 1
+  fi
+  local id="$1"; shift
+  local cmd="$*"
+  local sock; sock="$(_claws_require_sock)" || return 1
+  # Write command to temp file to avoid shell injection via $cmd interpolation
+  local tmpf="/tmp/claws-cmd-$$.txt"
+  printf '%s' "$cmd" > "$tmpf"
+  node -e "
+const net=require('net'),fs=require('fs'),path=require('path'),crypto=require('crypto');
+const sockPath='$sock',termId='$id',cmdFile='$tmpf';
+const cmd=fs.readFileSync(cmdFile,'utf8');
+try{fs.unlinkSync(cmdFile)}catch(e){}
+const s=net.createConnection(sockPath);
+const eid=crypto.randomBytes(4).toString('hex');
+const base='/tmp/claws-exec';
+try{fs.mkdirSync(base,{recursive:true})}catch(e){}
+const outF=path.join(base,eid+'.out'),doneF=path.join(base,eid+'.done');
+const wrapper='{ '+cmd+'; } > '+outF+' 2>&1; echo \$? > '+doneF;
+s.on('connect',()=>{s.write(JSON.stringify({id:1,cmd:'send',id:termId,text:wrapper})+'\n')});
+let b='';
+s.on('data',d=>{b+=d;if(b.includes('\n')){poll()}});
+function poll(){const deadline=Date.now()+180000;const iv=setInterval(()=>{try{if(fs.existsSync(doneF)){clearInterval(iv);console.log('exit '+fs.readFileSync(doneF,'utf8').trim());try{console.log(fs.readFileSync(outF,'utf8'))}catch(e){};try{fs.unlinkSync(outF)}catch(e){};try{fs.unlinkSync(doneF)}catch(e){};s.destroy()}}catch(e){}if(Date.now()>deadline){clearInterval(iv);console.log('timeout');s.destroy()}},200)}
+s.on('error',e=>{console.log('error: '+e.message);s.destroy()});
+" 2>/dev/null || echo "error: node not available"
+}
+
+claws-log() {
+  local id="${1:-}"
+  local lines="${2:-30}"
+  if [ -z "$id" ]; then
+    echo "usage: claws-log <terminal-id> [lines]"
+    return 1
+  fi
+  local sock; sock="$(_claws_require_sock)" || return 1
+  node -e "
+const net=require('net');
+const s=net.createConnection('$sock');
+s.on('connect',()=>s.write(JSON.stringify({id:1,cmd:'readLog',id:'$id',strip:true})+'\n'));
+let b='';
+const t=setTimeout(()=>{console.log('error: timeout');s.destroy()},10000);
+s.on('data',d=>{b+=d;if(b.includes('\n')){clearTimeout(t);try{const d2=JSON.parse(b.split('\n')[0]);if(d2.ok){const lines=(d2.bytes||'').split('\n');lines.slice(-$lines).forEach(l=>console.log(l));console.log('\n['+(d2.totalSize||0)+' bytes total]')}else{console.log('error: '+d2.error)}}catch(e){console.log('error: '+e.message)};s.destroy()}});
+s.on('error',e=>{clearTimeout(t);console.log('error: '+e.message);s.destroy()});
+" 2>/dev/null || echo "error: node not available"
+}