claudepod 1.2.2 → 1.3.1

package/.devcontainer/features/agent-browser/install.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+set -euo pipefail
+
+VERSION="${VERSION:-latest}"
+USERNAME="${USERNAME:-automatic}"
+
+# Set headless as default for containers (bundled Chromium, no display needed)
+export AGENT_BROWSER_HEADLESS=true
+
+echo "[agent-browser] Starting installation..."
+echo "[agent-browser] Version: ${VERSION}"
+
+# Source nvm if available
+if [ -f /usr/local/share/nvm/nvm.sh ]; then
+    source /usr/local/share/nvm/nvm.sh
+fi
+
+# Validate npm is available
+if ! command -v npm &>/dev/null; then
+    echo "[agent-browser] ERROR: npm not available"
+    echo "  Ensure node feature is installed first"
+    exit 1
+fi
+
+# Detect user
+if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
+    if [ -n "${_REMOTE_USER:-}" ]; then
+        USERNAME="${_REMOTE_USER}"
+    elif getent passwd vscode >/dev/null 2>&1; then
+        USERNAME="vscode"
+    elif getent passwd node >/dev/null 2>&1; then
+        USERNAME="node"
+    elif getent passwd codespace >/dev/null 2>&1; then
+        USERNAME="codespace"
+    else
+        USERNAME="root"
+    fi
+fi
+
+echo "[agent-browser] Installing for user: ${USERNAME}"
+
+# Install via npm
+if [ "${VERSION}" = "latest" ]; then
+    NPM_PACKAGE="agent-browser"
+else
+    NPM_PACKAGE="agent-browser@${VERSION}"
+fi
+
+npm install -g "${NPM_PACKAGE}" 2>/dev/null || {
+    echo "[agent-browser] WARNING: Global install failed, trying user install"
+    su - "${USERNAME}" -c "npm install -g ${NPM_PACKAGE}" 2>/dev/null || true
+}
+
+# Download Chromium and install system dependencies
+echo "[agent-browser] Installing Chromium and system dependencies..."
+agent-browser install --with-deps 2>/dev/null || {
+    echo "[agent-browser] WARNING: Chromium install with deps failed, trying without --with-deps"
+    agent-browser install 2>/dev/null || true
+}
+
+echo "[agent-browser] Installed: $(agent-browser --version 2>/dev/null || echo 'unknown')"
+echo "[agent-browser] Installation complete"
+echo ""
+echo "Usage:"
+echo "  agent-browser open <url>     # Open a page"
+echo "  agent-browser snapshot       # Get accessibility tree"
+echo "  agent-browser screenshot     # Capture screenshot"
+echo "  agent-browser close          # Close browser"
+echo ""
+echo "Host Chrome connection (if container browser insufficient):"
+echo "  # Start Chrome on host with: chrome --remote-debugging-port=9222"
+echo "  agent-browser connect 9222"

package/.devcontainer/features/lsp-servers/devcontainer-feature.json

@@ -2,7 +2,7 @@
   "id": "lsp-servers",
   "version": "1.0.0",
   "name": "LSP Servers for Claude Code",
-  "description": "Installs language server binaries for Python (pyright) and TypeScript (typescript-language-server)",
+  "description": "Installs language server binaries for Python (pyright), TypeScript (typescript-language-server), and Go (gopls)",
   "maintainer": "AnExiledDev",
   "documentationURL": "https://code.claude.com/docs/en/discover-plugins#code-intelligence",
   "options": {
@@ -21,6 +21,11 @@
       "description": "TypeScript npm package version (e.g., 'latest', '5.3.0')",
       "default": "latest"
     },
+    "goplsVersion": {
+      "type": "string",
+      "description": "gopls version (e.g., 'latest', 'v0.16.0')",
+      "default": "latest"
+    },
     "username": {
       "type": "string",
       "description": "Container user to install for",
@@ -29,6 +34,7 @@
   },
   "installsAfter": [
     "ghcr.io/devcontainers/features/common-utils:2",
-    "ghcr.io/devcontainers/features/node:1"
+    "ghcr.io/devcontainers/features/node:1",
+    "ghcr.io/devcontainers/features/go:1"
   ]
 }

package/.devcontainer/features/lsp-servers/install.sh

@@ -1,18 +1,20 @@
 #!/bin/bash
 # LSP Servers for Claude Code
-# Installs pyright and typescript-language-server binaries
+# Installs pyright, typescript-language-server, and gopls binaries
 
 set -euo pipefail
 
 PYRIGHT_VERSION="${PYRIGHTVERSION:-latest}"
 TSLSP_VERSION="${TYPESCRIPTLSPVERSION:-latest}"
 TS_VERSION="${TYPESCRIPTVERSION:-latest}"
