codeforge-dev 1.7.0 → 1.8.0

package/.devcontainer/docs/troubleshooting.md

@@ -0,0 +1,128 @@
+# Troubleshooting
+
+Common issues and solutions for the CodeForge devcontainer.
+
+## Container Build Failures
+
+**Problem**: Container fails to build during feature installation.
+
+- Check Docker has sufficient memory (4GB+ recommended). CodeForge sets `--memory=4g` by default.
+- If a specific feature fails, disable it temporarily by setting `"version": "none"` in `devcontainer.json`.
+- Check internet connectivity — most features download binaries from GitHub releases.
+- If hitting GitHub API rate limits during build, set `GH_TOKEN` or `GITHUB_TOKEN` as an environment variable.
+
+**Problem**: Build is slow or hangs.
+
+- The mcp-qdrant feature downloads an embedding model (~90MB). This is normal on first build.
+- The mcp-reasoner feature clones and builds a Node.js project. This takes 1-2 minutes.
+- Use `"version": "none"` to skip optional features you don't need.
+
+## Authentication Issues
+
+**Problem**: `claude` command fails with authentication error.
+
+- Run `claude` once interactively to complete authentication.
+- If using API key auth, verify `ANTHROPIC_API_KEY` is set correctly.
+- Background update may be in progress — wait 10 seconds and retry.
+
+**Problem**: `gh` CLI not authenticated.
+
+- Run `gh auth status` to check current state.
+- Run `gh auth login` for interactive setup.
+- Or configure `.devcontainer/.secrets` with `GH_TOKEN` for automatic auth on container start.
+- Credentials persist in `/workspaces/.gh/` across rebuilds.
+
+**Problem**: Git push fails with permission error.
+
+- Run `gh auth status` to verify authentication.
+- Check git remote URL: `git remote -v`. HTTPS remotes require `gh` auth; SSH remotes require SSH keys.
+- Verify `git config --global user.name` and `user.email` are set.
+
+**Problem**: NPM publish/install fails with 401.
+
+- Set `NPM_TOKEN` in `.devcontainer/.secrets` or as environment variable.
+- Verify token: `npm whoami`.
+
+## Feature Installation Failures
+
+**Problem**: Feature checksum verification fails.
+
+- This usually means a corrupted download. Rebuild the container to retry.
+- If persistent, the release may have been re-tagged. Try pinning a specific version in `devcontainer.json`.
+
+**Problem**: Feature download fails after retries.
+
+- Check internet connectivity.
+- GitHub may be experiencing issues — check [githubstatus.com](https://www.githubstatus.com/).
+- Set `GH_TOKEN` environment variable to avoid rate limiting.
+
+**Problem**: Permission denied during feature install.
+
+- Features run as root during build. This shouldn't happen in normal use.
+- If modifying features, ensure `install.sh` has `chmod +x` and starts with `#!/bin/bash`.
+
+## Plugin Issues
+
+**Problem**: Plugin not loading or not appearing in Claude Code.
+
+- Check `enabledPlugins` in `config/defaults/settings.json` — the plugin must be listed there.
+- Verify the plugin directory exists under `plugins/devs-marketplace/plugins/`.
+- Run `check-setup` to verify core configuration is correct.
+- Check plugin blacklist: ensure it's not in `PLUGIN_BLACKLIST` in `.env`.
+
+**Problem**: Auto-formatter or auto-linter not running.
+
+- These run on the Stop hook — they only trigger when Claude Code stops (end of conversation turn).
+- Verify the underlying tools are installed: `cc-tools` lists all available tools.
+- Check the 30-second timeout hasn't been exceeded (large file sets may hit this).
+
+## Agent Teams / tmux Issues
+
+**Problem**: Split panes not working.
+
+- Agent Teams requires tmux. Use the **"Claude Teams (tmux)"** terminal profile in VS Code.
+- Verify tmux is installed: `tmux -V`.
+- If using an external terminal, connect via `connect-external-terminal.sh`.
+
+**Problem**: tmux Unicode/emoji rendering broken.
+
+- Ensure locale is set: `echo $LANG` should show `en_US.UTF-8`.
+- If not, run `source ~/.bashrc` or open a new terminal.
+
+## "Command Not Found" Errors
+
+**Problem**: `cc: command not found` or similar.
+
+- Run `source ~/.bashrc` (or `~/.zshrc`) to reload aliases.
+- Or open a new terminal.
+- Verify setup ran: check for `# Claude Code environment and aliases` in your rc file.
+
+**Problem**: Tool not found (e.g., `ruff`, `dprint`).
+
+- Run `cc-tools` to see which tools are installed.
+- Check if the feature was disabled with `"version": "none"` in `devcontainer.json`.
+- Some tools (like `ruff`) install to `~/.local/bin` — ensure it's in your PATH.
+
+## Performance Issues
+
+**Problem**: Container is slow or running out of memory.
+
+- CodeForge defaults to 4GB RAM / 8GB swap. Increase in `devcontainer.json` `runArgs`.
+- Disable features you don't need with `"version": "none"`.
+- The background Claude Code update runs once on startup — it's not persistent.
+
+**Problem**: Slow startup.
+
+- First start is slower due to `postStartCommand` running all setup scripts.
+- Subsequent starts skip unchanged config files (sha256 comparison).
+- Disable steps you don't need via `.env` (e.g., `SETUP_PROJECTS=false`).
+
+## How to Reset to Defaults
+
+1. **Reset config files**: Delete `/workspaces/.claude/` and restart the container. `setup-config.sh` will recopy all files from `config/defaults/`.
+
+2. **Reset aliases**: Delete the `# Claude Code environment and aliases` block from `~/.bashrc` and `~/.zshrc`, then run `bash /workspaces/.devcontainer/scripts/setup-aliases.sh`.
+
+3. **Full reset**: Rebuild the container from scratch (VS Code: "Dev Containers: Rebuild Container").
+
+4. **Reset a single feature**: Set it to `"version": "none"`, rebuild, then set it back to the desired version and rebuild again.

package/.devcontainer/features/agent-browser/install.sh

@@ -4,6 +4,12 @@ set -euo pipefail
 VERSION="${VERSION:-latest}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[agent-browser] Skipping installation (version=none)"
+    exit 0
+fi
+
 # Set headless as default for containers (bundled Chromium, no display needed)
 export AGENT_BROWSER_HEADLESS=true
 

package/.devcontainer/features/ast-grep/install.sh

@@ -4,6 +4,12 @@ set -euo pipefail
 VERSION="${VERSION:-latest}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[ast-grep] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[ast-grep] Starting installation..."
 echo "[ast-grep] Version: ${VERSION}"
 

package/.devcontainer/features/biome/README.md

@@ -0,0 +1,27 @@
+# Biome
+
+Fast JavaScript/TypeScript/JSON/CSS formatter and linter.
+
+## What It Does
+
+Installs [Biome](https://biomejs.dev/) globally via npm. Biome is an all-in-one toolchain for web projects, replacing ESLint and Prettier for JS/TS/CSS/JSON formatting and linting.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `version` | `latest` | Biome version to install. Set `"none"` to skip. |
+
+## Usage
+
+```bash
+biome format --write src/
+biome lint src/
+biome check --write src/    # format + lint
+```
+
+## Configuration
+
+Biome is used by the `auto-formatter` and `auto-linter` plugins for JS/TS/CSS/JSON/GraphQL/HTML files. No additional configuration required for basic usage.
+
+For project-specific config, create a `biome.json` in your project root. See [Biome docs](https://biomejs.dev/reference/configuration/).

package/.devcontainer/features/biome/install.sh

@@ -3,6 +3,12 @@ set -euo pipefail
 
 VERSION="${VERSION:-latest}"
 
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[biome] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[biome] Starting installation..."
 echo "[biome] Version: ${VERSION}"
 

package/.devcontainer/features/ccburn/install.sh

@@ -13,6 +13,12 @@ CCBURN_VERSION="${VERSION:-latest}"
 SHELLS="${SHELLS:-both}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${CCBURN_VERSION}" = "none" ]; then
+    echo "[ccburn] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[ccburn] Starting ccburn installation..."
 
 # === SOURCE NVM ===

package/.devcontainer/features/ccstatusline/devcontainer-feature.json

@@ -6,6 +6,11 @@
   "maintainer": "AnExiledDev",
   "documentationURL": "https://github.com/sirmalloc/ccstatusline",
   "options": {
+    "version": {
+      "type": "string",
+      "description": "Version to install (or 'none' to skip installation)",
+      "default": "latest"
+    },
     "username": {
       "type": "string",
       "description": "Container user to install for",

package/.devcontainer/features/ccstatusline/install.sh

@@ -9,8 +9,15 @@ trap cleanup EXIT
 
 # Import options from devcontainer-feature.json
 # NOTE: DevContainer converts camelCase options to UPPERCASE without underscores
+VERSION="${VERSION:-latest}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[ccstatusline] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[ccstatusline] Starting installation..."
 
 # Source NVM (Node is installed via NVM by the node feature)

package/.devcontainer/features/ccusage/install.sh

@@ -15,6 +15,12 @@ CCUSAGE_VERSION="${VERSION:-latest}"
 SHELLS="${SHELLS:-both}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${CCUSAGE_VERSION}" = "none" ]; then
+    echo "[ccusage] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[ccusage] Starting ccusage installation..."
 
 # === SOURCE NVM ===

package/.devcontainer/features/claude-monitor/install.sh

@@ -10,6 +10,12 @@ MONITOR_VERSION="${VERSION:-latest}"
 INSTALLER="${INSTALLER:-uv}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${MONITOR_VERSION}" = "none" ]; then
+    echo "[claude-monitor] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[claude-monitor] Starting installation..."
 
 # ---------- USER ----------

package/.devcontainer/features/dprint/README.md

@@ -0,0 +1,30 @@
+# dprint
+
+Pluggable code formatter for Markdown, YAML, TOML, and Dockerfile.
+
+## What It Does
+
+Installs [dprint](https://dprint.dev/) with a global config covering Markdown, YAML, TOML, and Dockerfile formatting. Used by the `auto-formatter` plugin for these file types.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `version` | `0.51.1` | dprint version to install. Set `"latest"` for newest, `"none"` to skip. |
+| `username` | `automatic` | Container user to install for. |
+
+## Usage
+
+```bash
+dprint fmt                        # format files in current directory
+dprint fmt --config /usr/local/share/dprint/dprint.json  # use global config
+dprint check                      # check without modifying
+```
+
+## Configuration
+
+A global config is installed at `/usr/local/share/dprint/dprint.json` with plugins for Markdown, YAML, TOML, and Dockerfile. For project-specific config, create a `dprint.json` in your project root.
+
+## Checksum Verification
+
+Downloads are verified against SHA256 checksums published with each GitHub release. If checksums can't be fetched, installation proceeds with a warning.

package/.devcontainer/features/dprint/devcontainer-feature.json

@@ -0,0 +1,18 @@
+{
+  "id": "dprint",
+  "version": "1.0.0",
+  "name": "dprint",
+  "description": "Pluggable code formatter for Markdown, YAML, TOML, and Dockerfile",
+  "options": {
+    "version": {
+      "type": "string",
+      "default": "0.51.1",
+      "description": "dprint version to install. Set 'latest' to always get newest."
+    },
+    "username": {
+      "type": "string",
+      "default": "automatic",
+      "description": "Container user to install for"
+    }
+  }
+}

package/.devcontainer/features/dprint/install.sh

@@ -0,0 +1,131 @@
+#!/bin/bash
+set -euo pipefail
+
+# ==============================
+# dprint DevContainer Feature
+# Official installer + global config
+# ==============================
+
+DPRINT_VERSION="${VERSION:-latest}"
+USERNAME="${USERNAME:-automatic}"
+
+# Skip installation if version is "none"
+if [ "${DPRINT_VERSION}" = "none" ]; then
+    echo "[dprint] Skipping installation (version=none)"
+    exit 0
+fi
+
+echo "[dprint] Starting installation..."
+
+# ---------- USER ----------
+if [[ "${USERNAME}" == "auto" || "${USERNAME}" == "automatic" ]]; then
+    for u in vscode node codespace; do
+        if id -u "$u" >/dev/null 2>&1; then
+            USERNAME="$u"
+            break
+        fi
+    done
+    USERNAME="${USERNAME:-root}"
+fi
+
+USER_HOME="$(eval echo "~${USERNAME}")"
+
+echo "[dprint] Target user: ${USERNAME}"
+echo "[dprint] Version: ${DPRINT_VERSION}"
+
+# ---------- HELPERS ----------
+download_with_retry() {
+    local url="$1" dest="$2" retries="${3:-3}" delay="${4:-2}"
+    local attempt=1
+    while [ $attempt -le $retries ]; do
+        if curl -fsSL ${GITHUB_AUTH_HEADER:-} "$url" -o "$dest" 2>/dev/null; then
+            return 0
+        fi
+        echo "[dprint] Download attempt $attempt/$retries failed, retrying in ${delay}s..."
+        sleep "$delay"
+        attempt=$((attempt + 1))
+        delay=$((delay * 2))
+    done
+    echo "[dprint] ERROR: Download failed after $retries attempts: $url"
+    return 1
+}
+
+# GitHub API auth header (avoids rate limiting)
+GITHUB_AUTH_HEADER=""
+if [ -n "${GH_TOKEN:-}" ] || [ -n "${GITHUB_TOKEN:-}" ]; then
+    GITHUB_AUTH_HEADER="-H Authorization: token ${GH_TOKEN:-$GITHUB_TOKEN}"
+fi
+
+# ---------- INSTALL ----------
+# Install to a system-wide location so all users can access it
+export DPRINT_INSTALL="/usr/local/share/dprint"
+mkdir -p "${DPRINT_INSTALL}/bin"
+
+ARCH="$(dpkg --print-architecture)"
+case "${ARCH}" in
+    amd64) TARGET="x86_64-unknown-linux-gnu" ;;
+    arm64) TARGET="aarch64-unknown-linux-gnu" ;;
+    *)
+        echo "[dprint] ERROR: Unsupported architecture: ${ARCH}" >&2
+        exit 1
+        ;;
+esac
+
+# Version pinned for reproducible builds. Set "latest" to always get newest.
+if [[ "${DPRINT_VERSION}" == "latest" ]]; then
+    DPRINT_VERSION="$(curl -fsSL ${GITHUB_AUTH_HEADER:-} https://api.github.com/repos/dprint/dprint/releases/latest | grep -o '"tag_name": *"[^"]*"' | head -1 | cut -d'"' -f4)"
+    echo "[dprint] Resolved latest version: ${DPRINT_VERSION}"
+fi
+
+ZIP_URL="https://github.com/dprint/dprint/releases/download/${DPRINT_VERSION}/dprint-${TARGET}.zip"
+echo "[dprint] Downloading from: ${ZIP_URL}"
+
+TMP_DIR="$(mktemp -d)"
+download_with_retry "${ZIP_URL}" "${TMP_DIR}/dprint.zip"
+
+# ---------- CHECKSUM VERIFICATION ----------
+CHECKSUM_URL="https://github.com/dprint/dprint/releases/download/${DPRINT_VERSION}/SHASUMS256.txt"
+if curl -fsSL "${CHECKSUM_URL}" -o "${TMP_DIR}/checksums.txt" 2>/dev/null; then
+    EXPECTED=$(grep "dprint-${TARGET}.zip" "${TMP_DIR}/checksums.txt" | awk '{print $1}')
+    ACTUAL=$(sha256sum "${TMP_DIR}/dprint.zip" | cut -d' ' -f1)
+    if [ -n "$EXPECTED" ] && [ "$ACTUAL" != "$EXPECTED" ]; then
+        echo "[dprint] ERROR: Checksum verification failed"
+        echo "  Expected: $EXPECTED"
+        echo "  Actual:   $ACTUAL"
+        rm -rf "${TMP_DIR}"
+        exit 1
+    fi
+    echo "[dprint] Checksum verified"
+else
+    echo "[dprint] WARNING: Could not fetch checksums, skipping verification"
+fi
+
+unzip -o "${TMP_DIR}/dprint.zip" -d "${DPRINT_INSTALL}/bin"
+chmod +x "${DPRINT_INSTALL}/bin/dprint"
+rm -rf "${TMP_DIR}"
+
+# Symlink into PATH
+ln -sf "${DPRINT_INSTALL}/bin/dprint" /usr/local/bin/dprint
+
+# ---------- GLOBAL CONFIG ----------
+cat > "${DPRINT_INSTALL}/dprint.json" << 'DPRINT_CONFIG'
+{
+  "lineWidth": 120,
+  "indentWidth": 2,
+  "markdown": {},
+  "yaml": {},
+  "toml": {},
+  "dockerfile": {},
+  "plugins": [
+    "https://plugins.dprint.dev/markdown-0.17.8.wasm",
+    "https://plugins.dprint.dev/g-plane/pretty_yaml-0.5.0.wasm",
+    "https://plugins.dprint.dev/toml-0.6.4.wasm",
+    "https://plugins.dprint.dev/dockerfile-0.3.2.wasm"
+  ]
+}
+DPRINT_CONFIG
+
+echo "[dprint] Global config written to ${DPRINT_INSTALL}/dprint.json"
+
+# ---------- VERIFY ----------
+echo "[dprint] Installed: $(dprint --version 2>/dev/null || echo 'unknown')"

package/.devcontainer/features/hadolint/README.md

@@ -0,0 +1,35 @@
+# hadolint
+
+Dockerfile linter that validates best practices.
+
+## What It Does
+
+Installs [hadolint](https://github.com/hadolint/hadolint) as a static binary. Hadolint parses Dockerfiles and checks them against best-practice rules based on the official Docker documentation.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `version` | `v2.14.0` | hadolint version to install. Set `"latest"` for newest, `"none"` to skip. |
+
+## Usage
+
+```bash
+hadolint Dockerfile
+hadolint --ignore DL3008 Dockerfile    # ignore specific rule
+hadolint -f json Dockerfile            # JSON output
+```
+
+## Configuration
+
+Used by the `auto-linter` plugin to lint Dockerfiles on save. For project-specific ignores, create a `.hadolint.yaml` in your project root:
+
+```yaml
+ignored:
+  - DL3008  # Pin versions in apt-get install
+  - DL3009  # Delete apt lists
+```
+
+## Checksum Verification
+
+Downloads are verified against per-binary `.sha256` files published with each GitHub release.

package/.devcontainer/features/hadolint/devcontainer-feature.json

@@ -0,0 +1,13 @@
+{
+  "id": "hadolint",
+  "version": "1.0.0",
+  "name": "hadolint",
+  "description": "Dockerfile linter that validates best practices",
+  "options": {
+    "version": {
+      "type": "string",
+      "default": "v2.14.0",
+      "description": "hadolint version to install. Set 'latest' to always get newest."
+    }
+  }
+}

package/.devcontainer/features/hadolint/install.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+set -euo pipefail
+
+# ==============================
+# hadolint DevContainer Feature
+# Direct binary from GitHub releases
+# ==============================
+
+HADOLINT_VERSION="${VERSION:-latest}"
+
+# Skip installation if version is "none"
+if [ "${HADOLINT_VERSION}" = "none" ]; then
+    echo "[hadolint] Skipping installation (version=none)"
+    exit 0
+fi
+
+echo "[hadolint] Starting installation..."
+
+# ---------- HELPERS ----------
+download_with_retry() {
+    local url="$1" dest="$2" retries="${3:-3}" delay="${4:-2}"
+    local attempt=1
+    while [ $attempt -le $retries ]; do
+        if curl -fsSL ${GITHUB_AUTH_HEADER:-} "$url" -o "$dest" 2>/dev/null; then
+            return 0
+        fi
+        echo "[hadolint] Download attempt $attempt/$retries failed, retrying in ${delay}s..."
+        sleep "$delay"
+        attempt=$((attempt + 1))
+        delay=$((delay * 2))
+    done
+    echo "[hadolint] ERROR: Download failed after $retries attempts: $url"
+    return 1
+}
+
+# GitHub API auth header (avoids rate limiting)
+GITHUB_AUTH_HEADER=""
+if [ -n "${GH_TOKEN:-}" ] || [ -n "${GITHUB_TOKEN:-}" ]; then
+    GITHUB_AUTH_HEADER="-H Authorization: token ${GH_TOKEN:-$GITHUB_TOKEN}"
+fi
+
+ARCH="$(dpkg --print-architecture)"
+case "${ARCH}" in
+    amd64) BINARY_ARCH="x86_64" ;;
+    arm64) BINARY_ARCH="arm64" ;;
+    *)
+        echo "[hadolint] ERROR: Unsupported architecture: ${ARCH}" >&2
+        exit 1
+        ;;
+esac
+
+# Version pinned for reproducible builds. Set "latest" to always get newest.
+if [[ "${HADOLINT_VERSION}" == "latest" ]]; then
+    HADOLINT_VERSION="$(curl -fsSL ${GITHUB_AUTH_HEADER:-} https://api.github.com/repos/hadolint/hadolint/releases/latest | grep -o '"tag_name": *"[^"]*"' | head -1 | cut -d'"' -f4)"
+    echo "[hadolint] Resolved latest version: ${HADOLINT_VERSION}"
+fi
+
+URL="https://github.com/hadolint/hadolint/releases/download/${HADOLINT_VERSION}/hadolint-Linux-${BINARY_ARCH}"
+echo "[hadolint] Downloading from: ${URL}"
+
+TMP_DIR="$(mktemp -d)"
+download_with_retry "${URL}" "${TMP_DIR}/hadolint"
+
+# ---------- CHECKSUM VERIFICATION ----------
+# hadolint publishes per-binary .sha256 files
+CHECKSUM_URL="${URL}.sha256"
+if curl -fsSL "${CHECKSUM_URL}" -o "${TMP_DIR}/checksum.sha256" 2>/dev/null; then
+    EXPECTED=$(awk '{print $1}' "${TMP_DIR}/checksum.sha256")
+    ACTUAL=$(sha256sum "${TMP_DIR}/hadolint" | cut -d' ' -f1)
+    if [ -n "$EXPECTED" ] && [ "$ACTUAL" != "$EXPECTED" ]; then
+        echo "[hadolint] ERROR: Checksum verification failed"
+        echo "  Expected: $EXPECTED"
+        echo "  Actual:   $ACTUAL"
+        rm -rf "${TMP_DIR}"
+        exit 1
+    fi
+    echo "[hadolint] Checksum verified"
+else
+    echo "[hadolint] WARNING: Could not fetch checksum, skipping verification"
+fi
+
+cp "${TMP_DIR}/hadolint" /usr/local/bin/hadolint
+chmod +x /usr/local/bin/hadolint
+rm -rf "${TMP_DIR}"
+
+echo "[hadolint] Installed: $(hadolint --version 2>/dev/null || echo 'unknown')"

package/.devcontainer/features/lsp-servers/devcontainer-feature.json

@@ -6,6 +6,11 @@
   "maintainer": "AnExiledDev",
   "documentationURL": "https://code.claude.com/docs/en/discover-plugins#code-intelligence",
   "options": {
+    "version": {
+      "type": "string",
+      "description": "Set to 'none' to skip installation of all LSP servers",
+      "default": "latest"
+    },
     "pyrightVersion": {
       "type": "string",
       "description": "Pyright npm package version (e.g., 'latest', '1.1.350')",

package/.devcontainer/features/lsp-servers/install.sh

@@ -4,12 +4,19 @@
 
 set -euo pipefail
 
+VERSION="${VERSION:-latest}"
 PYRIGHT_VERSION="${PYRIGHTVERSION:-latest}"
 TSLSP_VERSION="${TYPESCRIPTLSPVERSION:-latest}"
 TS_VERSION="${TYPESCRIPTVERSION:-latest}"
 GOPLS_VERSION="${GOPLSVERSION:-latest}"
 USERNAME="${USERNAME:-automatic}"
 
+# Skip installation if version is "none"
+if [ "${VERSION}" = "none" ]; then
+    echo "[lsp-servers] Skipping installation (version=none)"
+    exit 0
+fi
+
 echo "[lsp-servers] Starting installation..."
 echo "[lsp-servers] Pyright version: ${PYRIGHT_VERSION}"
 echo "[lsp-servers] TypeScript LSP version: ${TSLSP_VERSION}"

package/.devcontainer/features/mcp-qdrant/devcontainer-feature.json

@@ -6,6 +6,11 @@
   "maintainer": "AnExiledDev",
   "documentationURL": "https://github.com/qdrant/mcp-server-qdrant",
   "options": {
+    "version": {
+      "type": "string",
+      "description": "Version to install (or 'none' to skip installation)",
+      "default": "latest"
+    },
     "qdrantUrl": {
       "type": "string",
       "description": "Qdrant instance URL (e.g., https://xyz.cloud.qdrant.io:6333). Leave empty for local instance.",