claudepod 1.0.0

package/.devcontainer/config/claude/settings.json

@@ -0,0 +1,179 @@
+{
+  "includeCoAuthoredBy": false,
+  "model": "claude-sonnet-4-0",
+  "forceLoginMethod": "claudeai",
+  "permissions": {
+    "allow": [
+      "Bash",
+      "Write", 
+      "TodoWrite",
+      "mcp__serena__find_file",
+      "mcp__serena__list_dir",
+      "mcp__serena__search_for_pattern", 
+      "mcp__serena__replace_regex",
+      "mcp__serena__get_symbols_overview",
+      "mcp__serena__find_symbol",
+      "mcp__serena__find_referencing_symbols",
+      "mcp__serena__replace_symbol_body",
+      "mcp__serena__insert_after_symbol",
+      "mcp__serena__insert_before_symbol",
+      "mcp__serena__read_memory",
+      "mcp__serena__write_memory",
+      "mcp__serena__list_memories",
+      "mcp__serena__delete_memory",
+      "mcp__serena__restart_language_server",
+      "mcp__serena__onboarding", 
+      "mcp__serena__check_onboarding_performed",
+      "mcp__serena__think_about_collected_information",
+      "mcp__serena__think_about_task_adherence", 
+      "mcp__serena__think_about_whether_you_are_done",
+      "mcp__tavily-search__tavily_search",
+      "mcp__tavily-search__tavily_extract",
+      "mcp__tavily-search__tavily_crawl",
+      "mcp__tavily-search__tavily_map",
+      "mcp__ide__getDiagnostics",
+      "mcp__ide__executeCode",
+      "ListMcpResourcesTool",
+      "ReadMcpResourceTool",
+      "mcp__ref-tools__search",
+      "mcp__ref-tools__get_document", 
+      "mcp__ref-tools__get_page_content",
+      "mcp__ref-tools__search_docs",
+      "mcp__ref-tools__get_api_reference",
+      "mcp__taskmaster-ai__get_tasks",
+      "mcp__taskmaster-ai__next_task",
+      "mcp__taskmaster-ai__get_task", 
+      "mcp__taskmaster-ai__set_task_status",
+      "mcp__taskmaster-ai__add_task",
+      "mcp__taskmaster-ai__update_task",
+      "mcp__taskmaster-ai__expand_task",
+      "mcp__taskmaster-ai__parse_prd",
+      "mcp__taskmaster-ai__initialize_project", 
+      "mcp__taskmaster-ai__expand_all",
+      "mcp__taskmaster-ai__update_subtask",
+      "mcp__taskmaster-ai__models",
+      "mcp__taskmaster-ai__analyze_project_complexity", 
+      "mcp__taskmaster-ai__research",
+      "mcp__github__get_me",
+      "mcp__github__get_file_contents",
+      "mcp__github__create_or_update_file",
+      "mcp__github__delete_file",
+      "mcp__github__list_branches",
+      "mcp__github__create_branch",
+      "mcp__github__get_pull_request",
+      "mcp__github__create_pull_request",
+      "mcp__github__list_pull_requests",
+      "mcp__github__get_pull_request_diff",
+      "mcp__github__get_issue",
+      "mcp__github__create_issue",
+      "mcp__github__list_issues",
+      "mcp__github__add_issue_comment",
+      "mcp__github__push_files",
+      "mcp__github__get_pull_request_files",
+      "mcp__github__get_pull_request_comments", 
+      "mcp__github__merge_pull_request",
+      "mcp__github__list_commits",
+      "mcp__github__get_commit",
+      "mcp__github__update_pull_request",
+      "mcp__github__get_issue_comments",
+      "mcp__github__search_repositories", 
+      "mcp__github__search_code",
+      "mcp__github__fork_repository",
+      "mcp__github__create_repository",
+      "mcp__github__list_tags",
+      "mcp__ccusage__daily",
+      "mcp__ccusage__session"
+    ],
+    "deny": [
+      "Read",
+      "Edit", 
+      "MultiEdit",
+      "Glob",
+      "Grep",
+      "LS",
+      "Task",
+      "ExitPlanMode",
+      "NotebookEdit", 
+      "WebFetch",
+      "WebSearch",
+      "mcp__deepwiki__read_wiki_structure",
+      "mcp__deepwiki__read_wiki_contents", 
+      "mcp__deepwiki__ask_question",
+      "mcp__taskmaster-ai__rules", 
+      "mcp__taskmaster-ai__scope_up_task",
+      "mcp__taskmaster-ai__scope_down_task", 
+      "mcp__taskmaster-ai__complexity_report",
+      "mcp__taskmaster-ai__generate",
+      "mcp__taskmaster-ai__add_subtask",
+      "mcp__taskmaster-ai__update",
+      "mcp__taskmaster-ai__remove_task",
+      "mcp__taskmaster-ai__remove_subtask",
+      "mcp__taskmaster-ai__clear_subtasks",
+      "mcp__taskmaster-ai__move_task", 
+      "mcp__taskmaster-ai__add_dependency",
+      "mcp__taskmaster-ai__remove_dependency",
+      "mcp__taskmaster-ai__validate_dependencies",
+      "mcp__taskmaster-ai__fix_dependencies",
+      "mcp__taskmaster-ai__response-language",
+      "mcp__taskmaster-ai__list_tags",
+      "mcp__taskmaster-ai__add_tag",
+      "mcp__taskmaster-ai__delete_tag",
+      "mcp__taskmaster-ai__use_tag", 
+      "mcp__taskmaster-ai__rename_tag",
+      "mcp__taskmaster-ai__copy_tag",
+      "mcp__github__add_comment_to_pending_review",
+      "mcp__github__add_sub_issue", 
+      "mcp__github__assign_copilot_to_issue",
+      "mcp__github__cancel_workflow_run",
+      "mcp__github__create_and_submit_pull_request_review",
+      "mcp__github__create_gist",
+      "mcp__github__create_pending_pull_request_review",
+      "mcp__github__delete_pending_pull_request_review",
+      "mcp__github__delete_workflow_run_logs",
+      "mcp__github__dismiss_notification",
+      "mcp__github__download_workflow_run_artifact",
+      "mcp__github__get_code_scanning_alert",
+      "mcp__github__get_dependabot_alert",
+      "mcp__github__get_discussion",
+      "mcp__github__get_discussion_comments", 
+      "mcp__github__get_job_logs",
+      "mcp__github__get_notification_details",
+      "mcp__github__get_pull_request_reviews",
+      "mcp__github__get_pull_request_status",
+      "mcp__github__get_secret_scanning_alert",
+      "mcp__github__get_tag",
+      "mcp__github__get_workflow_run",
+      "mcp__github__get_workflow_run_logs",
+      "mcp__github__get_workflow_run_usage",
+      "mcp__github__list_code_scanning_alerts",
+      "mcp__github__list_dependabot_alerts",
+      "mcp__github__list_discussion_categories",
+      "mcp__github__list_discussions",
+      "mcp__github__list_gists", 
+      "mcp__github__list_notifications",
+      "mcp__github__list_secret_scanning_alerts",
+      "mcp__github__list_sub_issues",
+      "mcp__github__list_workflow_jobs",
+      "mcp__github__list_workflow_run_artifacts",
+      "mcp__github__list_workflow_runs",
+      "mcp__github__list_workflows",
+      "mcp__github__manage_notification_subscription",
+      "mcp__github__manage_repository_notification_subscription",
+      "mcp__github__mark_all_notifications_read",
+      "mcp__github__remove_sub_issue",
+      "mcp__github__reprioritize_sub_issue",
+      "mcp__github__request_copilot_review",
+      "mcp__github__rerun_failed_jobs",
+      "mcp__github__rerun_workflow_run",
+      "mcp__github__run_workflow",
+      "mcp__github__search_issues",
+      "mcp__github__search_orgs",
+      "mcp__github__search_pull_requests",
+      "mcp__github__search_users",
+      "mcp__github__submit_pending_pull_request_review",
+      "mcp__github__update_gist",
+      "mcp__github__update_issue",
+      "mcp__github__update_pull_request_branch"
+    ]
+  }
+}

