claudepod 1.1.1 → 1.2.1

package/.devcontainer/devcontainer.json

@@ -1,113 +1,71 @@
-{
-  "name": "ClaudePod Development Environment",
-  "image": "mcr.microsoft.com/vscode/devcontainers/base:ubuntu-22.04",
-
-  "features": {
-    "ghcr.io/devcontainers/features/common-utils:2": {
-      "installZsh": true,
-      "installOhMyZsh": true,
-      "username": "node",
-      "uid": 1000,
-      "gid": 1000,
-      "upgradePackages": true
-    },
-    "ghcr.io/devcontainers/features/node:1": {
-      "nodeGypDependencies": true,
-      "version": "20"
-    },
-    "ghcr.io/devcontainers/features/python:1": {
-      "version": "3.13",
-      "installTools": true,
-      "toolsToInstall": "flake8,autopep8,black,yapf,mypy,pydocstyle,pycodestyle,bandit,pipenv,virtualenv,pytest,pylint"
-    },
-    "ghcr.io/devcontainers/features/git:1": {
-      "version": "latest",
-      "ppa": false
-    },
-    "ghcr.io/devcontainers/features/github-cli:1": {
-      "version": "latest"
-    },
-    "ghcr.io/devcontainers/features/docker-in-docker:2": {
-      "version": "latest",
-      "dockerDashComposeVersion": "v2"
-    }
-  },
-
-  "containerEnv": {
-    "CLAUDE_CONFIG_DIR": "/home/node/.claude",
-    "DEVCONTAINER": "true",
-    "TAVILY_API_KEY": "${localEnv:TAVILY_API_KEY}",
-    "REF_TOOLS_API_KEY": "${localEnv:REF_TOOLS_API_KEY}",
-    "GITHUB_PERSONAL_ACCESS_TOKEN": "${localEnv:GITHUB_PERSONAL_ACCESS_TOKEN}",
-    "GITHUB_API_URL": "${localEnv:GITHUB_API_URL}",
-    "GITHUB_TOOLSET": "${localEnv:GITHUB_TOOLSET}",
-    "ENABLE_SEARXNG_LOCAL": "${localEnv:ENABLE_SEARXNG_LOCAL:-true}",
-    "SEARXNG_LOCAL_INSTALL_DIR": "/opt/searxng-local"
-  },
-
-  "mounts": [
-    "source=${localWorkspaceFolder}/.claude,target=/home/node/.claude,type=bind,consistency=cached",
-    "source=${localWorkspaceFolder}/.serena,target=/home/node/.serena,type=bind,consistency=cached",
-    "source=claudepod-bash-history,target=/home/node/.bash_history,type=volume",
-    "source=claudepod-zsh-history,target=/home/node/.zsh_history,type=volume",
-    "source=claudepod-npm-cache,target=/home/node/.npm,type=volume",
-    "source=claudepod-npm-config,target=/home/node/.config,type=volume",
-    "source=claudepod-npm-global,target=/home/node/.local,type=volume",
-    "source=claudepod-searxng-local,target=/opt/searxng-local,type=volume"
-  ],
-
-  "postCreateCommand": "sudo -E /bin/bash .devcontainer/post-create.sh",
-  "postStartCommand": "/bin/bash .devcontainer/post-start.sh",
-
-  "forwardPorts": [],
-  "portsAttributes": {
-    "*": {
-      "onAutoForward": "openBrowserOnce"
-    }
-  },
-  "otherPortsAttributes": {
-    "onAutoForward": "openBrowser"
-  },
-
-  "customizations": {
-    "vscode": {
-      "extensions": [
-        "ms-vscode-remote.remote-containers",
-        "ms-vscode-remote.remote-ssh",
-        "ms-vscode-remote.remote-ssh-edit",
-        "ms-vscode.remote-explorer",
-        "ms-vscode-remote.vscode-remote-extensionpack",
-        "ms-python.python",
-        "ms-python.vscode-pylance",
-        "dbaeumer.vscode-eslint",
-        "esbenp.prettier-vscode",
-        "GitHub.vscode-pull-request-github",
-        "eamodio.gitlens"
-      ],
-      "settings": {
-        "remote.SSH.defaultExtensions": [
-          "ms-vscode-remote.remote-ssh-edit"
-        ],
-        "terminal.integrated.defaultProfile.linux": "zsh",
-        "terminal.integrated.profiles.linux": {
-          "zsh": {
-            "path": "/usr/bin/zsh",
-            "args": ["-l"]
-          }
-        },
-        "terminal.integrated.shell.linux": "/usr/bin/zsh",
-        "terminal.integrated.shellArgs.linux": ["-l"],
-        "terminal.integrated.fontFamily": "MesloLGS NF, 'Courier New', monospace",
-        "terminal.integrated.fontSize": 14
-      }
-    }
-  },
-
-  "remoteUser": "node",
-  "containerUser": "node",
-
-  "workspaceFolder": "/workspace",
-  "workspaceMount": "source=${localWorkspaceFolder},target=/workspace,type=bind,consistency=cached",
-  
-  "postAttachCommand": "sudo chown -R node:node /workspace"
-}
+{
+  "name": "ClaudePod",
+  "image": "mcr.microsoft.com/devcontainers/python:3.14",
+
+  "workspaceFolder": "/workspaces",
+  "workspaceMount": "source=${localWorkspaceFolder},target=/workspaces,type=bind",
+
+  "remoteEnv": {
+    "WORKSPACE_ROOT": "/workspaces",
+    "CLAUDE_CONFIG_DIR": "/workspaces/.claude",
+    "GH_CONFIG_DIR": "/workspaces/.gh"
+  },
+
+  "overrideFeatureInstallOrder": [
+    "ghcr.io/devcontainers/features/node",
+    "ghcr.io/devcontainers/features/github-cli",
+    "ghcr.io/devcontainers/features/docker-outside-of-docker",
+    "ghcr.io/devcontainers-extra/features/uv",
+    "ghcr.io/anthropics/devcontainer-features/claude-code",
+    "./features/claude-monitor",
+    "./features/ccusage",
+    "./features/ccstatusline",
+    "./features/ast-grep",
+    "./features/tree-sitter",
+    "./features/lsp-servers"
+  ],
+
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {
+      "version": "lts",
+      "nodeGypDependencies": true
+    },
+    "ghcr.io/devcontainers/features/github-cli:1": {},
+    "ghcr.io/devcontainers/features/docker-outside-of-docker:1": 
+    {
+      "moby": false
+    },
+    "ghcr.io/devcontainers-extra/features/uv:1": {},
+    "ghcr.io/anthropics/devcontainer-features/claude-code:1": {},
+    "./features/ccusage": {
+      "version": "latest",
+      "shells": "both",
+      "username": "automatic"
+    },
+    "./features/claude-monitor": {
+      "version": "latest",
+      "installer": "uv",
+      "username": "automatic"
+    },
+    "./features/ccstatusline": {
+      "username": "automatic"
+    },
+    "./features/ast-grep": {},
+    "./features/tree-sitter": {},
+    "./features/lsp-servers": {}
+  },
+
+  "postStartCommand": "bash ${containerWorkspaceFolder}/.devcontainer/scripts/setup.sh",
+
+  "remoteUser": "vscode",
+  "containerUser": "vscode",
+
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "bash"
+      },
+      "extensions": []
+    }
+  }
+}