+GOPLS_VERSION="${GOPLSVERSION:-latest}"
 USERNAME="${USERNAME:-automatic}"
 
 echo "[lsp-servers] Starting installation..."
 echo "[lsp-servers] Pyright version: ${PYRIGHT_VERSION}"
 echo "[lsp-servers] TypeScript LSP version: ${TSLSP_VERSION}"
 echo "[lsp-servers] TypeScript version: ${TS_VERSION}"
+echo "[lsp-servers] gopls version: ${GOPLS_VERSION}"
 
 # Source nvm if available
 if [ -f /usr/local/share/nvm/nvm.sh ]; then
@@ -73,6 +75,22 @@ install_npm_package "typescript" "typescript" "${TS_VERSION}"
 # Install TypeScript Language Server
 install_npm_package "typescript-language-server" "typescript-language-server" "${TSLSP_VERSION}"
 
+# Install gopls (Go LSP) - uses go install since it's a Go package
+echo "[lsp-servers] Installing gopls..."
+if command -v go &>/dev/null; then
+    if [ "${GOPLS_VERSION}" = "latest" ]; then
+        go install "golang.org/x/tools/gopls@latest" || {
+            echo "[lsp-servers] WARNING: Failed to install gopls"
+        }
+    else
+        go install "golang.org/x/tools/gopls@${GOPLS_VERSION}" || {
+            echo "[lsp-servers] WARNING: Failed to install gopls"
+        }
+    fi
+else
+    echo "[lsp-servers] WARNING: Go not available, skipping gopls"
+fi
+
 # Verify installations
 echo ""
 echo "[lsp-servers] Verifying installations..."
@@ -89,4 +107,10 @@ else
     echo "[lsp-servers] WARNING: typescript-language-server not found in PATH"
 fi
 
+if command -v gopls &>/dev/null; then
+    echo "[lsp-servers] gopls: $(gopls version 2>/dev/null | head -1 || echo 'installed')"
+else
+    echo "[lsp-servers] WARNING: gopls not found in PATH (Go may not be installed)"
+fi
+
 echo "[lsp-servers] Installation complete"

package/.devcontainer/features/notify-hook/README.md

@@ -0,0 +1,86 @@
+# notify-hook
+
+Desktop notifications and audio chime when Claude Code finishes responding.
+
+## How It Works
+
+This feature uses two terminal-based notification mechanisms that work inside devcontainers:
+
+| Mechanism | Purpose | Requirement |
+|-----------|---------|-------------|
+| OSC 777 escape sequence | Desktop notification popup | VSCode extension (auto-installed) |
+| Terminal bell (`\a`) | Audio chime | VSCode setting (auto-configured) |
+
+## Auto-Configured
+
+All requirements are automatically configured on container rebuild:
+
+- **Extension**: `wenbopan.vscode-terminal-osc-notifier` installed via devcontainer.json
+- **Setting**: `terminal.integrated.enableBell: true` set via devcontainer.json
+- **Hook**: Stop hook registered via plugin's hooks.json
+
+No manual user setup required.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `enableBell` | `true` | Enable terminal bell (audio chime) |
+| `enableOsc` | `true` | Enable OSC 777 desktop notifications |
+
+## Usage
+
+Once the container is rebuilt, notifications trigger automatically when Claude Code finishes responding.
+
+### Runtime Disable
+
+Temporarily disable notifications via environment variables:
+
+```bash
+# Disable audio chime
+export NOTIFY_ENABLE_BELL=false
+
+# Disable desktop notification
+export NOTIFY_ENABLE_OSC=false
+```
+
+### Manual Trigger
+
+Test the notification manually:
+
+```bash
+/usr/local/bin/claude-notify
+```
+
+## Custom Sound
+
+The terminal bell uses Windows "Default Beep" sound. For a custom AI-like chime:
+
+1. Open Windows Settings → Sound → Sound Control Panel
+2. Go to Sounds tab
+3. Find "Default Beep" in the list
+4. Change to a custom `.wav` file
+
+## Troubleshooting
+
+### No desktop notification
+
+1. Verify extension is installed (check VSCode Extensions panel)
+2. Check Windows notification settings allow VSCode notifications
+3. Test manually: `printf '\033]777;notify;Test;Message\007'`
+
+### No audio
+
+1. Verify VSCode setting is applied: `"terminal.integrated.enableBell": true`
+2. Check Windows sound is not muted
+3. Test manually: `printf '\a'`
+
+### Hook not triggering
+
+Check the plugin's hook file exists:
+
+```bash
+cat /workspaces/.devcontainer/plugins/devs-marketplace/plugins/notify-hook/hooks/hooks.json
+```
+
+Verify Claude Code is loading the devs-marketplace plugins in settings.