package/.devcontainer/devcontainer.json

@@ -0,0 +1,110 @@
+{
+  "name": "ClaudePod Development Environment",
+  "image": "mcr.microsoft.com/vscode/devcontainers/base:ubuntu-22.04",
+
+  "features": {
+    "ghcr.io/devcontainers/features/common-utils:2": {
+      "installZsh": true,
+      "installOhMyZsh": true,
+      "username": "node",
+      "uid": 1000,
+      "gid": 1000,
+      "upgradePackages": true
+    },
+    "ghcr.io/devcontainers/features/node:1": {
+      "nodeGypDependencies": true,
+      "version": "20"
+    },
+    "ghcr.io/devcontainers/features/python:1": {
+      "version": "3.13",
+      "installTools": true,
+      "toolsToInstall": "flake8,autopep8,black,yapf,mypy,pydocstyle,pycodestyle,bandit,pipenv,virtualenv,pytest,pylint"
+    },
+    "ghcr.io/devcontainers/features/git:1": {
+      "version": "latest",
+      "ppa": false
+    },
+    "ghcr.io/devcontainers/features/github-cli:1": {
+      "version": "latest"
+    },
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {
+      "version": "latest",
+      "dockerDashComposeVersion": "v2"
+    }
+  },
+
+  "containerEnv": {
+    "CLAUDE_CONFIG_DIR": "/home/node/.claude",
+    "DEVCONTAINER": "true",
+    "TAVILY_API_KEY": "${localEnv:TAVILY_API_KEY}",
+    "REF_TOOLS_API_KEY": "${localEnv:REF_TOOLS_API_KEY}",
+    "GITHUB_PERSONAL_ACCESS_TOKEN": "${localEnv:GITHUB_PERSONAL_ACCESS_TOKEN}",
+    "GITHUB_API_URL": "${localEnv:GITHUB_API_URL}",
+    "GITHUB_TOOLSET": "${localEnv:GITHUB_TOOLSET}"
+  },
+
+  "mounts": [
+    "source=${localWorkspaceFolder}/.claude,target=/home/node/.claude,type=bind,consistency=cached",
+    "source=${localWorkspaceFolder}/.serena,target=/home/node/.serena,type=bind,consistency=cached",
+    "source=claudepod-bash-history,target=/home/node/.bash_history,type=volume",
+    "source=claudepod-zsh-history,target=/home/node/.zsh_history,type=volume",
+    "source=claudepod-npm-cache,target=/home/node/.npm,type=volume",
+    "source=claudepod-npm-config,target=/home/node/.config,type=volume",
+    "source=claudepod-npm-global,target=/home/node/.local,type=volume"
+  ],
+
+  "postCreateCommand": "sudo -E /bin/bash .devcontainer/post-create.sh",
+  "postStartCommand": "/bin/bash .devcontainer/post-start.sh",
+
+  "forwardPorts": [],
+  "portsAttributes": {
+    "*": {
+      "onAutoForward": "openBrowserOnce"
+    }
+  },
+  "otherPortsAttributes": {
+    "onAutoForward": "openBrowser"
+  },
+
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-vscode-remote.remote-containers",
+        "ms-vscode-remote.remote-ssh",
+        "ms-vscode-remote.remote-ssh-edit",
+        "ms-vscode.remote-explorer",
+        "ms-vscode-remote.vscode-remote-extensionpack",
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "dbaeumer.vscode-eslint",
+        "esbenp.prettier-vscode",
+        "GitHub.vscode-pull-request-github",
+        "eamodio.gitlens"
+      ],
+      "settings": {
+        "remote.SSH.defaultExtensions": [
+          "ms-vscode-remote.remote-ssh-edit"
+        ],
+        "terminal.integrated.defaultProfile.linux": "zsh",
+        "terminal.integrated.profiles.linux": {
+          "zsh": {
+            "path": "/usr/bin/zsh",
+            "args": ["-l"]
+          }
+        },
+        "terminal.integrated.shell.linux": "/usr/bin/zsh",
+        "terminal.integrated.shellArgs.linux": ["-l"],
+        "terminal.integrated.fontFamily": "MesloLGS NF, 'Courier New', monospace",
+        "terminal.integrated.fontSize": 14
+      }
+    }
+  },
+
+  "remoteUser": "node",
+  "containerUser": "node",
+
+  "workspaceFolder": "/workspace",
+  "workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=cached",
+  
+  "postAttachCommand": "sudo chown -R node:node /workspace"
+}

