claude-b 0.3.2

package/eslint.config.js

@@ -0,0 +1,44 @@
+import eslint from '@eslint/js';
+import tseslint from '@typescript-eslint/eslint-plugin';
+import tsparser from '@typescript-eslint/parser';
+
+export default [
+  {
+    ignores: ['dist/**', 'node_modules/**', '*.config.js']
+  },
+  {
+    files: ['src/**/*.ts'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module'
+      }
+    },
+    plugins: {
+      '@typescript-eslint': tseslint
+    },
+    rules: {
+      // TypeScript specific rules
+      '@typescript-eslint/no-unused-vars': ['warn', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+
+      // General rules
+      'no-console': 'off',
+      'prefer-const': 'error',
+      'no-var': 'error',
+      'eqeqeq': ['error', 'always'],
+      'curly': ['error', 'multi-line'],
+      'no-throw-literal': 'error'
+    }
+  },
+  {
+    files: ['src/**/*.test.ts'],
+    rules: {
+      // Relax rules for test files
+      '@typescript-eslint/no-explicit-any': 'off'
+    }
+  }
+];

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "claude-b",
+  "version": "0.3.2",
+  "description": "Background-capable Claude Code with async workflows and REST API",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "cb": "./bin/cb"
+  },
+  "scripts": {
+    "dev": "tsup src/cli/index.ts src/daemon/index.ts --watch --format esm",
+    "build": "tsup src/cli/index.ts src/daemon/index.ts --format esm --dts --clean",
+    "test": "vitest",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "start:daemon": "node dist/daemon/index.js"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.74.0",
+    "@fastify/cors": "^10.0.0",
+    "@fastify/jwt": "^9.0.0",
+    "@fastify/rate-limit": "^10.0.0",
+    "@fastify/websocket": "^11.0.0",
+    "@speechmatics/batch-client": "^5.1.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fastify": "^5.0.0",
+    "nanoid": "^5.0.7",
+    "node-pty": "^1.0.0",
+    "node-telegram-bot-api": "^0.67.0",
+    "ora": "^8.1.0",
+    "strip-ansi": "^7.1.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/node-telegram-bot-api": "^0.64.13",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
+    "eslint": "^9.39.2",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "claude",
+    "ai",
+    "cli",
+    "background",
+    "async",
+    "anthropic",
+    "claude-code"
+  ],
+  "author": "danimoya",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/danimoya/Claude-B.git"
+  },
+  "homepage": "https://github.com/danimoya/Claude-B#readme",
+  "bugs": {
+    "url": "https://github.com/danimoya/Claude-B/issues"
+  }
+}

package/scripts/install.sh

