codeforge-dev 1.5.0 → 1.5.2

package/.devcontainer/.env

@@ -17,6 +17,9 @@ SETUP_ALIASES=true
 # Setup: install official Anthropic plugins
 SETUP_PLUGINS=true
 
+# Setup: auto-update Claude Code CLI to latest on container start (runs in background)
+SETUP_UPDATE_CLAUDE=true
+
 # Plugin blacklist (comma-separated plugin names to skip during auto-install)
 # Example: PLUGIN_BLACKLIST="workflow-enhancer,auto-formatter"
-PLUGIN_BLACKLIST="workflow-enhancer"
+PLUGIN_BLACKLIST="workflow-enhancer,planning-reminder"

package/.devcontainer/CHANGELOG.md

@@ -1,5 +1,14 @@
 # CodeForge Devcontainer Changelog
 
+## [v1.5.2] - 2026-02-06
+
+### Fixed
+
+- **cc/claude aliases**: Converted from shell functions to simple aliases — functions were not reliably invoked across shell contexts (tmux, docker exec, external terminals), causing Claude to launch without config
+- **CLAUDE_CONFIG_DIR export**: Now exported in `.bashrc`/`.zshrc` directly, so credentials are found in all shells (not just VS Code terminals where `remoteEnv` applies)
+
+---
+
 ## [v1.5.0] - 2026-02-06
 
 ### Added
@@ -16,6 +25,10 @@
   - Creates `claude-teams` session on container start
 - **Biome feature**: Fast JS/TS/JSON/CSS formatter via global `@biomejs/biome` install
 - **External terminal connectors**: Bash (`.sh`) and PowerShell (`.ps1`) scripts to connect host terminals to devcontainer tmux sessions
+- **Claude Code auto-update**: `setup-update-claude.sh` checks for newer Claude Code native binary on every container start
+  - Runs non-blocking in background via `setup.sh`
+  - Downloads from GCS, verifies SHA256 checksum, atomic binary replacement
+  - Controlled by `SETUP_UPDATE_CLAUDE` env var in `.env` (default: `true`)
 
 #### Plugins
 - **code-directive plugin**: Replaces `codedirective-skills` with expanded hook infrastructure
@@ -32,6 +45,7 @@
 - **Default model**: Claude Opus 4-5 → **Claude Opus 4-6** (frontier)
 - **Max output tokens**: 64,000 → **128,000**
 - **Container memory**: 3GB → **4GB** (`--memory-swap` raised to 8GB)
+- **External terminal connectors**: Now run as `vscode` user and auto-launch `cc` on new tmux sessions
 - **Auto-formatter**: Switched from PostToolUse (`format-file.py`) to Stop hook (`format-on-stop.py`)
   - Added Biome support for JS/TS/CSS alongside existing Black and gofmt
   - Batch-formats all edited files when Claude stops instead of formatting on every edit

package/.devcontainer/connect-external-terminal.ps1

@@ -72,6 +72,15 @@ Write-Host ""
 Write-Host "======================================"
 Write-Host ""
 
-# Connect to container with tmux
-# -A attaches to existing session or creates new one
-docker exec -it $CONTAINER_ID tmux new-session -A -s $TMUX_SESSION
+# Connect to container with tmux as vscode user (where aliases are defined)
+# If session exists, reattach. Otherwise create in /workspaces and auto-run cc.
+docker exec -it --user vscode $CONTAINER_ID bash -c "
+  if tmux has-session -t '$TMUX_SESSION' 2>/dev/null; then
+    tmux attach-session -t '$TMUX_SESSION'
+  else
+    tmux new-session -d -s '$TMUX_SESSION' -c /workspaces
+    sleep 0.5
+    tmux send-keys -t '$TMUX_SESSION' 'cc' Enter
+    tmux attach-session -t '$TMUX_SESSION'
+  fi
+"

package/.devcontainer/connect-external-terminal.sh

@@ -64,6 +64,15 @@ echo ""
 echo "======================================"
 echo ""
 
-# Connect to container with tmux
-# -A attaches to existing session or creates new one
-exec docker exec -it "$CONTAINER_ID" tmux new-session -A -s "$TMUX_SESSION"
+# Connect to container with tmux as vscode user (where aliases are defined)
+# If session exists, reattach. Otherwise create in /workspaces and auto-run cc.
+exec docker exec -it --user vscode "$CONTAINER_ID" bash -c "
+  if tmux has-session -t '$TMUX_SESSION' 2>/dev/null; then
+    tmux attach-session -t '$TMUX_SESSION'
+  else
+    tmux new-session -d -s '$TMUX_SESSION' -c /workspaces
+    sleep 0.5
+    tmux send-keys -t '$TMUX_SESSION' 'cc' Enter
+    tmux attach-session -t '$TMUX_SESSION'
+  fi
+"