package/.devcontainer/post-create.sh

@@ -0,0 +1,400 @@
+#!/bin/bash
+set -euo pipefail
+
+# ClaudePod Post-Create Script - Phases 2 & 4
+# This script handles Claude Code installation, configuration, and development tools
+
+echo "🚀 Starting ClaudePod post-create setup..."
+
+# Source NVM to make npm available
+# The Node.js feature installs via NVM at /usr/local/share/nvm
+export NVM_DIR="/usr/local/share/nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+
+# Retry function for resilient installations
+retry_command() {
+    local max_attempts=${1:-3}
+    local delay=${2:-5}
+    shift 2
+    local attempt=1
+    
+    while [ $attempt -le $max_attempts ]; do
+        if "$@"; then
+            return 0
+        fi
+        echo "⚠️  Command failed (attempt $attempt/$max_attempts): $*"
+        if [ $attempt -lt $max_attempts ]; then
+            echo "   Retrying in ${delay}s..."
+            sleep $delay
+        fi
+        ((attempt++))
+    done
+    return 1
+}
+
+# Function to install Claude Code
+install_claude_code() {
+    echo "📦 Installing Claude Code..."
+    
+    # Ensure PATH includes npm global bin directory
+    export PATH="/home/node/.local/bin:$PATH"
+    
+    # Install Claude Code globally with retry logic
+    if retry_command 3 5 npm install -g @anthropic-ai/claude-code; then
+        echo "✅ Claude Code installed successfully"
+        
+        # Verify installation with updated PATH
+        if command -v claude &> /dev/null || [ -f "/home/node/.local/bin/claude" ]; then
+            local version=$(/home/node/.local/bin/claude --version 2>/dev/null || echo "installed")
+            echo "📌 Claude Code version: $version"
+            return 0
+        else
+            echo "⚠️  Claude Code installed but 'claude' command not found"
+            echo "📍 Checking installation location..."
+            find /home/node/.local -name "claude" -type f 2>/dev/null || echo "   No claude binary found"
+            return 1
+        fi
+    else
+        echo "❌ Failed to install Claude Code after multiple attempts"
+        return 1
+    fi
+}
+
+# Function to setup workspace directories for bind mounts
+setup_workspace_directories() {
+    echo "🔧 Setting up workspace configuration directories..."
+    
+    # Create workspace directories for bind mounts
+    local workspace_dirs=(
+        "/workspace/.claude"
+        "/workspace/.serena"
+    )
+    
+    for dir in "${workspace_dirs[@]}"; do
+        if [ ! -d "$dir" ]; then
+            mkdir -p "$dir"
+            echo "📁 Created workspace directory: $dir"
+        fi
+        # Set proper permissions
+        chown -R node:node "$dir"
+        chmod -R 755 "$dir"
+    done
+    
+    # Setup Serena configuration if it doesn't exist
+    setup_serena_config
+    
+    echo "✅ Workspace configuration directories ready"
+}
+
+# Function to setup Serena configuration
+setup_serena_config() {
+    local serena_config="/workspace/.serena/serena_config.yml"
+    
+    if [ ! -f "$serena_config" ]; then
+        echo "📝 Creating Serena configuration..."
+        
+        cat > "$serena_config" << 'EOF'
+gui_log_window: False
+# whether to open a graphical window with Serena's logs.
+
+web_dashboard: True
+# whether to open the Serena web dashboard (accessible through your web browser)
+
+web_dashboard_open_on_launch: False
+# whether to open a browser window with the web dashboard when Serena starts
+# If set to False, you can still open the dashboard manually by navigating to
+# http://localhost:24282/dashboard/ in your web browser
+
+log_level: 20
+# the minimum log level for the GUI log window and the dashboard (10 = debug, 20 = info, 30 = warning, 40 = error)
+
+trace_lsp_communication: False
+# whether to trace the communication between Serena and the language servers.
+
+tool_timeout: 240
+# timeout, in seconds, after which tool executions are terminated
+
+excluded_tools: []
+# list of tools to be globally excluded
+
+included_optional_tools: []
+# list of optional tools (which are disabled by default) to be included
+
+jetbrains: False
+# whether to enable JetBrains mode
+
+record_tool_usage_stats: False
+# whether to record tool usage statistics
+
+token_count_estimator: TIKTOKEN_GPT4O
+# token count estimator to use for tool usage statistics
+
+# MANAGED BY SERENA, KEEP AT THE BOTTOM OF THE YAML AND DON'T EDIT WITHOUT NEED
+# The list of registered projects.
+projects: []
+EOF
+        
+        # Set proper ownership
+        chown node:node "$serena_config"
+        chmod 644 "$serena_config"
+        
+        echo "✅ Serena configuration created with dashboard auto-open disabled"
+    else
+        echo "📁 Serena configuration already exists"
+    fi
+}
+
+# Function to setup Claude configuration directory
+setup_claude_config() {
+    echo "🔧 Setting up Claude configuration..."
+    
+    # Claude Code uses multiple possible config locations
+    local claude_dirs=(
+        "/home/node/.claude"
+        "/home/node/.config/claude"
+    )
+    
+    for dir in "${claude_dirs[@]}"; do
+        if [ ! -d "$dir" ]; then
+            mkdir -p "$dir"
+            echo "📁 Created configuration directory: $dir"
+        fi
+        # Set proper permissions
+        chown -R node:node "$dir"
+        chmod -R 700 "$dir"
+    done
+    
+    # Copy optimized settings.json from devcontainer config
+    local settings_source="/workspace/.devcontainer/config/claude/settings.json"
+    local settings_target="/home/node/.claude/settings.json"
+    
+    if [ -f "$settings_source" ]; then
+        cp "$settings_source" "$settings_target"
+        chown node:node "$settings_target"
+        chmod 600 "$settings_target"
+        echo "📋 Copied optimized Claude settings (79 tools allowed)"
+    else
+        echo "⚠️  Claude settings template not found, using defaults"
+    fi
+    
+    echo "✅ Claude configuration directories ready"
+}
+
+# Function to install ccusage CLI tool
+install_ccusage() {
+    echo "📊 Installing ccusage..."
+    
+    if retry_command 3 5 npm install -g ccusage; then
+        echo "✅ ccusage installed successfully"
+        
+        # Verify installation
+        if [ -f "/home/node/.local/bin/ccusage" ] || command -v ccusage &> /dev/null; then
+            local version=$(/home/node/.local/bin/ccusage --version 2>/dev/null || echo "installed")
+            echo "📌 ccusage version: $version"
+            return 0
+        else
+            echo "⚠️  ccusage installed but command not found"
+            return 1
+        fi
+    else
+        echo "❌ Failed to install ccusage"
+        return 1
+    fi
+}
+
+# Function to install development tools
+install_dev_tools() {
+    echo "🛠️  Installing additional development tools..."
+    
+    # Install git-delta for better git diffs
+    echo "📦 Installing git-delta..."
+    if command -v cargo &> /dev/null; then
+        # If cargo is available, use it
+        cargo install git-delta
+    else
+        # Otherwise, download the binary
+        local delta_version="0.18.2"
+        local delta_url="https://github.com/dandavison/delta/releases/download/${delta_version}/delta-${delta_version}-x86_64-unknown-linux-musl.tar.gz"
+        
+        if retry_command 2 5 wget -q -O /tmp/delta.tar.gz "$delta_url"; then
+            sudo tar -xzf /tmp/delta.tar.gz -C /usr/local/bin delta-${delta_version}-x86_64-unknown-linux-musl/delta --strip-components=1
+            sudo chmod +x /usr/local/bin/delta
+            rm -f /tmp/delta.tar.gz
+            echo "✅ git-delta installed successfully"
+            
+            # Configure git to use delta
+            git config --global core.pager "delta"
+            git config --global interactive.diffFilter "delta --color-only"
+            git config --global delta.navigate true
+            git config --global delta.light false
+            git config --global delta.side-by-side true
+        else
+            echo "⚠️  Failed to install git-delta"
+        fi
+    fi
+    
+    # Setup basic shell enhancements
+    setup_shell_config
+}
+
+# Function to setup enhanced ZSH configuration
+setup_shell_config() {
+    echo "🐚 Setting up enhanced shell configuration..."
+    
+    # Add PATH configuration to shell files
+    local shell_files=(
+        "/home/node/.bashrc"
+        "/home/node/.zshrc" 
+        "/home/node/.profile"
+    )
+    
+    for shell_file in "${shell_files[@]}"; do
+        # Ensure the shell file exists
+        touch "$shell_file"
+        
+        # Add PATH and aliases if not already present
+        if ! grep -q "# ClaudePod custom configuration" "$shell_file" 2>/dev/null; then
+            cat >> "$shell_file" << 'EOF'
+
+# ClaudePod custom configuration
+export PATH="$HOME/.local/bin:$PATH"
+
+# Git aliases
+alias gs='git status'
+alias gd='git diff'
+alias gc='git commit'
+alias gp='git push'
+alias gl='git log --oneline --graph --decorate'
+
+# Claude Code alias with permissions flag
+alias claude='claude --model sonnet --dangerously-skip-permissions'
+
+# List aliases
+alias ll='ls -alF'
+alias la='ls -A'
+alias l='ls -CF'
+EOF
+        fi
+        
+        # Set proper ownership
+        chown node:node "$shell_file"
+        chmod 644 "$shell_file"
+    done
+    
+    # Run ZSH enhancement setup as the node user if available
+    if [ -f ".devcontainer/setup-zsh.sh" ]; then
+        sudo -u node -E bash .devcontainer/setup-zsh.sh 2>/dev/null || {
+            echo "⚠️  ZSH setup encountered some non-critical errors, continuing..."
+        }
+        echo "✅ Enhanced ZSH configuration completed"
+    else
+        echo "✅ Basic shell configuration completed"
+    fi
+}
+
+# Function to display setup completion message
+display_completion_message() {
+    echo ""
+    echo "════════════════════════════════════════════════════════════════"
+    echo "✅ ClaudePod setup complete!"
+    echo "════════════════════════════════════════════════════════════════"
+    echo ""
+    echo "🔑 Next steps:"
+    echo "   1. Run 'claude' to start using Claude Code"
+    echo "   2. Authentication will be handled on first use"
+    echo "   3. Your configuration will persist in the mounted volumes"
+    echo ""
+    echo "🛠️  Installed tools:"
+    echo "   - Claude Code CLI"
+    echo "   - ccusage (Claude Code usage analytics)"
+    echo "   - git-delta (better git diffs)"
+    echo "   - Shell aliases (gs, gd, gc, gp, gl)"
+    echo ""
+    echo "💡 Tip: Claude Code is now available globally as 'claude'"
+    echo "════════════════════════════════════════════════════════════════"
+}
+
+# Function to setup npm directories and permissions
+setup_npm_permissions() {
+    echo "🔧 Setting up npm directories and permissions..."
+    
+    # Create npm directories with correct ownership
+    local npm_dirs=(
+        "/home/node/.npm"
+        "/home/node/.npm/_cacache" 
+        "/home/node/.npm/_logs"
+        "/home/node/.config"
+        "/home/node/.local"
+        "/home/node/.local/bin"
+    )
+    
+    for dir in "${npm_dirs[@]}"; do
+        mkdir -p "$dir"
+        chown -R node:node "$dir"
+        chmod -R 755 "$dir"
+    done
+    
+    # Remove any existing .npmrc directory/file and create .npmrc file
+    rm -rf /home/node/.npmrc
+    cat > /home/node/.npmrc << 'EOF'
+cache=/home/node/.npm/_cacache
+prefix=/home/node/.local
+update-notifier=false
+EOF
+    
+    # Set proper ownership for .npmrc
+    chown node:node /home/node/.npmrc
+    chmod 644 /home/node/.npmrc
+    
+    echo "✅ npm directories and permissions configured"
+}
+
+# Main execution
+main() {
+    echo "════════════════════════════════════════════════════════════════"
+    echo "🐳 ClaudePod Post-Create Setup - Phases 2 & 4"
+    echo "════════════════════════════════════════════════════════════════"
+    
+    # Source NVM and ensure PATH is set correctly for the entire script
+    export NVM_DIR="/usr/local/share/nvm"
+    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+    export PATH="/home/node/.local/bin:$PATH"
+    
+    # Fix workspace permissions
+    echo "🔧 Setting workspace permissions..."
+    sudo chown -R node:node /workspace
+    sudo chmod -R u+rwX,g+rwX /workspace
+    
+    # Setup workspace directories for bind mounts (Claude and Serena)
+    setup_workspace_directories
+    
+    # Setup npm permissions and directories
+    setup_npm_permissions
+    
+    # Add node user to docker group for Docker socket access
+    echo "🐳 Adding node user to docker group..."
+    sudo usermod -aG docker node
+    echo "✅ Node user added to docker group"
+    
+    # Install Claude Code
+    if install_claude_code; then
+        # Setup configuration directory
+        setup_claude_config
+        
+        # Install ccusage CLI tool
+        install_ccusage || echo "⚠️  Continuing without ccusage..."
+        
+        # Install development tools
+        install_dev_tools
+        
+        # Display completion message
+        display_completion_message
+    else
+        echo "⚠️  Setup completed with errors. Claude Code installation failed."
+        echo "   You can try installing manually with: npm install -g @anthropic-ai/claude-code"
+        exit 1
+    fi
+}
+
+# Execute main function
+main