@atercates/claude-deck 0.2.1

package/package.json

@@ -0,0 +1,139 @@
+{
+  "name": "@atercates/claude-deck",
+  "version": "0.2.1",
+  "description": "Self-hosted web UI for managing Claude Code sessions",
+  "bin": {
+    "claude-deck": "./scripts/claude-deck"
+  },
+  "files": [
+    "app/",
+    "components/",
+    "contexts/",
+    "data/",
+    "hooks/",
+    "lib/",
+    "mcp/",
+    "public/",
+    "scripts/",
+    "stores/",
+    "styles/",
+    "next.config.js",
+    "postcss.config.mjs",
+    "server.ts",
+    "tailwind.config.ts",
+    "tsconfig.json",
+    "package-lock.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atercates/claude-deck.git"
+  },
+  "keywords": [
+    "claude",
+    "ai",
+    "terminal",
+    "tmux",
+    "agent"
+  ],
+  "author": "Saad Naveed",
+  "license": "MIT",
+  "engines": {
+    "node": ">=24"
+  },
+  "bugs": {
+    "url": "https://github.com/atercates/claude-deck/issues"
+  },
+  "homepage": "https://github.com/atercates/claude-deck#readme",
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.104",
+    "@codemirror/lang-css": "^6.3.1",
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/lang-python": "^6.2.1",
+    "@codemirror/language": "^6.12.3",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/view": "^6.41.0",
+    "@lezer/highlight": "^1.2.3",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@monaco-editor/react": "^4.7.0",
+    "@radix-ui/react-context-menu": "^2.2.16",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-scroll-area": "^1.2.10",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-slot": "^1.2.4",
+    "@radix-ui/react-switch": "^1.2.6",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@tailwindcss/typography": "^0.5.19",
+    "@tanstack/react-query": "^5.97.0",
+    "@tanstack/react-query-devtools": "^5.97.0",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "@uiw/react-codemirror": "^4.25.9",
+    "@xterm/addon-canvas": "^0.7.0",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/addon-search": "^0.16.0",
+    "@xterm/addon-web-links": "^0.12.0",
+    "@xterm/xterm": "^6.0.0",
+    "better-sqlite3": "^12.8.0",
+    "chokidar": "^5.0.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "highlight.js": "^11.11.1",
+    "lucide-react": "^1.8.0",
+    "monaco-editor": "^0.55.1",
+    "next": "^16.2.3",
+    "next-themes": "^0.4.6",
+    "node-pty": "1.2.0-beta.12",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "react-markdown": "^10.1.0",
+    "react-resizable-panels": "^4.9.0",
+    "react-syntax-highlighter": "^16.1.1",
+    "remark-gfm": "^4.0.1",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.5.0",
+    "valtio": "^2.3.1",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.3.5",
+    "@next/eslint-plugin-next": "^16.2.3",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@tauri-apps/api": "^2.10.1",
+    "@tauri-apps/cli": "^2.10.1",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@types/ws": "^8.18.1",
+    "eslint": "^10.2.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "husky": "^9.1.7",
+    "prettier": "^3.8.2",
+    "prettier-plugin-tailwindcss": "^0.7.2",
+    "tailwindcss": "^4.2.2",
+    "tsx": "^4.21.0",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.58.1"
+  },
+  "scripts": {
+    "dev": "tsx --env-file=.env server.ts",
+    "build": "next build",
+    "start": "NODE_ENV=production tsx --env-file=.env server.ts",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "typecheck": "tsc --noEmit",
+    "setup": "bash scripts/setup.sh",
+    "postinstall": "chmod +x node_modules/node-pty/prebuilds/*/spawn-helper 2>/dev/null || true",
+    "tauri": "tauri",
+    "tauri:dev": "tauri dev",
+    "tauri:build": "tauri build",
+    "tauri:build:linux": "docker build -t agentos-linux -f src-tauri/Dockerfile.linux src-tauri && docker run --rm -v $(pwd)/src-tauri/target:/app/target agentos-linux"
+  }
+}