@@ -0,0 +1,124 @@
+#!/usr/bin/env bash
+# Claude-B installer
+# Usage:
+#   curl -fsSL https://cb.danielmoya.cv | bash
+#   curl -fsSL https://cb.danielmoya.cv | bash -s -- --method npm
+#
+# Methods (auto-detected, override with --method):
+#   npm     — requires node >= 20
+#   docker  — pulls ghcr.io/danimoya/claude-b:latest
+#   auto    — prefers npm, falls back to docker (default)
+set -euo pipefail
+
+REPO="${CLAUDE_B_REPO:-danimoya/Claude-B}"
+GHCR_IMAGE="ghcr.io/${REPO,,}"
+METHOD="auto"
+SKIP_INIT=0
+
+for arg in "$@"; do
+  case "$arg" in
+    --method=*) METHOD="${arg#*=}" ;;
+    --method) shift; METHOD="${1:-auto}" ;;
+    --skip-init) SKIP_INIT=1 ;;
+    -h|--help)
+      sed -n '2,12p' "$0" | sed 's/^# \{0,1\}//'
+      exit 0
+      ;;
+  esac
+done
+
+RESET='\033[0m'; BOLD='\033[1m'; GREEN='\033[32m'; YELLOW='\033[33m'; RED='\033[31m'; GRAY='\033[90m'
+
+say()  { printf '%b\n' "${BOLD}==>${RESET} $*"; }
+warn() { printf '%b\n' "${YELLOW}warning:${RESET} $*" >&2; }
+fail() { printf '%b\n' "${RED}error:${RESET} $*" >&2; exit 1; }
+
+have() { command -v "$1" >/dev/null 2>&1; }
+
+check_node() {
+  have node || return 1
+  local major; major=$(node -p 'process.versions.node.split(".")[0]' 2>/dev/null || echo 0)
+  [ "$major" -ge 20 ] || return 1
+}
+
+pick_method() {
+  case "$METHOD" in
+    npm|docker) return 0 ;;
+    auto)
+      if check_node && have npm; then METHOD=npm
+      elif have docker; then METHOD=docker
+      else fail "neither node>=20 nor docker found. install one and re-run, or pick --method"
+      fi
+      ;;
+    *) fail "unknown --method '$METHOD' (use npm|docker|auto)" ;;
+  esac
+}
+
+install_npm() {
+  say "Installing Claude-B via npm"
+  if [ "$(id -u)" -ne 0 ] && [ ! -w "$(npm prefix -g 2>/dev/null || echo /usr/local)" ]; then
+    warn "global npm install may need sudo"
+    if have sudo; then
+      sudo npm install -g claude-b
+    else
+      npm install -g claude-b
+    fi
+  else
+    npm install -g claude-b
+  fi
+  say "${GREEN}✓ installed${RESET}: $(command -v cb)"
+}
+
+install_docker() {
+  say "Pulling Docker image ${GHCR_IMAGE}:latest"
+  docker pull "${GHCR_IMAGE}:latest"
+
+  local shim="/usr/local/bin/cb"
+  local data_dir="${HOME}/.claude-b"
+  mkdir -p "$data_dir"
+
+  say "Writing shim to ${shim}"
+  local shim_content
+  shim_content=$(cat <<EOF
+#!/usr/bin/env bash
+# Claude-B docker shim
+exec docker run --rm -it \\
+  -v "\${HOME}/.claude-b:/root/.claude-b" \\
+  --env-file "\${HOME}/.claude-b/.env" 2>/dev/null || \\
+exec docker run --rm -it \\
+  -v "\${HOME}/.claude-b:/root/.claude-b" \\
+  ${GHCR_IMAGE}:latest "\$@"
+EOF
+)
+  if [ -w "$(dirname "$shim")" ]; then
+    printf '%s\n' "$shim_content" > "$shim"
+    chmod +x "$shim"
+  elif have sudo; then
+    printf '%s\n' "$shim_content" | sudo tee "$shim" >/dev/null
+    sudo chmod +x "$shim"
+  else
+    fail "cannot write to $shim (no sudo). try --method npm or run as root."
+  fi
+  say "${GREEN}✓ installed${RESET}: $shim"
+}
+
+main() {
+  say "${BOLD}Claude-B installer${RESET}"
+  pick_method
+  say "Method: ${BOLD}${METHOD}${RESET}"
+
+  case "$METHOD" in
+    npm)    install_npm ;;
+    docker) install_docker ;;
+  esac
+
+  if [ "$SKIP_INIT" -eq 0 ]; then
+    say "Running ${BOLD}cb init${RESET} to configure your environment"
+    echo
+    cb init || warn "init skipped — rerun with: cb init"
+  else
+    say "Install complete. Configure with: ${BOLD}cb init${RESET}"
+  fi
+}
+
+main "$@"

package/start-daemon.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Claude-B daemon startup script for systemd
+# Cleans stale files, starts the daemon, then enables the REST API.
+
+set -euo pipefail
+
+SOCK="$HOME/.claude-b/daemon.sock"
+PID_FILE="$HOME/.claude-b/daemon.pid"
+REST_PORT="${CB_REST_PORT:-3847}"
+
+# Clean stale files from previous crash
+rm -f "$SOCK" "$PID_FILE"
+
+# Start daemon (foreground — systemd manages the process)
+exec /usr/bin/node /home/app/Claude-B/dist/daemon/index.js