package/.devcontainer/features/README.md

@@ -0,0 +1,113 @@
+# AgentPod DevContainer Features
+
+This directory contains DevContainer Features for AI coding agent environments. These features follow the [DevContainer Features specification](https://containers.dev/implementors/features/) and can be published to OCI registries for distribution.
+
+## Available Features
+
+### mcp-qdrant
+Vector database integration via Qdrant MCP server. Enables semantic search, embeddings management, and RAG workflows.
+
+**Status**: ✅ Complete
+**Documentation**: [mcp-qdrant/README.md](./mcp-qdrant/README.md)
+
+## Feature Structure
+
+Each feature follows this structure:
+
+```
+feature-name/
+├── devcontainer-feature.json   # Feature metadata and options
+├── install.sh                  # Installation script (executable)
+└── README.md                   # Feature documentation
+```
+
+## Development Workflow
+
+### Creating a New Feature
+
+1. **Create directory**: `mkdir features/feature-name`
+2. **Add metadata**: Create `devcontainer-feature.json`
+3. **Write installer**: Create `install.sh` (make executable)
+4. **Document**: Create `README.md`
+5. **Test locally**: Reference in devcontainer.json
+
+### Local Testing
+
+To test a feature locally before publishing:
+
+```json
+{
+  "features": {
+    "./features/feature-name": {
+      "option1": "value1"
+    }
+  }
+}
+```
+
+### Publishing Features
+
+Features will be published to GitHub Container Registry (GHCR):
+
+```
+ghcr.io/yourorg/agentpod-features/feature-name:1
+```
+
+**Publishing workflow** (future):
+- Push to main branch
+- GitHub Actions builds and publishes
+- Tags create versioned releases
+
+## Feature Guidelines
+
+### Granularity
+- **One feature = One tool/service**
+- Bundle only if tools are always used together
+- See [AGENTPOD_ARCHITECTURE.md](../../AGENTPOD_ARCHITECTURE.md) for guidance
+
+### Options
+- Use clear, descriptive option names
+- Provide sensible defaults
+- Support environment variable substitution: `"${env:VAR}"`
+- Document all options in README
+
+### Installation
+- Must be idempotent (safe to run multiple times)
+- Check if already installed before installing
+- Use appropriate user (not always root)
+- Clean up on failure
+
+### Configuration
+- Generate necessary config files
+- Provide helper scripts for manual setup
+- Print clear installation summary
+- Show next steps to user
+
+## Migration from Modules
+
+ClaudePod modules are being converted to DevContainer Features:
+
+| Old Module | New Feature | Status |
+|-----------|-------------|---------|
+| mcp_qdrant | mcp-qdrant | ✅ Complete |
+| mcp_browser | mcp-browser | 🔜 Planned |
+| mcp_sourcerer | mcp-sourcerer | 🔜 Planned |
+| mcp_reasoner | mcp-reasoner | 🔜 Planned |
+| mcp_obsidian | mcp-obsidian | 🔜 Planned |
+| mcp_code_runner | mcp-code-runner | 🔜 Planned |
+
+## Resources
+
+- [DevContainer Features Specification](https://containers.dev/implementors/features/)
+- [Feature Authoring Guide](https://containers.dev/guide/author-a-feature)
+- [Feature Best Practices](https://containers.dev/guide/feature-authoring-best-practices)
+- [AgentPod Architecture](../../AGENTPOD_ARCHITECTURE.md)
+
+## Contributing
+
+Features are part of the AgentPod project. See main repository for contribution guidelines.
+
+---
+
+**Status**: Active Development
+**Last Updated**: 2025-11-11

package/.devcontainer/features/ast-grep/README.md

@@ -0,0 +1,24 @@
+# ast-grep (Feature)
+
+Installs [ast-grep](https://ast-grep.github.io/) CLI via npm for structural code search, lint, and rewriting using AST matching.
+
+## Usage
+
+```json
+{
+  "features": {
+    "./features/ast-grep": {}
+  }
+}
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `version` | string | `latest` | @ast-grep/cli npm package version |
+| `username` | string | `automatic` | Container user to install for |
+
+## Dependencies
+
+Requires Node.js: `ghcr.io/devcontainers/features/node:1`

package/.devcontainer/features/ast-grep/devcontainer-feature.json

@@ -0,0 +1,24 @@
+{
+  "id": "ast-grep",
+  "version": "1.0.0",
+  "name": "ast-grep",
+  "description": "Installs ast-grep CLI for structural code search, lint, and rewriting using AST matching",
+  "maintainer": "AnExiledDev",
+  "documentationURL": "https://ast-grep.github.io/",
+  "options": {
+    "version": {
+      "type": "string",
+      "description": "@ast-grep/cli npm package version (e.g., 'latest', '0.31.1')",
+      "default": "latest"
+    },
+    "username": {
+      "type": "string",
+      "description": "Container user to install for",
+      "default": "automatic"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/common-utils:2",
+    "ghcr.io/devcontainers/features/node:1"
+  ]
+}

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

@@ -0,0 +1,51 @@
+#!/bin/bash
+set -euo pipefail
+
+VERSION="${VERSION:-latest}"
+USERNAME="${USERNAME:-automatic}"
+
+echo "[ast-grep] Starting installation..."
+echo "[ast-grep] Version: ${VERSION}"
+
+# Source nvm if available
+if [ -f /usr/local/share/nvm/nvm.sh ]; then
+    source /usr/local/share/nvm/nvm.sh
+fi
+
+# Validate npm is available
+if ! command -v npm &>/dev/null; then
+    echo "[ast-grep] ERROR: npm not available"
+    echo "  Ensure node feature is installed first"
+    exit 1
+fi
+
+# Detect user
+if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
+    if [ -n "${_REMOTE_USER:-}" ]; then
+        USERNAME="${_REMOTE_USER}"
+    elif getent passwd vscode >/dev/null 2>&1; then
+        USERNAME="vscode"
+    elif getent passwd node >/dev/null 2>&1; then
+        USERNAME="node"
+    elif getent passwd codespace >/dev/null 2>&1; then
+        USERNAME="codespace"
+    else
+        USERNAME="root"
+    fi
+fi
+
+echo "[ast-grep] Installing for user: ${USERNAME}"
+
+# Install via npm
+if [ "${VERSION}" = "latest" ]; then
+    NPM_PACKAGE="@ast-grep/cli"
+else
+    NPM_PACKAGE="@ast-grep/cli@${VERSION}"
+fi
+
+npm install -g "${NPM_PACKAGE}" 2>/dev/null || {
+    echo "[ast-grep] WARNING: Global install failed, trying user install"
+    su - "${USERNAME}" -c "npm install -g ${NPM_PACKAGE}" 2>/dev/null || true
+}
+
+echo "[ast-grep] Installed: $(ast-grep --version 2>/dev/null || echo 'unknown')"