fix: improve devcontainer configuration (#98)

- Upgrade @devcontainers/cli requirement to 0.80.2+ to fix hanging issue
- Install Claude CLI as vscode user instead of root to avoid permission issues
- Add C.UTF-8 locale configuration for proper UTF-8 support
- Add tmux mouse support configuration
- Pass through Z_AI_API_KEY environment variable from host
- Add devcontainer documentation

The CLI version 0.80.0 had a bug that caused devcontainer up to hang
after "Container started". This is fixed in 0.80.2+.

Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: sonesuke

.devcontainer/Dockerfile

@@ -1,5 +1,10 @@
 FROM rust:1-slim-bookworm
 
+# Set UTF-8 locale
+ENV LANG=C.UTF-8 \
+    LANGUAGE=C.UTF-8 \
+    LC_ALL=C.UTF-8
+
 # Install Node.js and other dependencies as root
 RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
     && apt-get -y install --no-install-recommends \
@@ -27,5 +32,5 @@ RUN curl -L --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/ca
     && rustup component add rustfmt clippy llvm-tools-preview \
     && cargo binstall -y cargo-audit cargo-llvm-cov
 
-# Install Claude CLI as root
-RUN curl -fsSL https://claude.ai/install.sh | bash
+# Configure tmux with mouse support for all users
+RUN echo 'set -g mouse on' > /etc/skel/.tmux.conf

.devcontainer/README.md

@@ -0,0 +1,36 @@
+# Dev Container
+
+This folder contains the development container configuration for the Docgraph project.
+
+## CLI Usage
+
+When using the `devcontainer` CLI, version **0.80.2** or later is required.
+
+```bash
+npx -y @devcontainers/cli@0.80.2 up --workspace-folder . --remove-existing-container
+```
+
+**Important:** Earlier versions (including 0.80.0) have a bug that causes the CLI to hang after "Container started".
+
+## Files
+
+- `devcontainer.json` - Container configuration
+- `Dockerfile` - Base image with Rust, Node.js, and development tools
+- `post-create.sh` - Setup script that runs in background after container creation
+
+## Setup Process
+
+The `post-create.sh` script runs automatically after the container starts. It:
+
+1. Fixes permissions for `CARGO_HOME`
+2. Installs VSIX dependencies and packages the extension
+3. Runs `cargo check` to verify the project
+4. Installs the `docgraph` binary
+5. Configures the `claude` alias
+6. Authenticates with Z.ai (if `Z_AI_API_KEY` is set)
+
+The `devcontainer up` command will wait for the setup to complete before exiting.
+
+## CI Environment
+
+In CI (when `CI` or `GITHUB_ACTIONS` is set), the setup script skips all development setup steps.

.devcontainer/devcontainer.json

@@ -17,7 +17,9 @@
     "customizations": {
         "vscode": {}
     },
-    "remoteUser": "vscode",
+    "containerEnv": {
+        "Z_AI_API_KEY": "${localEnv:Z_AI_API_KEY}"
+    },
     "postCreateCommand": "bash .devcontainer/post-create.sh",
-    "waitFor": "postCreateCommand"
+    "remoteUser": "vscode"
 }

.devcontainer/post-create.sh

@@ -1,36 +1,54 @@
 #!/bin/bash
-set -e
 
 if [ -z "$CI" ] && [ -z "$GITHUB_ACTIONS" ]; then
     # Fix permissions for local development where CARGO_HOME is root-owned by the base image
     sudo chown -R vscode:vscode /usr/local/cargo
 
-    echo "Installing VSIX dependencies..."
+    # Install Claude CLI as vscode user if not already installed
+    if ! command -v claude >/dev/null 2>&1; then
+        echo "[Devcontainer Setup] Installing Claude CLI..."
+        curl -fsSL https://claude.ai/install.sh | bash
+
+        # Add .local/bin to PATH for current session
+        export PATH="$HOME/.local/bin:$PATH"
+
+        # Add to shell configs for future sessions
+        echo 'export PATH="$HOME/.local/bin:$PATH"' >> $HOME/.bashrc
+        echo 'export PATH="$HOME/.local/bin:$PATH"' >> $HOME/.zshrc
+    else
+        echo "[Devcontainer Setup] Claude CLI already installed: $(claude --version)"
+    fi
+
+    echo "[Devcontainer Setup] Installing VSIX dependencies..."
     npm install --prefix vsix
+
+    echo "[Devcontainer Setup] Packaging VSIX..."
     (cd vsix && npx vsce package -o ../docgraph.vsix)
+
     if command -v code >/dev/null 2>&1 && code --version >/dev/null 2>&1; then
-        echo "Installing docgraph.vsix..."
+        echo "[Devcontainer Setup] Installing docgraph.vsix..."
         code --install-extension docgraph.vsix
     else
-        echo "VS Code CLI (code) not found or not working, skipping extension installation."
+        echo "[Devcontainer Setup] VS Code CLI (code) not found or not working, skipping extension installation."
     fi
 
-    echo "Checking project..."
+    echo "[Devcontainer Setup] Checking project..."
     cargo check
 
-    echo "Installing docgraph..."
+    echo "[Devcontainer Setup] Installing docgraph..."
     cargo install --path . --force
 
-    echo "Configuring claude alias..."
+    echo "[Devcontainer Setup] Configuring claude alias..."
     echo 'alias claude="claude --plugin-dir /workspaces/docgraph/docgraph-plugin --allow-dangerously-skip-permissions"' >> $HOME/.bashrc
     echo 'alias claude="claude --plugin-dir /workspaces/docgraph/docgraph-plugin --allow-dangerously-skip-permissions"' >> $HOME/.zshrc
 
-    echo "Authenticating claude..."
+    echo "[Devcontainer Setup] Authenticating claude..."
     if [ -n "$Z_AI_API_KEY" ]; then
-        npx -y @z_ai/coding-helper auth glm_coding_plan_global "$Z_AI_API_KEY" 
+        npx -y @z_ai/coding-helper auth glm_coding_plan_global "$Z_AI_API_KEY"
         npx -y @z_ai/coding-helper auth reload claude
     fi
+
+    echo "[Devcontainer Setup] Complete!"
 else
     echo "Running in CI environment, skipping development setup..."
 fi
-