package/website/deploy.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# Deploy the claude-b.danielmoya.cv / cb.danielmoya.cv landing container.
+#
+# Prerequisites:
+#   - Docker daemon reachable
+#   - NPM (Nginx Proxy Manager) running at http://localhost:81
+#   - NPM credentials exported:
+#       NPM_USER=daniel.moya@...
+#       NPM_PASSWORD=...
+#   - A record for claude-b.danielmoya.cv + cb.danielmoya.cv pointing at the server IP
+#
+# Usage:
+#   cd website && ./deploy.sh
+set -euo pipefail
+
+cd "$(dirname "$0")"
+
+# Keep install.sh in sync with scripts/install.sh (single source of truth)
+cp ../scripts/install.sh install.sh
+
+IMAGE="claude-b-landing:latest"
+CONTAINER="claude-b-landing"
+NETWORK="management-network"
+DOMAINS='["claude-b.danielmoya.cv","cb.danielmoya.cv"]'
+
+echo "==> Building $IMAGE"
+docker build -t "$IMAGE" .
+
+echo "==> Replacing container $CONTAINER"
+docker rm -f "$CONTAINER" 2>/dev/null || true
+docker run -d \
+  --name "$CONTAINER" \
+  --network "$NETWORK" \
+  --restart unless-stopped \
+  "$IMAGE"
+
+# Create/update NPM proxy host
+: "${NPM_USER:?export NPM_USER (see ~/.npm-credentials)}"
+: "${NPM_PASSWORD:?export NPM_PASSWORD (see ~/.npm-credentials)}"
+
+echo "==> Authenticating with NPM"
+TOKEN=$(curl -fsS -X POST "http://localhost:81/api/tokens" \
+  -H "Content-Type: application/json" \
+  -d "{\"identity\":\"$NPM_USER\",\"secret\":\"$NPM_PASSWORD\"}" \
+  | python3 -c 'import json,sys; print(json.load(sys.stdin)["token"])')
+
+echo "==> Creating/updating proxy host"
+HOST_ID=$(curl -fsS "http://localhost:81/api/nginx/proxy-hosts" \
+  -H "Authorization: Bearer $TOKEN" \
+  | python3 -c "
+import json, sys
+hosts = json.load(sys.stdin)
+for h in hosts:
+    if 'cb.danielmoya.cv' in h['domain_names'] or 'claude-b.danielmoya.cv' in h['domain_names']:
+        print(h['id']); break
+")
+
+PAYLOAD=$(cat <<EOF
+{
+  "domain_names": $DOMAINS,
+  "forward_scheme": "http",
+  "forward_host": "$CONTAINER",
+  "forward_port": 80,
+  "allow_websocket_upgrade": false,
+  "block_exploits": true,
+  "caching_enabled": true,
+  "http2_support": true,
+  "advanced_config": "add_header X-Content-Type-Options nosniff;"
+}
+EOF
+)
+
+if [ -n "$HOST_ID" ]; then
+  echo "  → Updating existing proxy host $HOST_ID"
+  curl -fsS -X PUT "http://localhost:81/api/nginx/proxy-hosts/$HOST_ID" \
+    -H "Authorization: Bearer $TOKEN" \
+    -H "Content-Type: application/json" \
+    -d "$PAYLOAD" >/dev/null
+else
+  echo "  → Creating new proxy host"
+  NEW=$(curl -fsS -X POST "http://localhost:81/api/nginx/proxy-hosts" \
+    -H "Authorization: Bearer $TOKEN" \
+    -H "Content-Type: application/json" \
+    -d "$PAYLOAD")
+  HOST_ID=$(printf '%s' "$NEW" | python3 -c 'import json,sys; print(json.load(sys.stdin)["id"])')
+fi
+
+echo "==> Requesting Let's Encrypt cert"
+# NPM's create-cert schema only accepts a minimal meta — letsencrypt_email / agree
+# are pulled from settings, not the request body.
+CERT_ID=$(curl -fsS -X POST "http://localhost:81/api/nginx/certificates" \
+  -H "Authorization: Bearer $TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "{\"provider\":\"letsencrypt\",\"nice_name\":\"cb.danielmoya.cv\",\"domain_names\":$DOMAINS,\"meta\":{\"dns_challenge\":false}}" \
+  | python3 -c 'import json,sys; print(json.load(sys.stdin)["id"])' 2>/dev/null || echo "")
+
+if [ -n "$CERT_ID" ]; then
+  echo "  → Attaching cert $CERT_ID to proxy host $HOST_ID"
+  curl -fsS -X PUT "http://localhost:81/api/nginx/proxy-hosts/$HOST_ID" \
+    -H "Authorization: Bearer $TOKEN" \
+    -H "Content-Type: application/json" \
+    -d "$(printf '%s' "$PAYLOAD" | python3 -c "
+import json, sys
+d = json.load(sys.stdin)
+d.update({'certificate_id': $CERT_ID, 'ssl_forced': True, 'hsts_enabled': True})
+print(json.dumps(d))
+")" >/dev/null
+fi
+
+echo
+echo "✓ Deployed. Test with:"
+echo "    curl -fsSL https://cb.danielmoya.cv | head"

package/website/index.html

@@ -0,0 +1,73 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Claude-B — background Claude Code</title>
+  <meta name="description" content="Claude-B: background-capable Claude Code with async workflows, Telegram bot, and multi-host orchestration." />
+  <style>
+    :root {
+      --bg: #0b0d10; --fg: #e6edf3; --mute: #8b949e; --accent: #79c0ff; --border: #30363d;
+      --code-bg: #161b22;
+    }
+    * { box-sizing: border-box; }
+    html, body { margin: 0; padding: 0; background: var(--bg); color: var(--fg); font-family: ui-monospace, 'SF Mono', Menlo, Consolas, monospace; line-height: 1.55; }
+    main { max-width: 720px; margin: 0 auto; padding: 4rem 1.5rem 6rem; }
+    h1 { font-size: 2rem; margin: 0 0 0.25rem; }
+    h2 { font-size: 1.15rem; margin: 2.5rem 0 0.75rem; color: var(--accent); }
+    .tag { color: var(--mute); font-size: 0.95rem; margin-bottom: 2.5rem; }
+    pre {
+      background: var(--code-bg);
+      border: 1px solid var(--border);
+      border-radius: 6px;
+      padding: 1rem 1.1rem;
+      overflow-x: auto;
+      font-size: 0.92rem;
+    }
+    code { color: var(--accent); }
+    pre code { color: var(--fg); }
+    a { color: var(--accent); }
+    ul { padding-left: 1.25rem; }
+    li { margin: 0.3rem 0; }
+    .cta { display: inline-block; margin-top: 0.5rem; font-size: 0.9rem; color: var(--mute); }
+    .footer { margin-top: 4rem; color: var(--mute); font-size: 0.85rem; }
+  </style>
+</head>
+<body>
+  <main>
+    <h1>Claude-B</h1>
+    <p class="tag">Background-capable Claude Code — async workflows, Telegram bot, REST API.</p>
+
+    <h2>Install</h2>
+    <pre><code>curl -fsSL https://cb.danielmoya.cv | bash</code></pre>
+    <p class="cta">Auto-detects <code>npm</code> or <code>docker</code>. Use <code>--method docker</code> to force.</p>
+
+    <h2>Configure</h2>
+    <pre><code>cb init</code></pre>
+    <p class="cta">Interactive wizard — connects the Telegram bot and writes <code>~/.claude-b/.env</code>.</p>
+
+    <h2>What you get</h2>
+    <ul>
+      <li>Background Claude Code sessions with async prompts</li>
+      <li>Telegram bot for remote control + voice notes (Whisper + TTS)</li>
+      <li>REST API + WebSocket for programmatic access</li>
+      <li>Multi-host orchestration across machines</li>
+    </ul>
+
+    <h2>Manual install</h2>
+    <pre><code># npm
+npm i -g claude-b
+
+# Docker
+docker run -d \
+  -v ~/.claude-b:/root/.claude-b \
+  --env-file ~/.claude-b/.env \
+  ghcr.io/danimoya/claude-b:latest</code></pre>
+
+    <p class="footer">
+      Source: <a href="https://github.com/danimoya/Claude-B">github.com/danimoya/Claude-B</a> ·
+      License: AGPL-3.0
+    </p>
+  </main>
+</body>
+</html>

package/website/install.sh

@@ -0,0 +1,124 @@
+#!/usr/bin/env bash
+# Claude-B installer
+# Usage:
+#   curl -fsSL https://cb.danielmoya.cv | bash
+#   curl -fsSL https://cb.danielmoya.cv | bash -s -- --method npm
+#
+# Methods (auto-detected, override with --method):
+#   npm     — requires node >= 20
+#   docker  — pulls ghcr.io/danimoya/claude-b:latest
+#   auto    — prefers npm, falls back to docker (default)
+set -euo pipefail
+
+REPO="${CLAUDE_B_REPO:-danimoya/Claude-B}"
+GHCR_IMAGE="ghcr.io/${REPO,,}"
+METHOD="auto"
+SKIP_INIT=0
+
+for arg in "$@"; do
+  case "$arg" in
+    --method=*) METHOD="${arg#*=}" ;;
+    --method) shift; METHOD="${1:-auto}" ;;
+    --skip-init) SKIP_INIT=1 ;;
+    -h|--help)
+      sed -n '2,12p' "$0" | sed 's/^# \{0,1\}//'
+      exit 0
+      ;;
+  esac
+done
+
+RESET='\033[0m'; BOLD='\033[1m'; GREEN='\033[32m'; YELLOW='\033[33m'; RED='\033[31m'; GRAY='\033[90m'
+
+say()  { printf '%b\n' "${BOLD}==>${RESET} $*"; }
+warn() { printf '%b\n' "${YELLOW}warning:${RESET} $*" >&2; }
+fail() { printf '%b\n' "${RED}error:${RESET} $*" >&2; exit 1; }
+
+have() { command -v "$1" >/dev/null 2>&1; }
+
+check_node() {
+  have node || return 1
+  local major; major=$(node -p 'process.versions.node.split(".")[0]' 2>/dev/null || echo 0)
+  [ "$major" -ge 20 ] || return 1
+}
+
+pick_method() {
+  case "$METHOD" in
+    npm|docker) return 0 ;;
+    auto)
+      if check_node && have npm; then METHOD=npm
+      elif have docker; then METHOD=docker
+      else fail "neither node>=20 nor docker found. install one and re-run, or pick --method"
+      fi
+      ;;
+    *) fail "unknown --method '$METHOD' (use npm|docker|auto)" ;;
+  esac
+}
+
+install_npm() {
+  say "Installing Claude-B via npm"
+  if [ "$(id -u)" -ne 0 ] && [ ! -w "$(npm prefix -g 2>/dev/null || echo /usr/local)" ]; then
+    warn "global npm install may need sudo"
+    if have sudo; then
+      sudo npm install -g claude-b
+    else
+      npm install -g claude-b
+    fi
+  else
+    npm install -g claude-b
+  fi
+  say "${GREEN}✓ installed${RESET}: $(command -v cb)"
+}
+
+install_docker() {
+  say "Pulling Docker image ${GHCR_IMAGE}:latest"
+  docker pull "${GHCR_IMAGE}:latest"
+
+  local shim="/usr/local/bin/cb"
+  local data_dir="${HOME}/.claude-b"
+  mkdir -p "$data_dir"
+
+  say "Writing shim to ${shim}"
+  local shim_content
+  shim_content=$(cat <<EOF
+#!/usr/bin/env bash
+# Claude-B docker shim
+exec docker run --rm -it \\
+  -v "\${HOME}/.claude-b:/root/.claude-b" \\
+  --env-file "\${HOME}/.claude-b/.env" 2>/dev/null || \\
+exec docker run --rm -it \\
+  -v "\${HOME}/.claude-b:/root/.claude-b" \\
+  ${GHCR_IMAGE}:latest "\$@"
+EOF
+)
+  if [ -w "$(dirname "$shim")" ]; then
+    printf '%s\n' "$shim_content" > "$shim"
+    chmod +x "$shim"
+  elif have sudo; then
+    printf '%s\n' "$shim_content" | sudo tee "$shim" >/dev/null
+    sudo chmod +x "$shim"
+  else
+    fail "cannot write to $shim (no sudo). try --method npm or run as root."
+  fi
+  say "${GREEN}✓ installed${RESET}: $shim"
+}
+
+main() {
+  say "${BOLD}Claude-B installer${RESET}"
+  pick_method
+  say "Method: ${BOLD}${METHOD}${RESET}"
+
+  case "$METHOD" in
+    npm)    install_npm ;;
+    docker) install_docker ;;
+  esac
+
+  if [ "$SKIP_INIT" -eq 0 ]; then
+    say "Running ${BOLD}cb init${RESET} to configure your environment"
+    echo
+    cb init || warn "init skipped — rerun with: cb init"
+  else
+    say "Install complete. Configure with: ${BOLD}cb init${RESET}"
+  fi
+}
+
+main "$@"

package/website/nginx.conf

@@ -0,0 +1,30 @@
+server {
+  listen 80 default_server;
+  server_name _;
+
+  root /usr/share/nginx/html;
+
+  # Default: serve install.sh when hit by curl/wget/other scripts,
+  # serve landing page when hit by browsers.
+  location = / {
+    default_type application/octet-stream;
+    if ($http_user_agent ~* "(curl|wget|fetch|HTTPie|Go-http-client|PowerShell)") {
+      rewrite ^ /install.sh last;
+    }
+    rewrite ^ /index.html last;
+  }
+
+  location = /install.sh {
+    add_header Content-Type text/x-shellscript;
+    add_header Cache-Control "public, max-age=300";
+  }
+
+  location = /install {
+    rewrite ^ /install.sh last;
+  }
+
+  # Static landing page + assets
+  location / {
+    try_files $uri $uri/ =404;
+  }
+}