package/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/public/icon.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <g stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" fill="none">
+    <path d="M12 8V4H8" />
+    <rect width="16" height="12" x="4" y="8" rx="2" />
+    <path d="M2 14h2" />
+    <path d="M20 14h2" />
+    <path d="M15 13v2" />
+    <path d="M9 13v2" />
+  </g>
+</svg>

package/public/manifest.json

@@ -0,0 +1,61 @@
+{
+  "name": "ClaudeDeck",
+  "short_name": "ClaudeDeck",
+  "description": "AI Agent Command Center",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#0a0a0a",
+  "theme_color": "#0a0a0a",
+  "orientation": "any",
+  "scope": "/",
+  "icons": [
+    {
+      "src": "/icons/icon-72x72.png",
+      "sizes": "72x72",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-96x96.png",
+      "sizes": "96x96",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-128x128.png",
+      "sizes": "128x128",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-144x144.png",
+      "sizes": "144x144",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-152x152.png",
+      "sizes": "152x152",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-384x384.png",
+      "sizes": "384x384",
+      "type": "image/png",
+      "purpose": "maskable any"
+    },
+    {
+      "src": "/icons/icon-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png",
+      "purpose": "maskable any"
+    }
+  ]
+}

package/public/sw.js

@@ -0,0 +1,64 @@
+const CACHE_NAME = "agent-os-v1";
+const urlsToCache = ["/manifest.json"];
+
+self.addEventListener("install", (event) => {
+  event.waitUntil(
+    caches.open(CACHE_NAME).then((cache) => cache.addAll(urlsToCache))
+  );
+  self.skipWaiting();
+});
+
+self.addEventListener("fetch", (event) => {
+  const url = event.request.url;
+
+  if (url.includes("/api/") || url.includes("/ws")) {
+    return;
+  }
+
+  if (event.request.mode === "navigate") {
+    event.respondWith(
+      fetch(event.request).catch(
+        () =>
+          new Response("<h1>Offline</h1><p>Please check your connection.</p>", {
+            headers: { "Content-Type": "text/html" },
+          })
+      )
+    );
+    return;
+  }
+
+  if (url.includes("/_next/static/")) {
+    event.respondWith(
+      caches.match(event.request).then((cached) => {
+        if (cached) return cached;
+        return fetch(event.request).then((response) => {
+          const clone = response.clone();
+          caches
+            .open(CACHE_NAME)
+            .then((cache) => cache.put(event.request, clone));
+          return response;
+        });
+      })
+    );
+    return;
+  }
+
+  event.respondWith(
+    fetch(event.request).catch(() => caches.match(event.request))
+  );
+});
+
+self.addEventListener("activate", (event) => {
+  event.waitUntil(
+    caches
+      .keys()
+      .then((cacheNames) =>
+        Promise.all(
+          cacheNames
+            .filter((name) => name !== CACHE_NAME)
+            .map((name) => caches.delete(name))
+        )
+      )
+  );
+  self.clients.claim();
+});

package/scripts/agent-os

