Add GitHub CLI, OpenAI, Gemini CLI with auto-update support

- Install GitHub CLI (gh) from official apt repository
- Add Python3 and pip for AI tools
- Install OpenAI Python package for Codex API access (latest)
- Install Google Generative AI Python SDK for Gemini API (latest)
- Auto-detect and install latest Node.js version from nodejs.org
- Move Claude Code installation to init script for auto-update support
- Claude Code now installs to /config/.npm-global as user abc
- Enables Claude Code's built-in auto-update feature
- Add init-claude-code s6 service for first-run setup and updates
- Update CLAUDE.md with comprehensive architecture documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: Charles-Henri ROBICHE

CLAUDE.md

@@ -46,20 +46,30 @@ docker build --no-cache --pull -f Dockerfile.aarch64 -t lscr.io/linuxserver/code
 The `/root` directory contains files copied into the container at build time:
 
 - **root/etc/s6-overlay/s6-rc.d/init-code-server/run** - Initialization script that sets up sudo access, SSH permissions, and directory structure
+- **root/etc/s6-overlay/s6-rc.d/init-claude-code/run** - Initialization script that installs/updates Claude Code in user-writable location for auto-updates
 - **root/etc/s6-overlay/s6-rc.d/svc-code-server/run** - Service script that launches code-server with appropriate flags
 - **root/usr/local/bin/install-extension** - Helper script for installing VS Code extensions (used by Docker mods)
 
 ### Custom Dockerfile Features
 
 The `Dockerfile.custom` variant includes:
-- **Claude Code**: Installed globally via npm during build
-- **Google Cloud CLI**: Installed from official apt repository with GPG keyring
-- **Node.js 22.14.0**: Custom Node.js installation supporting both amd64 and arm64 architectures
-- **Vertex AI Environment Variables**: Pre-configured for Anthropic's Vertex AI integration
-  - `CLAUDE_CODE_USE_VERTEX=1`
-  - `CLOUD_ML_REGION=us-east5`
-  - `ANTHROPIC_VERTEX_PROJECT_ID=oa-data-btdpexploration-np`
-  - `DISABLE_PROMPT_CACHING=0`
+
+**Development Tools:**
+- **Claude Code**: Installed at first startup via init script to `/config/.npm-global` for auto-update support (latest from npm registry)
+- **GitHub CLI** (`gh`): Latest version from official GitHub CLI apt repository
+- **Google Cloud CLI** (`gcloud`): Latest version from official Google Cloud apt repository
+- **Node.js**: Latest stable version auto-detected from nodejs.org, supporting both amd64 and arm64 architectures
+
+**AI API Tools:**
+- **OpenAI CLI**: Latest Python package for accessing OpenAI APIs including Codex (`openai`)
+- **Google Generative AI**: Latest Python SDK for Gemini API (`google-generativeai`)
+
+**Environment Variables:**
+Pre-configured for Anthropic's Vertex AI integration:
+- `CLAUDE_CODE_USE_VERTEX=1`
+- `CLOUD_ML_REGION=us-east5`
+- `ANTHROPIC_VERTEX_PROJECT_ID=oa-data-btdpexploration-np`
+- `DISABLE_PROMPT_CACHING=0`
 
 ## Making Changes
 
@@ -99,7 +109,13 @@ The container uses **s6-overlay** for process supervision. The initialization fl
    - Manages ownership/permissions (skips `/config/workspace` contents for performance)
    - Sets SSH directory permissions (700 for directories, 600 for private keys, 644 for public keys)
 
-2. **svc-code-server** starts the service:
+2. **init-claude-code** runs after config initialization:
+   - Creates `/config/.npm-global` directory for user-writable npm packages
+   - Installs Claude Code as user `abc` (first startup only)
+   - Checks for and applies updates on subsequent startups
+   - Enables Claude Code's built-in auto-update feature
+
+3. **svc-code-server** starts the service:
    - Configures authentication (password, hashed password, or none)
    - Sets up proxy domain if specified
    - Launches code-server bound to `0.0.0.0:8443` (or `[::]:8443` for non-root)

Dockerfile.custom

@@ -1,4 +1,4 @@
-## custom Dockerfile for code-server that includes claude-code + gcloud + Vertex env
+## custom Dockerfile for code-server that includes claude-code + gcloud + gh + AI CLIs
 # syntax=docker/dockerfile:1
 
 FROM ghcr.io/linuxserver/baseimage-ubuntu:noble
@@ -22,6 +22,10 @@ ENV CLAUDE_CODE_USE_VERTEX=1 \
     NPM_CONFIG_FUND=false \
     NPM_CONFIG_AUDIT=false
 