package/.devcontainer/scripts/setup-aliases.sh

@@ -1,80 +1,67 @@
 #!/bin/bash
-# Setup claude/cc functions for claude with local system prompt support
+# Setup cc/claude/ccraw aliases for claude with local system prompt support
 
 CLAUDE_DIR="${CLAUDE_CONFIG_DIR:?CLAUDE_CONFIG_DIR not set}"
 
 echo "[setup-aliases] Configuring Claude aliases..."
 
-# Shared function for claude with local config (used by both cc and claude)
-CLAUDE_FUNCTION='_claude_with_config() {
-    local LOCAL_PROMPT=".claude/system-prompt.md"
-    local DEFAULT_PROMPT="/workspaces/.devcontainer/config/main-system-prompt.md"
-    local LOCAL_SETTINGS=".claude/settings.json"
-    local DEFAULT_SETTINGS="/workspaces/.devcontainer/config/settings.json"
-
-    mkdir -p .claude
-
-    if [ ! -f "$LOCAL_PROMPT" ]; then
-        cp "$DEFAULT_PROMPT" "$LOCAL_PROMPT"
-        echo "[claude] Created $LOCAL_PROMPT from default"
-    fi
-
-    if [ ! -f "$LOCAL_SETTINGS" ]; then
-        cp "$DEFAULT_SETTINGS" "$LOCAL_SETTINGS"
-        echo "[claude] Created $LOCAL_SETTINGS from default"
-    fi
-
-    command claude --system-prompt-file "$LOCAL_PROMPT" --permission-mode plan --allow-dangerously-skip-permissions "$@"
-}
-
-# cc: shorthand for claude with config
-cc() { _claude_with_config "$@"; }
-
-# claude: override to use config (use ccraw for vanilla)
-claude() { _claude_with_config "$@"; }
-
-# ccraw: vanilla claude without any config
-alias ccraw="command claude"'
+# Simple alias definitions (not functions — functions don't behave reliably across shell contexts)
+ALIAS_CC='alias cc='"'"'command claude --system-prompt-file .claude/system-prompt.md --permission-mode plan --allow-dangerously-skip-permissions'"'"''
+ALIAS_CLAUDE='alias claude='"'"'command claude --system-prompt-file .claude/system-prompt.md --permission-mode plan --allow-dangerously-skip-permissions'"'"''
+ALIAS_CCRAW='alias ccraw="command claude"'
 
 for rc in ~/.bashrc ~/.zshrc; do
     if [ -f "$rc" ]; then
-        # Remove old cc alias/function if present
+        # --- Cleanup old definitions ---
+
+        # Remove old cc alias
         if grep -q "alias cc=" "$rc" 2>/dev/null; then
             sed -i '/alias cc=/d' "$rc"
             echo "[setup-aliases] Removed old cc alias from $(basename $rc)"
         fi
+        # Remove old cc function (single-line or multi-line)
         if grep -q "^cc()" "$rc" 2>/dev/null; then
-            # Remove old cc function (multi-line)
             sed -i '/^cc() {/,/^}/d' "$rc"
             echo "[setup-aliases] Removed old cc function from $(basename $rc)"
         fi
-        # Remove old specwright alias if present
-        if grep -q "alias specwright=" "$rc" 2>/dev/null; then
-            sed -i '/alias specwright=/d' "$rc"
-            echo "[setup-aliases] Removed specwright alias from $(basename $rc)"
-        fi
-        # Remove old _claude_with_config function if present
+        # Remove old _claude_with_config function
         if grep -q "^_claude_with_config()" "$rc" 2>/dev/null; then
             sed -i '/^_claude_with_config() {/,/^}/d' "$rc"
+            echo "[setup-aliases] Removed old _claude_with_config function from $(basename $rc)"
         fi
-        # Remove old claude function override if present
+        # Remove old claude function override
         if grep -q "^claude() {" "$rc" 2>/dev/null; then
             sed -i '/^claude() { _claude_with_config/d' "$rc"
+            echo "[setup-aliases] Removed old claude function from $(basename $rc)"
+        fi
+        # Remove old claude alias
+        if grep -q "alias claude=" "$rc" 2>/dev/null; then
+            sed -i '/alias claude=/d' "$rc"
         fi