package/.devcontainer/features/notify-hook/devcontainer-feature.json

@@ -0,0 +1,23 @@
+{
+  "id": "notify-hook",
+  "version": "1.0.0",
+  "name": "Claude Code Notification Hook",
+  "description": "Desktop notifications and audio chime when Claude finishes responding",
+  "documentationURL": "https://github.com/AnExiledDev/ClaudePod",
+  "options": {
+    "enableBell": {
+      "type": "boolean",
+      "description": "Enable terminal bell (audio chime) on completion",
+      "default": true
+    },
+    "enableOsc": {
+      "type": "boolean",
+      "description": "Enable OSC 777 desktop notifications",
+      "default": true
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/common-utils:2",
+    "ghcr.io/anthropics/devcontainer-features/claude-code:1"
+  ]
+}

package/.devcontainer/features/notify-hook/install.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+set -euo pipefail
+
+ENABLEBELL="${ENABLEBELL:-true}"
+ENABLEOSC="${ENABLEOSC:-true}"
+
+echo "[notify-hook] Starting installation..."
+echo "[notify-hook] Bell enabled: ${ENABLEBELL}"
+echo "[notify-hook] OSC notifications enabled: ${ENABLEOSC}"
+
+# Create the notification script
+cat > /usr/local/bin/claude-notify << 'SCRIPT'
+#!/bin/bash
+# Claude Code notification script
+# Sends desktop notification (OSC 777) and terminal bell when Claude finishes
+
+ENABLE_BELL="${NOTIFY_ENABLE_BELL:-true}"
+ENABLE_OSC="${NOTIFY_ENABLE_OSC:-true}"
+PROJECT_NAME="${CLAUDE_PROJECT_NAME:-$(basename "${WORKSPACE_ROOT:-$(pwd)}")}"
+
+if [ "${ENABLE_OSC}" = "true" ]; then
+    printf '\033]777;notify;%s;%s\007' "Claude Code" "Ready for input [${PROJECT_NAME}]"
+fi
+
+if [ "${ENABLE_BELL}" = "true" ]; then
+    printf '\a'
+fi
+SCRIPT
+
+chmod +x /usr/local/bin/claude-notify
+
+# Store feature options as environment defaults
+cat > /etc/profile.d/notify-hook.sh << EOF
+export NOTIFY_ENABLE_BELL="${ENABLEBELL}"
+export NOTIFY_ENABLE_OSC="${ENABLEOSC}"
+EOF
+
+echo "[notify-hook] Installation complete"

package/.devcontainer/plugins/devs-marketplace/.claude-plugin/marketplace.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "devs-marketplace",
+  "description": "ClaudePod plugin marketplace for development tools",
+  "owner": {
+    "name": "AnExiledDev"
+  },
+  "plugins": [
+    {
+      "name": "claudepod-lsp",
+      "description": "LSP servers for ClaudePod (Python, TypeScript, Go)",
+      "version": "1.0.0",
+      "source": "./plugins/claudepod-lsp",
+      "category": "development",
+      "lspServers": {
+        "pyright": {
+          "command": "pyright-langserver",
+          "args": ["--stdio"],
+          "extensionToLanguage": {
+            ".py": "python",
+            ".pyi": "python"
+          }
+        },
+        "typescript": {
+          "command": "typescript-language-server",
+          "args": ["--stdio"],
+          "extensionToLanguage": {
+            ".ts": "typescript",
+            ".tsx": "typescriptreact",
+            ".js": "javascript",
+            ".jsx": "javascriptreact",
+            ".mts": "typescript",
+            ".cts": "typescript",
+            ".mjs": "javascript",
+            ".cjs": "javascript"
+          }
+        },
+        "gopls": {
+          "command": "gopls",
+          "args": ["serve"],
+          "extensionToLanguage": {
+            ".go": "go",
+            ".mod": "go.mod",
+            ".sum": "go.sum"
+          }
+        }
+      }
+    },
+    {
+      "name": "ticket-workflow",
+      "description": "EARS-based ticket workflow with GitHub integration",
+      "version": "1.0.0",
+      "source": "./plugins/ticket-workflow",
+      "category": "workflow"
+    },
+    {
+      "name": "notify-hook",
+      "description": "Desktop notifications and audio chime when Claude finishes responding",
+      "version": "1.0.0",
+      "source": "./plugins/notify-hook",
+      "category": "productivity"
+    },
+    {
+      "name": "planning-reminder",
+      "description": "Encourages plan-before-implement workflow",
+      "version": "1.0.0",
+      "source": "./plugins/planning-reminder",
+      "category": "workflow"
+    },
+    {
+      "name": "dangerous-command-blocker",
+      "description": "Blocks dangerous bash commands (rm -rf, sudo rm, chmod 777, force push)",
+      "version": "1.0.0",
+      "source": "./plugins/dangerous-command-blocker",
+      "category": "safety"
+    },
+    {
+      "name": "protected-files-guard",
+      "description": "Blocks modifications to .env, lock files, .git/, and credentials",
+      "version": "1.0.0",
+      "source": "./plugins/protected-files-guard",
+      "category": "safety"
+    },
+    {
+      "name": "auto-formatter",
+      "description": "Auto-formats files after editing (black for Python, gofmt for Go)",
+      "version": "1.0.0",
+      "source": "./plugins/auto-formatter",
+      "category": "development"
+    },
+    {
+      "name": "auto-linter",
+      "description": "Auto-lints files after editing (pyright for Python)",
+      "version": "1.0.0",
+      "source": "./plugins/auto-linter",
+      "category": "development"
+    }
+  ]
+}

