Update context-mode feature to version 2.0.0, enhancing installation via postCreateCommand for proper plugin placement in mounted home directory

Author: chapterjason

README.md

@@ -11,7 +11,7 @@ Published to GHCR under the `sourecode/devcontainer-features` namespace.
 |---|---|---|
 | `claude-code` | `ghcr.io/sourecode/devcontainer-features/claude-code:2` | Installs the Claude Code CLI via the official native installer into `/usr/local/bin`, so the binary survives home-directory volume mounts. Requires Node.js — automatically pulls in the `nvm` feature via `dependsOn`. |
 | `rtk` | `ghcr.io/sourecode/devcontainer-features/rtk:2` | Installs [rtk](https://github.com/rtk-ai/rtk), an LLM token-reducing CLI proxy, into `/usr/local/bin`. Auto-patches Claude Code via `postCreateCommand` so the hook is written against the mounted home, not the image. |
-| `context-mode` | `ghcr.io/sourecode/devcontainer-features/context-mode:1` | Installs the [`context-mode`](https://github.com/mksglu/context-mode) Claude Code plugin. |
+| `context-mode` | `ghcr.io/sourecode/devcontainer-features/context-mode:2` | Installs the [`context-mode`](https://github.com/mksglu/context-mode) Claude Code plugin via `postCreateCommand`, so the plugin lands in the mounted `~/.claude` rather than the image. |
 | `nvm` | `ghcr.io/sourecode/devcontainer-features/nvm:2` | Installs [nvm](https://github.com/nvm-sh/nvm) system-wide at `/usr/local/share/nvm` and optionally a Node version (defaults to LTS), with `node`/`npm`/`npx` symlinked into `/usr/local/bin`. No yarn. |
 
 All binaries land in `/usr/local/bin` (or `/usr/local/share/...`) rather than the user's home, so they survive the shared home-volume pattern described in [`docs/persistence.md`](docs/persistence.md). `rtk` and `context-mode` declare `installsAfter` for both `ghcr.io/sourecode/devcontainer-features/claude-code` and `ghcr.io/anthropics/devcontainer-features/claude-code`, so the runtime orders them after whichever claude-code feature is present.
@@ -29,7 +29,7 @@ image you already use:
     "ghcr.io/sourecode/devcontainer-features/rtk:2": {
       "autoPatchClaude": true
     },
-    "ghcr.io/sourecode/devcontainer-features/context-mode:1": {}
+    "ghcr.io/sourecode/devcontainer-features/context-mode:2": {}
   }
 }
 ```
@@ -55,9 +55,10 @@ don't list `nvm` yourself.
 
 #### `context-mode`
 
-No options. Fails if the `claude` CLI is not on the user's PATH — add a
-claude-code feature as well (the `installsAfter` hint then makes the CLI
-resolve the correct install order automatically).
+No options. Runs via `postCreateCommand`, so it no-ops (with a warning) if
+the `claude` CLI isn't on PATH when the container is created — add a
+claude-code feature as well. `installsAfter` handles ordering for either
+`sourecode/` or `anthropics/` claude-code.
 
 #### `nvm`
 

docs/migration-guide.md

@@ -161,7 +161,7 @@ Typical `features` block for a C++ project:
   "ghcr.io/sourecode/devcontainer-features/nvm:2": {},
   "ghcr.io/sourecode/devcontainer-features/claude-code:2": {},
   "ghcr.io/sourecode/devcontainer-features/rtk:2": {},
-  "ghcr.io/sourecode/devcontainer-features/context-mode:1": {}
+  "ghcr.io/sourecode/devcontainer-features/context-mode:2": {}
 }
 ```
 

src/context-mode/devcontainer-feature.json

@@ -1,10 +1,11 @@
 {
   "id": "context-mode",
-  "version": "1.0.3",
+  "version": "2.0.0",
   "name": "context-mode (Claude Code plugin)",
-  "description": "Installs the context-mode Claude Code plugin from the mksglu/context-mode marketplace. Requires a claude-code feature.",
+  "description": "Installs the context-mode Claude Code plugin from the mksglu/context-mode marketplace via postCreateCommand, so the plugin lands in the mounted ~/.claude rather than the image. Requires a claude-code feature.",
   "documentationURL": "https://github.com/SoureCode/devcontainer-features/tree/master/src/context-mode",
   "options": {},
+  "postCreateCommand": "/usr/local/share/context-mode/post-create.sh",
   "installsAfter": [
     "ghcr.io/sourecode/devcontainer-features/claude-code",
     "ghcr.io/anthropics/devcontainer-features/claude-code"

src/context-mode/install.sh

@@ -1,6 +1,12 @@
 #!/usr/bin/env bash
 # context-mode Claude Code plugin installer.
 # https://github.com/mksglu/context-mode
+#
+# `claude plugin install` writes to ~/.claude/plugins, which lives on the
+# volume-mounted home. Running it at build time only works for the very
+# first devcontainer create (during volume seeding) and is invisible on
+# every subsequent run. Defer the install to postCreateCommand so it runs
+# against the real mounted home every time.
 set -e
 
 if ! command -v git >/dev/null 2>&1; then
@@ -9,19 +15,25 @@ if ! command -v git >/dev/null 2>&1; then
   rm -rf /var/lib/apt/lists/*
 fi
 
-USER_NAME="${_REMOTE_USER:-${USERNAME:-root}}"
-
-run_as_user() {
-  if [ "$USER_NAME" = "root" ]; then
-    bash -c "$1"
-  else
-    su - "$USER_NAME" -c "$1"
-  fi
-}
+mkdir -p /usr/local/share/context-mode
+cat >/usr/local/share/context-mode/post-create.sh <<'EOF'
+#!/usr/bin/env bash
+# Written by the context-mode devcontainer feature at build time.
+# Runs as the remote user via postCreateCommand so the plugin lands in
+# the mounted ~/.claude, not the image.
+set -e
 
-if ! run_as_user 'command -v claude >/dev/null 2>&1'; then
-  echo "context-mode feature: claude CLI not found. Install a claude-code feature (e.g. ghcr.io/sourecode/devcontainer-features/claude-code) first." >&2
-  exit 1
+if ! command -v claude >/dev/null 2>&1; then
+  echo "context-mode feature: claude CLI not on PATH, skipping plugin install. Install a claude-code feature (e.g. ghcr.io/sourecode/devcontainer-features/claude-code) to enable it." >&2
+  exit 0
 fi
 
-run_as_user 'claude plugin marketplace add mksglu/context-mode && claude plugin install context-mode@context-mode'
+mkdir -p "$HOME/.claude"
+
+# Both commands are idempotent on re-run: `marketplace add` is a no-op if the
+# marketplace is already registered, and `plugin install` short-circuits if
+# the plugin is already installed at the same version.
+claude plugin marketplace add mksglu/context-mode
+claude plugin install context-mode@context-mode
+EOF
+chmod 0755 /usr/local/share/context-mode/post-create.sh