-        # Remove old ccraw alias if present
+        # Remove old ccraw alias
         if grep -q "alias ccraw=" "$rc" 2>/dev/null; then
             sed -i '/alias ccraw=/d' "$rc"
         fi
-        # Add functions if not present
-        if ! grep -q "^_claude_with_config()" "$rc" 2>/dev/null; then
-            echo "" >> "$rc"
-            echo "$CLAUDE_FUNCTION" >> "$rc"
-            echo "[setup-aliases] Added claude functions to $(basename $rc)"
+        # Remove old specwright alias
+        if grep -q "alias specwright=" "$rc" 2>/dev/null; then
+            sed -i '/alias specwright=/d' "$rc"
+        fi
+
+        # --- Add environment and aliases ---
+        echo "" >> "$rc"
+        echo "# Claude Code environment and aliases (managed by setup-aliases.sh)" >> "$rc"
+        # Export CLAUDE_CONFIG_DIR so it's available in all shells (not just VS Code remoteEnv)
+        if ! grep -q 'export CLAUDE_CONFIG_DIR=' "$rc" 2>/dev/null; then
+            echo "export CLAUDE_CONFIG_DIR=\"${CLAUDE_CONFIG_DIR}\"" >> "$rc"
         fi
+        echo "$ALIAS_CC" >> "$rc"
+        echo "$ALIAS_CLAUDE" >> "$rc"
+        echo "$ALIAS_CCRAW" >> "$rc"
+        echo "[setup-aliases] Added aliases to $(basename $rc)"
     fi
 done
 
 echo "[setup-aliases] Aliases configured:"
-echo "  claude -> claude with local .claude/system-prompt.md (auto-created from defaults)"
-echo "  cc     -> shorthand for claude with config"
+echo "  cc     -> claude with local .claude/system-prompt.md"
+echo "  claude -> claude with local .claude/system-prompt.md"
 echo "  ccraw  -> vanilla claude without any config"

package/.devcontainer/scripts/setup-update-claude.sh