+# Configure npm for user-writable global installs and add to PATH
+ENV NPM_CONFIG_PREFIX=/config/.npm-global \
+    PATH=/config/.npm-global/bin:${PATH}
+
 RUN \
   echo "**** install runtime dependencies ****" && \
   apt-get update && \
@@ -33,16 +37,29 @@ RUN \
     libatomic1 \
     nano \
     net-tools \
+    python3 \
+    python3-pip \
     sudo && \
+  echo "**** install GitHub CLI (apt repo w/ keyring) ****" && \
+  mkdir -p /usr/share/keyrings && \
+  curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg \
+    | gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg && \
+  echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" \
+    > /etc/apt/sources.list.d/github-cli.list && \
   echo "**** install Google Cloud CLI (apt repo w/ keyring) ****" && \
   rm -f /etc/apt/sources.list.d/google-cloud-sdk.list && \
-  mkdir -p /usr/share/keyrings && \
   curl -fsSL https://packages.cloud.google.com/apt/doc/apt-key.gpg \
     | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && \
   echo 'deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main' \
     > /etc/apt/sources.list.d/google-cloud-sdk.list && \
   apt-get update && \
-  apt-get install -y google-cloud-cli && \
+  apt-get install -y \
+    gh \
+    google-cloud-cli && \
+  echo "**** install AI CLI tools via pip ****" && \
+  pip3 install --no-cache-dir --break-system-packages \
+    openai \
+    google-generativeai && \
   echo "**** install code-server ****" && \
   if [ -z ${CODE_RELEASE+x} ]; then \
     CODE_RELEASE=$(curl -sX GET https://api.github.com/repos/coder/code-server/releases/latest \
@@ -55,17 +72,17 @@ RUN \
   curl -o /tmp/code-server.tar.gz -L \
     "https://github.com/coder/code-server/releases/download/v${CODE_RELEASE}/code-server-${CODE_RELEASE}-linux-${CODE_ARCH}.tar.gz" && \
   tar xf /tmp/code-server.tar.gz -C /app/code-server --strip-components=1 && \
-  echo "**** install Node.js and npm ****" && \
-  NODE_VERSION=22.14.0 && \
+  echo "**** install Node.js and npm (latest) ****" && \
+  NODE_VERSION=$(curl -sL https://nodejs.org/dist/latest/SHASUMS256.txt | head -1 | sed 's/.*node-v\([0-9.]*\)-.*/\1/') && \
   ARCH=$(uname -m) && \
   if [ "$ARCH" = "aarch64" ]; then NODE_ARCH="arm64"; fi && \
   if [ "$ARCH" = "x86_64" ]; then NODE_ARCH="x64"; fi && \
   curl -fsSL "https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-${NODE_ARCH}.tar.gz" \
     | tar -xz -C /usr/local/ --strip-components=1 && \
   node -v && npm -v && \
-  echo "**** upgrade npm and install claude-code globally ****" && \
+  echo "**** upgrade npm to latest ****" && \
   npm install -g npm@latest && \
-  npm install -g @anthropic-ai/claude-code && \
+  echo "**** claude-code will be installed at first startup in init script ****" && \
   printf "Linuxserver.io version: ${VERSION}\nBuild-date: ${BUILD_DATE}" > /build_version && \
   echo "**** clean up ****" && \
   apt-get clean && \

root/etc/s6-overlay/s6-rc.d/init-claude-code/dependencies.d/init-config-end

@@ -0,0 +1,29 @@
+#!/usr/bin/with-contenv bash
+# shellcheck shell=bash
+
+# Install/update claude-code in user-writable location for auto-updates
+if [[ -z ${LSIO_NON_ROOT_USER} ]]; then
+    echo "Setting up Claude Code for user abc with auto-update support"
+
+    # Create npm global directory if it doesn't exist
+    mkdir -p /config/.npm-global
+
+    # Install/update claude-code as user abc
+    s6-setuidgid abc bash -c '
+        export NPM_CONFIG_PREFIX=/config/.npm-global
+        export PATH=/config/.npm-global/bin:$PATH
+
+        # Check if claude-code is installed
+        if command -v claude &> /dev/null; then
+            echo "Claude Code already installed, checking for updates..."
+            npm update -g @anthropic-ai/claude-code || echo "Update check completed"
+        else
+            echo "Installing Claude Code for the first time..."
+            npm install -g @anthropic-ai/claude-code
+        fi
+
+        echo "Claude Code setup complete"
+    '
+else
+    echo "Skipping Claude Code setup in non-root mode"
+fi

root/etc/s6-overlay/s6-rc.d/init-claude-code/run

@@ -0,0 +1 @@
+oneshot

root/etc/s6-overlay/s6-rc.d/init-claude-code/type

@@ -0,0 +1 @@
+/etc/s6-overlay/s6-rc.d/init-claude-code/run