@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+#
+# AgentOS - Self-hosted AI coding session manager
+# https://github.com/anthropics/agent-os
+#
+
+set -euo pipefail
+
+# Configuration
+AGENT_OS_HOME="${AGENT_OS_HOME:-$HOME/.agent-os}"
+PORT="${AGENT_OS_PORT:-3011}"
+REPO_URL="https://github.com/atercates/agent-os.git"
+
+# Derived paths
+REPO_DIR="$AGENT_OS_HOME/repo"
+PID_FILE="$AGENT_OS_HOME/agent-os.pid"
+LOG_FILE="$AGENT_OS_HOME/agent-os.log"
+
+# Detect OS
+OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+[[ "$OS" == "darwin" ]] && OS="macos"
+
+# Source Homebrew if available (ensures npm/node/etc are in PATH)
+if [[ "$OS" == "macos" ]]; then
+    if [[ -f /opt/homebrew/bin/brew ]]; then
+        eval "$(/opt/homebrew/bin/brew shellenv)"
+    elif [[ -f /usr/local/bin/brew ]]; then
+        eval "$(/usr/local/bin/brew shellenv)"
+    fi
+fi
+
+# Source fnm if available (for non-admin users who installed via fnm)
+if [[ -d "$HOME/.local/share/fnm" ]]; then
+    export PATH="$HOME/.local/share/fnm:$PATH"
+    eval "$(fnm env --use-on-cd 2>/dev/null || true)"
+fi
+
+# Add ~/.local/bin to PATH (for ripgrep and other binaries installed for non-admin users)
+if [[ -d "$HOME/.local/bin" ]]; then
+    export PATH="$HOME/.local/bin:$PATH"
+fi
+
+# Styling
+BOLD='\033[1m'
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Find script directory (works even when called via symlink)
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+    SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+    SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+    [[ "$SCRIPT_PATH" != /* ]] && SCRIPT_PATH="$SCRIPT_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+
+# Local repo path (parent of scripts dir) - used for --local installs
+LOCAL_REPO="$(dirname "$SCRIPT_DIR")"
+
+# Source library files
+source "$SCRIPT_DIR/lib/common.sh"
+source "$SCRIPT_DIR/lib/prerequisites.sh"
+source "$SCRIPT_DIR/lib/ai-clis.sh"
+source "$SCRIPT_DIR/lib/commands.sh"
+
+# Main
+case "${1:-}" in
+    install)          cmd_install "${2:-}" ;;
+    start)            cmd_start ;;
+    stop)             cmd_stop ;;
+    restart)          cmd_restart ;;
+    run)              cmd_run ;;
+    status)           cmd_status ;;
+    logs)             cmd_logs ;;
+    update)           cmd_update ;;
+    enable)           cmd_enable ;;
+    disable)          cmd_disable ;;
+    uninstall)        cmd_uninstall ;;
+    start-foreground) cmd_start_foreground ;;
+    help|--help|-h)   cmd_help ;;
+    *)
+        if [[ -n "${1:-}" ]]; then
+            log_error "Unknown command: $1"
+        fi
+        cmd_help
+        exit 1
+        ;;
+esac

package/scripts/install.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+#
+# ClaudeDeck Installer
+#
+# Usage:
+#   curl -fsSL https://raw.githubusercontent.com/atercates/claude-deck/main/scripts/install.sh | bash
+#
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+BOLD='\033[1m'
+NC='\033[0m'
+
+log_info() { echo -e "${BLUE}==>${NC} $1"; }
+log_success() { echo -e "${GREEN}==>${NC} $1"; }
+log_error() { echo -e "${RED}==>${NC} $1"; }
+
+REPO_URL="https://github.com/atercates/claude-deck.git"
+INSTALL_DIR="$HOME/.claude-deck/repo"
+
+echo ""
+echo -e "${BOLD}ClaudeDeck Installer${NC}"
+echo ""
+
+# Check for git
+if ! command -v git &> /dev/null; then
+    log_error "git is required. Please install git first."
+    exit 1
+fi
+
+# Clone or update repo
+if [[ -d "$INSTALL_DIR" ]]; then
+    log_info "Updating existing installation..."
+    cd "$INSTALL_DIR"
+    git pull --ff-only
+else
+    log_info "Downloading ClaudeDeck..."
+    mkdir -p "$(dirname "$INSTALL_DIR")"
+    git clone "$REPO_URL" "$INSTALL_DIR"
+    cd "$INSTALL_DIR"
+fi
+
+# Run the install command
+exec "$INSTALL_DIR/scripts/claude-deck" install

package/scripts/lib/ai-clis.sh

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+# AI CLI detection and installation for claude-deck
+
+detect_ai_clis() {
+    local installed=()
+
+    command -v claude &> /dev/null && installed+=("claude")
+    command -v codex &> /dev/null && installed+=("codex")
+    command -v opencode &> /dev/null && installed+=("opencode")
+    command -v gemini &> /dev/null && installed+=("gemini")
+    command -v aider &> /dev/null && installed+=("aider")
+    command -v cursor &> /dev/null && installed+=("cursor")
+
+    echo "${installed[*]}"
+}
+
+install_claude_code() {
+    if command -v claude &> /dev/null; then
+        log_success "Claude Code already installed"
+        return 0
+    fi
+
+    log_info "Installing Claude Code..."
+    curl -fsSL https://claude.ai/install.sh | bash
+
+    if is_interactive; then
+        log_info "Authenticating Claude Code..."
+        echo ""
+        echo "Please complete the authentication in your browser."
+        read -p "Press Enter when ready to continue..." -r
+        claude auth login
+    else
+        log_info "Run 'claude' to authenticate when ready"
+    fi
+}
+
+install_codex() {
+    if command -v codex &> /dev/null; then
+        log_success "Codex already installed"
+        return 0
+    fi
+
+    log_info "Installing Codex..."
+    npm install -g @openai/codex
+
+    log_info "Authenticating Codex..."
+    echo ""
+    echo "Please set your OPENAI_API_KEY environment variable."
+    echo "Get your key at: https://platform.openai.com/api-keys"
+}
+
+install_aider() {
+    if command -v aider &> /dev/null; then
+        log_success "Aider already installed"
+        return 0
+    fi
+
+    log_info "Installing Aider..."
+
+    if command -v pipx &> /dev/null; then
+        pipx install aider-chat
+    elif command -v pip3 &> /dev/null; then
+        pip3 install aider-chat
+    else
+        log_error "Please install Python/pip first, then run: pip install aider-chat"
+        return 1
+    fi
+}
+
+install_gemini_cli() {
+    if command -v gemini &> /dev/null; then
+        log_success "Gemini CLI already installed"
+        return 0
+    fi
+
+    log_info "Installing Gemini CLI..."
+    npm install -g @google/gemini-cli 2>/dev/null || npm install -g gemini-cli
+
+    log_info "Authenticating Gemini CLI..."
+    echo ""
+    echo "Please complete the authentication."
+    gemini auth login 2>/dev/null || true
+}
+
+prompt_ai_cli_install() {
+    local installed
+    installed=$(detect_ai_clis)
+
+    if [[ -n "$installed" ]]; then
+        log_success "Found AI CLI(s): $installed"
+        return 0
+    fi
+
+    echo ""
+    log_warn "No AI coding CLI detected"
+    echo ""
+    echo "ClaudeDeck supports these AI coding assistants:"
+    echo ""
+    echo "  1) Claude Code (Anthropic) - Recommended"
+    echo "  2) Codex (OpenAI)"
+    echo "  3) Aider (Multi-LLM)"
+    echo "  4) Gemini CLI (Google)"
+    echo "  5) Skip - I'll install one myself"
+    echo ""
+
+    if ! is_interactive; then
+        log_info "Non-interactive mode: Installing Claude Code by default"
+        install_claude_code
+        return
+    fi
+
+    read -p "Which would you like to install? [1-5, default: 1] " -r choice
+    echo ""
+
+    case "${choice:-1}" in
+        1) install_claude_code ;;
+        2) install_codex ;;
+        3) install_aider ;;
+        4) install_gemini_cli ;;
+        5)
+            log_info "Skipping AI CLI installation"
+            echo ""
+            echo "Install one of these before using ClaudeDeck:"
+            echo "  Claude Code: npm install -g @anthropic-ai/claude-code"
+            echo "  Codex:       npm install -g @openai/codex"
+            echo "  Aider:       pip install aider-chat"
+            echo "  Gemini:      npm install -g gemini-cli"
+            echo ""
+            ;;
+        *) log_warn "Invalid choice, skipping" ;;
+    esac
+}