@@ -0,0 +1,123 @@
+#!/bin/bash
+# Update Claude Code CLI to the latest version (native binary only)
+# Runs non-blocking in background by default via setup.sh
+# All failures are warnings — this script never blocks container startup
+
+echo "[update-claude] Checking for Claude Code updates..."
+
+# === CLEANUP TRAP ===
+cleanup() {
+    rm -f /tmp/claude-update 2>/dev/null || true
+    rm -f /tmp/claude-update-manifest.json 2>/dev/null || true
+}
+trap cleanup EXIT
+
+# === VERIFY CLAUDE IS INSTALLED ===
+if ! command -v claude &>/dev/null; then
+    echo "[update-claude] Claude Code not found, skipping update"
+    exit 0
+fi
+
+# === DETECT INSTALL METHOD ===
+CLAUDE_PATH=$(command -v claude)
+if [[ "$CLAUDE_PATH" != "/usr/local/bin/claude" ]]; then
+    echo "[update-claude] Non-native install detected ($CLAUDE_PATH), skipping"
+    exit 0
+fi
+
+# === VALIDATE DEPENDENCIES ===
+for dep in curl jq sha256sum sudo; do
+    if ! command -v "$dep" &>/dev/null; then
+        echo "[update-claude] WARNING: $dep not available, skipping update"
+        exit 0
+    fi
+done
+
+# === GET CURRENT VERSION ===
+CURRENT_VERSION=$(claude --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "unknown")
+echo "[update-claude] Current version: ${CURRENT_VERSION}"
+
+# === FETCH LATEST VERSION ===
+BASE_URL="https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases"
+
+LATEST_VERSION=$(curl -fsSL "${BASE_URL}/stable" 2>/dev/null)
+if [ -z "$LATEST_VERSION" ]; then
+    echo "[update-claude] WARNING: Failed to fetch latest version, skipping"
+    exit 0
+fi
+
+echo "[update-claude] Latest version: ${LATEST_VERSION}"
+
+# === COMPARE VERSIONS ===
+if [ "$CURRENT_VERSION" = "$LATEST_VERSION" ]; then
+    echo "[update-claude] Already up to date (${CURRENT_VERSION})"
+    exit 0
+fi
+
+echo "[update-claude] Updating from ${CURRENT_VERSION} to ${LATEST_VERSION}..."
+
+# === DETECT PLATFORM ===
+ARCH=$(uname -m)
+case "${ARCH}" in
+    x86_64)
+        PLATFORM="linux-x64"
+        ;;
+    aarch64|arm64)
+        PLATFORM="linux-arm64"
+        ;;
+    *)
+        echo "[update-claude] WARNING: Unsupported architecture: ${ARCH}, skipping"
+        exit 0
+        ;;
+esac
+
+# Detect musl (Alpine Linux)
+if ldd --version 2>&1 | grep -qi musl; then
+    PLATFORM="${PLATFORM}-musl"
+fi
+
+echo "[update-claude] Platform: ${PLATFORM}"
+
+# === DOWNLOAD MANIFEST ===
+MANIFEST_URL="${BASE_URL}/${LATEST_VERSION}/manifest.json"
+
+if ! curl -fsSL "${MANIFEST_URL}" -o /tmp/claude-update-manifest.json 2>/dev/null; then
+    echo "[update-claude] WARNING: Failed to download manifest, skipping"
+    exit 0
+fi
+
+# === EXTRACT AND VERIFY CHECKSUM ===
+EXPECTED_CHECKSUM=$(jq -r ".platforms.\"${PLATFORM}\".checksum" /tmp/claude-update-manifest.json)
+if [ -z "${EXPECTED_CHECKSUM}" ] || [ "${EXPECTED_CHECKSUM}" = "null" ]; then
+    echo "[update-claude] WARNING: Platform ${PLATFORM} not found in manifest, skipping"
+    exit 0
+fi
+
+# === DOWNLOAD BINARY ===
+BINARY_URL="${BASE_URL}/${LATEST_VERSION}/${PLATFORM}/claude"
+
+if ! curl -fsSL "${BINARY_URL}" -o /tmp/claude-update 2>/dev/null; then
+    echo "[update-claude] WARNING: Failed to download binary, skipping"
+    exit 0
+fi
+
+# === VERIFY CHECKSUM ===
+ACTUAL_CHECKSUM=$(sha256sum /tmp/claude-update | cut -d' ' -f1)
+
+if [ "${ACTUAL_CHECKSUM}" != "${EXPECTED_CHECKSUM}" ]; then
+    echo "[update-claude] WARNING: Checksum verification failed, skipping"
+    echo "[update-claude]   Expected: ${EXPECTED_CHECKSUM}"
+    echo "[update-claude]   Actual:   ${ACTUAL_CHECKSUM}"
+    exit 0
+fi
+
+# === INSTALL (atomic replace) ===
+chmod +x /tmp/claude-update
+if ! sudo mv /tmp/claude-update /usr/local/bin/claude; then
+    echo "[update-claude] WARNING: Failed to install update (sudo mv failed), skipping"
+    exit 0
+fi
+
+# === VERIFY UPDATE ===
+INSTALLED_VERSION=$(claude --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || echo "unknown")
+echo "[update-claude] Updated Claude Code: ${CURRENT_VERSION} → ${INSTALLED_VERSION}"

package/.devcontainer/scripts/setup.sh

@@ -21,8 +21,9 @@ fi
 : "${SETUP_ALIASES:=true}"
 : "${OVERWRITE_CONFIG:=false}"
 : "${SETUP_PLUGINS:=true}"
+: "${SETUP_UPDATE_CLAUDE:=true}"
 
-export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR SETUP_CONFIG SETUP_ALIASES OVERWRITE_CONFIG SETUP_PLUGINS
+export CLAUDE_CONFIG_DIR CONFIG_SOURCE_DIR SETUP_CONFIG SETUP_ALIASES OVERWRITE_CONFIG SETUP_PLUGINS SETUP_UPDATE_CLAUDE
 
 
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
@@ -53,6 +54,17 @@ run_script "$SCRIPT_DIR/setup-aliases.sh" "$SETUP_ALIASES"
 run_script "$SCRIPT_DIR/setup-plugins.sh" "$SETUP_PLUGINS"
 run_script "$SCRIPT_DIR/setup-irie-claude.sh" "true"
 
+# Non-blocking: check for Claude Code updates in background
+if [ "$SETUP_UPDATE_CLAUDE" = "true" ]; then
+    if [ -f "$SCRIPT_DIR/setup-update-claude.sh" ]; then
+        echo "Running setup-update-claude (background)..."
+        bash "$SCRIPT_DIR/setup-update-claude.sh" &
+        disown
+    fi
+else
+    echo "Skipping setup-update-claude (disabled)"
+fi
+
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "  Setup Complete"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeforge-dev",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "Complete development container that sets up Claude Code with modular devcontainer features, modern dev tools, and persistent configurations. Drop it into any project and get a production-ready AI development environment in minutes.",
   "main": "setup.js",
   "bin": {