package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/.claude-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "auto-formatter",
+  "description": "Auto-formats files after editing (black for Python, gofmt for Go)",
+  "author": {
+    "name": "AnExiledDev"
+  }
+}

package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/hooks/hooks.json

@@ -0,0 +1,17 @@
+{
+  "description": "Auto-format files after editing",
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/format-file.py",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

package/.devcontainer/plugins/devs-marketplace/plugins/auto-formatter/scripts/format-file.py

@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+"""
+Auto-format files after editing.
+
+Reads tool input from stdin, detects file type by extension,
+runs appropriate formatter if available.
+Outputs JSON with additionalContext on success.
+Non-blocking: exit 0 regardless of formatting result.
+"""
+
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+# Formatter configuration: extension -> (command, args, name)
+FORMATTERS = {
+    ".py": ("/usr/local/py-utils/bin/black", ["--quiet"], "Black"),
+    ".pyi": ("/usr/local/py-utils/bin/black", ["--quiet"], "Black"),
+    ".go": ("/usr/local/go/bin/gofmt", ["-w"], "gofmt"),
+}
+
+
+def get_formatter(file_path: str) -> tuple[str, list[str], str] | None:
+    """Get formatter config for file extension."""
+    ext = Path(file_path).suffix.lower()
+    return FORMATTERS.get(ext)
+
+
+def format_file(file_path: str) -> tuple[bool, str]:
+    """Run formatter on file.
+
+    Returns:
+        (success, message)
+    """
+    formatter = get_formatter(file_path)
+    if formatter is None:
+        return True, ""  # No formatter available, that's OK
+
+    cmd_path, args, name = formatter
+
+    # Check if formatter exists
+    if not os.path.exists(cmd_path):
+        return True, f"[Auto-formatter] {name} not found, skipping"
+
+    # Check if file exists
+    if not os.path.exists(file_path):
+        return True, ""
+
+    try:
+        # Run formatter
+        cmd = [cmd_path] + args + [file_path]
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=25
+        )
+
+        if result.returncode == 0:
+            return True, f"[Auto-formatter] Formatted with {name}"
+        else:
+            # Formatting failed, but don't block
+            error = result.stderr.strip() if result.stderr else "Unknown error"
+            return True, f"[Auto-formatter] {name} warning: {error}"
+
+    except subprocess.TimeoutExpired:
+        return True, f"[Auto-formatter] {name} timed out"
+    except Exception as e:
+        return True, f"[Auto-formatter] Error: {e}"
+
+
+def main():
+    try:
+        input_data = json.load(sys.stdin)
+        tool_input = input_data.get("tool_input", {})
+        file_path = tool_input.get("file_path", "")
+
+        if not file_path:
+            sys.exit(0)
+
+        _, message = format_file(file_path)
+
+        if message:
+            # Output context for Claude
+            print(json.dumps({
+                "additionalContext": message
+            }))
+
+        sys.exit(0)
+
+    except json.JSONDecodeError:
+        sys.exit(0)
+    except Exception as e:
+        print(f"Hook error: {e}", file=sys.stderr)
+        sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

package/.devcontainer/plugins/devs-marketplace/plugins/auto-linter/.claude-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "auto-linter",
+  "description": "Auto-lints files after editing (pyright for Python)",
+  "author": {
+    "name": "AnExiledDev"
+  }
+}

package/.devcontainer/plugins/devs-marketplace/plugins/auto-linter/hooks/hooks.json

@@ -0,0 +1,17 @@
+{
+  "description": "Auto-lint files after editing",
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/scripts/lint-file.py",
+            "timeout": 60
+          }
+        ]
+      }
+    ]
+  }
+}