claudepod 1.1.2 → 1.2.2

package/.devcontainer/features/mcp-reasoner/install.sh

@@ -0,0 +1,177 @@
+#!/bin/bash
+set -euo pipefail
+
+# No cleanup needed - using CLI instead of temp files
+
+# Import options
+USERNAME="${USERNAME:-automatic}"
+
+echo "[mcp-reasoner] Starting MCP Reasoner installation..."
+
+# Source NVM (Node is installed via NVM by the node feature)
+if [ -f /usr/local/share/nvm/nvm.sh ]; then
+    source /usr/local/share/nvm/nvm.sh
+fi
+
+# Validate node is available
+if ! command -v node &>/dev/null; then
+    echo "[mcp-reasoner] ERROR: node is not available. Please ensure node feature is installed first."
+    echo "  NVM path: /usr/local/share/nvm/nvm.sh"
+    exit 1
+fi
+
+# Validate npm is available
+if ! command -v npm &>/dev/null; then
+    echo "[mcp-reasoner] ERROR: npm is not available. Please ensure node feature is installed first."
+    exit 1
+fi
+
+# Determine the user
+if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
+    USERNAME=""
+    for CURRENT_USER in vscode node codespace; do
+        if id -u "${CURRENT_USER}" >/dev/null 2>&1; then
+            USERNAME=${CURRENT_USER}
+            break
+        fi
+    done
+    [ -z "${USERNAME}" ] && USERNAME=root
+elif [ "${USERNAME}" = "none" ] || ! id -u "${USERNAME}" >/dev/null 2>&1; then
+    USERNAME=root
+fi
+
+echo "[mcp-reasoner] Installing for user: ${USERNAME}"
+
+INSTALL_DIR="/home/${USERNAME}/mcp-reasoner"
+DIST_FILE="${INSTALL_DIR}/dist/index.js"
+
+if [[ -f "$DIST_FILE" ]]; then
+    echo "[mcp-reasoner] MCP-reasoner installation already present. Skipping..."
+else
+    echo "[mcp-reasoner] Installing MCP-reasoner to ${INSTALL_DIR}"
+
+    # Clone and build as detected user with NVM environment
+    sudo -u "${USERNAME}" bash -c "
+        source /usr/local/share/nvm/nvm.sh
+        cd /home/${USERNAME}
+
+        # Remove existing directory if present (handles failed previous runs)
+        rm -rf mcp-reasoner
+
+        # Clone the repository
+        git clone https://github.com/Jacck/mcp-reasoner.git
+        cd mcp-reasoner
+
+        # Install dependencies and build
+        npm install
+        npm run build
+    "
+
+    # Verify installation
+    if [[ ! -f "$DIST_FILE" ]]; then
+        echo "[mcp-reasoner] ERROR: MCP-reasoner installation failed - dist/index.js not found"
+        exit 1
+    fi
+
+    echo "[mcp-reasoner] MCP-reasoner installed successfully"
+fi
+
+# Create post-start hook for Claude Code registration
+echo "[mcp-reasoner] Creating post-start hook for Claude Code registration..."
+mkdir -p /usr/local/devcontainer-poststart.d
+
+cat > /usr/local/devcontainer-poststart.d/51-mcp-reasoner.sh <<'HOOK_EOF'
+#!/bin/bash
+set -euo pipefail
+
+echo "[mcp-reasoner] Registering Reasoner MCP server with Claude Code..."
+
+# Determine user
+USERNAME="${USERNAME:-vscode}"
+if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
+    for CURRENT_USER in vscode node codespace; do
+        if id -u "${CURRENT_USER}" >/dev/null 2>&1; then
+            USERNAME=${CURRENT_USER}
+            break
+        fi
+    done
+fi
+
+# Check if reasoner is installed
+REASONER_PATH="/home/${USERNAME}/mcp-reasoner/dist/index.js"
+if [ ! -f "$REASONER_PATH" ]; then
+    echo "[mcp-reasoner] WARNING: Reasoner not found at $REASONER_PATH, skipping registration"
+    exit 0
+fi
+
+# Ensure settings.json exists
+SETTINGS_FILE="/workspaces/.claude/settings.json"
+if [ ! -f "$SETTINGS_FILE" ]; then
+    echo "[mcp-reasoner] ERROR: $SETTINGS_FILE not found"
+    exit 1
+fi
+
+# Check if jq is available
+if ! command -v jq &>/dev/null; then
+    echo "[mcp-reasoner] ERROR: jq not available"
+    exit 1
+fi
+
+# Build the server configuration
+SERVER_CONFIG=$(jq -n \
+    --arg cmd "node" \
+    --arg path "$REASONER_PATH" \
+    '{
+        command: $cmd,
+        args: [$path]
+    }')
+
+# Update settings.json - add or update reasoner server
+# Create temporary file for atomic update
+TEMP_FILE=$(mktemp)
+jq --argjson server "$SERVER_CONFIG" \
+    '.mcpServers.reasoner = $server' \
+    "$SETTINGS_FILE" > "$TEMP_FILE"
+
+# Verify the JSON is valid
+if jq empty "$TEMP_FILE" 2>/dev/null; then
+    mv "$TEMP_FILE" "$SETTINGS_FILE"
+    echo "[mcp-reasoner] ✓ Reasoner MCP server registered in Claude Code settings"
+else
+    echo "[mcp-reasoner] ERROR: Generated invalid JSON"
+    rm -f "$TEMP_FILE"
+    exit 1
+fi
+
+# Set proper permissions
+chmod 644 "$SETTINGS_FILE"
+chown vscode:vscode "$SETTINGS_FILE" 2>/dev/null || true
+
+echo "[mcp-reasoner] ✓ Configuration complete"
+HOOK_EOF
+
+chmod +x /usr/local/devcontainer-poststart.d/51-mcp-reasoner.sh
+echo "[mcp-reasoner] ✓ Post-start hook created at /usr/local/devcontainer-poststart.d/51-mcp-reasoner.sh"
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  MCP Reasoner Installation Complete"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Configuration:"
+echo "  • Install Path: ${INSTALL_DIR}"
+echo "  • User: ${USERNAME}"
+echo "  • MCP Server: reasoner (native devcontainer support)"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Next Steps"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "1. MCP server will auto-register with Claude Code on container start"
+echo ""
+echo "2. Test the server directly:"
+echo "   node ${DIST_FILE}"
+echo ""
+echo "3. Verify available MCP servers in your AI agent"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/.devcontainer/features/mcp-reasoner/poststart-hook.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+set -euo pipefail
+
+echo "[mcp-reasoner] Registering Reasoner MCP server with Claude Code..."
+
+# Determine user
+USERNAME="${USERNAME:-vscode}"
+if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
+    for CURRENT_USER in vscode node codespace; do
+        if id -u "${CURRENT_USER}" >/dev/null 2>&1; then
+            USERNAME=${CURRENT_USER}
+            break
+        fi
+    done
+fi
+
+# Check if reasoner is installed
+REASONER_PATH="/home/${USERNAME}/mcp-reasoner/dist/index.js"
+if [ ! -f "$REASONER_PATH" ]; then
+    echo "[mcp-reasoner] WARNING: Reasoner not found at $REASONER_PATH, skipping registration"
+    exit 0
+fi
+
+# Ensure settings.json exists
+SETTINGS_FILE="/workspaces/.claude/settings.json"
+if [ ! -f "$SETTINGS_FILE" ]; then
+    echo "[mcp-reasoner] ERROR: $SETTINGS_FILE not found"
+    exit 1
+fi
+
+# Check if jq is available
+if ! command -v jq &>/dev/null; then
+    echo "[mcp-reasoner] ERROR: jq not available"
+    exit 1
+fi
+
+# Build the server configuration
+SERVER_CONFIG=$(jq -n \
+    --arg cmd "node" \
+    --arg path "$REASONER_PATH" \
+    '{
+        command: $cmd,
+        args: [$path]
+    }')
+
+# Update settings.json - add or update reasoner server
+# Create temporary file for atomic update
+TEMP_FILE=$(mktemp)
+jq --argjson server "$SERVER_CONFIG" \
+    '.mcpServers.reasoner = $server' \
+    "$SETTINGS_FILE" > "$TEMP_FILE"
+
+# Verify the JSON is valid
+if jq empty "$TEMP_FILE" 2>/dev/null; then
+    mv "$TEMP_FILE" "$SETTINGS_FILE"
+    echo "[mcp-reasoner] ✓ Reasoner MCP server registered in Claude Code settings"
+else
+    echo "[mcp-reasoner] ERROR: Generated invalid JSON"
+    rm -f "$TEMP_FILE"
+    exit 1
+fi
+
+# Set proper permissions
+chmod 644 "$SETTINGS_FILE"
+chown vscode:vscode "$SETTINGS_FILE" 2>/dev/null || true
+
+echo "[mcp-reasoner] ✓ Configuration complete"

package/.devcontainer/features/splitrail/README.md

@@ -0,0 +1,140 @@
+# Splitrail Token Usage Tracker Feature
+
+A DevContainer Feature that installs Splitrail - a real-time AI token usage tracker and cost monitor for AI coding agents.
+
+## Quick Start
+
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/rust:1": {},
+    "ghcr.io/devcontainers/features/common-utils:2": {},
+    "./features/splitrail": {}
+  }
+}
+```
+
+**Note:** This feature requires Rust and common-utils features to be installed first.
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `repoUrl` | string | `https://github.com/Piebald-AI/splitrail.git` | Git repository URL |
+| `branch` | string | `main` | Git branch to checkout |
+| `username` | string | `automatic` | User to install for (auto-detects: vscode, node, codespace, or root) |
+
+## What This Feature Installs
+
+- **splitrail**: Compiled from source (Rust)
+- **Binary Location**: `/home/{username}/.cargo/bin/splitrail`
+- **Compile Time**: 2-3 minutes on first build
+- **Disk Usage**: ~50MB source + build artifacts
+
+## Requirements
+
+This feature has explicit dependencies that **must** be installed first:
+
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/rust:1": {},
+    "ghcr.io/devcontainers/features/common-utils:2": {},
+    "./features/splitrail": {}
+  }
+}
+```
+
+**Required by this feature:**
+- **Rust + Cargo**: For compiling splitrail from source
+- **Git**: For cloning the repository
+
+The feature will validate these are present and exit with an error if missing.
+
+## Features
+
+- ✅ **Real-time Tracking**: Monitor token usage as you code
+- ✅ **Cost Monitoring**: Track costs for different AI models
+- ✅ **Multi-agent Support**: Supports Claude Code, Gemini, Codex
+- ✅ **Cloud Upload**: Optional private cloud aggregation across machines
+- ✅ **Fast Performance**: Written in Rust for minimal overhead
+- ✅ **Idempotent**: Safe to run multiple times
+- ✅ **Multi-user**: Automatically detects container user
+
+## Usage
+
+### Start Monitoring
+
+```bash
+splitrail
+```
+
+### Check Version
+
+```bash
+splitrail --version
+```
+
+### View Help
+
+```bash
+splitrail --help
+```
+
+## Architecture
+
+```
+AI Agent (Claude Code, etc.)
+    ↓
+Splitrail monitors usage
+    ↓
+Real-time display + optional cloud upload
+```
+
+## Troubleshooting
+
+### Compilation Fails
+
+**Cause:** Rust/Cargo not available
+
+**Solution:** Ensure Rust feature is installed first:
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/rust:1": {},
+    "./features/splitrail": {}
+  }
+}
+```
+
+### Binary Not Found
+
+**Symptom:** `splitrail: command not found`
+
+**Solution:** Check the binary location:
+```bash
+ls -la /home/node/.cargo/bin/splitrail
+# Should exist
+
+# Verify PATH includes cargo bin
+echo $PATH | grep cargo
+```
+
+### Build Errors
+
+**Symptom:** Cargo build fails during compilation
+
+**Checks:**
+- Verify Rust version: `rustc --version`
+- Check cargo: `cargo --version`
+- Review build output for specific errors
+- Try cleaning: `cd ~/splitrail && cargo clean && cargo build --release`
+
+## Resources
+
+- [Splitrail GitHub](https://github.com/Piebald-AI/splitrail)
+- [Rust Language](https://www.rust-lang.org/)
+
+## License
+
+MIT License - See repository for details.

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

@@ -0,0 +1,34 @@
+{
+  "id": "splitrail",
+  "version": "1.0.1",
+  "name": "Splitrail Token Usage Tracker",
+  "description": "Installs Splitrail - real-time AI token usage tracker and cost monitor",
+  "maintainer": "AnExiledDev",
+  "documentationURL": "https://github.com/Piebald-AI/splitrail",
+  "options": {
+    "repoUrl": {
+      "type": "string",
+      "description": "Git repository URL for splitrail",
+      "default": "https://github.com/Piebald-AI/splitrail.git"
+    },
+    "branch": {
+      "type": "string",
+      "description": "Git branch to checkout",
+      "default": "main"
+    },
+    "username": {
+      "type": "string",
+      "description": "Container user to install for",
+      "default": "automatic"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/rust:1",
+    "ghcr.io/devcontainers/features/common-utils:2"
+  ],
+  "customizations": {
+    "vscode": {
+      "extensions": []
+    }
+  }
+}

package/.devcontainer/features/splitrail/install.sh

@@ -0,0 +1,129 @@
+#!/bin/bash
+set -euo pipefail
+
+# Cleanup on exit
+cleanup() {
+    rm -f /tmp/splitrail-* 2>/dev/null || true
+}
+trap cleanup EXIT
+
+# Import options
+# NOTE: DevContainer converts camelCase to UPPERCASE without underscores
+REPO_URL="${REPOURL:-https://github.com/Piebald-AI/splitrail.git}"
+BRANCH="${BRANCH:-main}"
+USERNAME="${USERNAME:-automatic}"
+
+echo "[splitrail] Starting Splitrail installation..."
+
+# Validate git is available
+if ! command -v git &>/dev/null; then
+    echo "[splitrail] ERROR: git is not available"
+    exit 1
+fi
+
+# Validate cargo is available
+if ! command -v cargo &>/dev/null; then
+    echo "[splitrail] ERROR: cargo is not available. Please ensure Rust feature is installed first."
+    echo "  Expected cargo at: /usr/local/cargo/bin/cargo"
+    exit 1
+fi
+
+# Validate input parameters
+if [ -n "${REPO_URL}" ]; then
+    if [[ ! "${REPO_URL}" =~ ^https?:// ]] && [[ ! "${REPO_URL}" =~ ^git@.+:.+\.git$ ]]; then
+        echo "[splitrail] ERROR: repoUrl must be a valid git URL"
+        echo "  Provided: ${REPO_URL}"
+        echo "  Expected: https://... or git@github.com:.../*.git"
+        exit 1
+    fi
+fi
+
+# Determine the user
+if [ "${USERNAME}" = "auto" ] || [ "${USERNAME}" = "automatic" ]; then
+    USERNAME=""
+    for CURRENT_USER in vscode node codespace; do
+        if id -u "${CURRENT_USER}" >/dev/null 2>&1; then
+            USERNAME=${CURRENT_USER}
+            break
+        fi
+    done
+    [ -z "${USERNAME}" ] && USERNAME=root
+elif [ "${USERNAME}" = "none" ] || ! id -u "${USERNAME}" >/dev/null 2>&1; then
+    USERNAME=root
+fi
+
+echo "[splitrail] Installing for user: ${USERNAME}"
+
+INSTALL_DIR="/home/${USERNAME}/splitrail"
+BINARY="/home/${USERNAME}/.cargo/bin/splitrail"
+
+if [[ -f "$BINARY" ]]; then
+    echo "[splitrail] Splitrail already installed at $BINARY. Skipping..."
+else
+    echo "[splitrail] Installing Splitrail (Rust compilation - may take 2-3 minutes)..."
+
+    # Use explicit cargo path and rustup home (global installation from devcontainer Rust feature)
+    export PATH="/usr/local/cargo/bin:$PATH"
+    export RUSTUP_HOME="/usr/local/rustup"
+
+    # Fix permissions on rustup directories for non-root user access during build
+    mkdir -p /usr/local/rustup/tmp
+    chmod -R 777 /usr/local/rustup 2>/dev/null || true
+
+    # Clone and build as detected user
+    sudo -u "${USERNAME}" bash -c "
+        # Use explicit cargo path and rustup home for user context
+        export PATH=\"/usr/local/cargo/bin:\$PATH\"
+        export RUSTUP_HOME=\"/usr/local/rustup\"
+
+        cd /home/${USERNAME}
+        rm -rf splitrail
+
+        echo \"[splitrail] → Cloning splitrail repository...\"
+        git clone -b \"${BRANCH}\" \"${REPO_URL}\" splitrail
+        cd splitrail
+
+        echo \"[splitrail] → Compiling splitrail (this will take a few minutes)...\"
+        cargo build --release
+
+        echo \"[splitrail] → Installing binary...\"
+        cargo install --path .
+    "
+
+    # Verify installation
+    if [[ ! -f "$BINARY" ]]; then
+        echo "[splitrail] ERROR: Splitrail compilation failed - binary not found"
+        echo "  Expected location: $BINARY"
+        echo "  Check build output above for errors"
+        exit 1
+    fi
+
+    echo "[splitrail] ✓ Splitrail installed successfully at $BINARY"
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Splitrail Installation Complete"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Configuration:"
+echo "  • Install Path: ${INSTALL_DIR}"
+echo "  • Binary: ${BINARY}"
+echo "  • Repository: ${REPO_URL}"
+echo "  • Branch: ${BRANCH}"
+echo "  • User: ${USERNAME}"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Next Steps"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "1. Test the binary:"
+echo "   splitrail --version"
+echo ""
+echo "2. Start monitoring:"
+echo "   splitrail"
+echo ""
+echo "3. View help:"
+echo "   splitrail --help"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/.devcontainer/features/tree-sitter/README.md

@@ -0,0 +1,138 @@
+# Tree-sitter Parser Feature
+
+Installs [tree-sitter](https://tree-sitter.github.io/tree-sitter/) parsing library with Node.js and Python bindings.
+
+## Usage
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {}
+  }
+}
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `version` | string | `latest` | tree-sitter version (e.g., `0.24.4`) |
+| `bindings` | enum | `both` | Language bindings: `node`, `python`, `both`, `none` |
+| `installCli` | boolean | `true` | Install tree-sitter CLI tool (requires Node.js) |
+| `grammars` | string | `javascript,typescript,python` | Comma-separated grammars to preload |
+| `username` | string | `automatic` | Container user to install for |
+
+## Examples
+
+### Default (CLI + Node + Python + JS/TS/Python grammars)
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {}
+  }
+}
+```
+
+### With Additional Grammars
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {
+      "grammars": "javascript,typescript,python,rust,go,json"
+    }
+  }
+}
+```
+
+### Node.js Only
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {
+      "bindings": "node",
+      "grammars": "javascript,typescript"
+    }
+  }
+}
+```
+
+### Python Only (No CLI)
+
+```json
+{
+  "features": {
+    "./features/tree-sitter": {
+      "bindings": "python",
+      "installCli": false,
+      "grammars": "python"
+    }
+  }
+}
+```
+
+## Installed Components
+
+### CLI (`installCli: true`)
+
+- `tree-sitter` CLI installed via npm ([tree-sitter-cli](https://www.npmjs.com/package/tree-sitter-cli))
+- Requires Node.js to be installed
+
+### Node.js Bindings (`bindings: "node"` or `"both"`)
+
+- `web-tree-sitter` - WebAssembly-based tree-sitter for Node.js
+- Grammar packages as `tree-sitter-{language}`
+
+### Python Bindings (`bindings: "python"` or `"both"`)
+
+- `tree-sitter` - Python bindings package
+- Grammar packages as `tree-sitter-{language}`
+
+## Available Grammars
+
+Common grammars available via npm/pip:
+
+- `javascript`, `typescript`, `tsx`
+- `python`, `rust`, `go`, `c`, `cpp`
+- `java`, `ruby`, `php`, `swift`
+- `json`, `yaml`, `toml`, `html`, `css`
+- `bash`, `markdown`, `regex`
+
+## Dependencies
+
+This feature requires:
+
+- **Node.js** (via `ghcr.io/devcontainers/features/node:1`) - required for CLI and Node bindings
+- **Python** (via `ghcr.io/devcontainers/features/python:1`) - for Python bindings only
+
+## Quick Start
+
+### Node.js
+
+```javascript
+const Parser = require('web-tree-sitter');
+
+await Parser.init();
+const parser = new Parser();
+
+const JavaScript = await Parser.Language.load('path/to/tree-sitter-javascript.wasm');
+parser.setLanguage(JavaScript);
+
+const tree = parser.parse('const x = 1;');
+console.log(tree.rootNode.toString());
+```
+
+### Python
+
+```python
+import tree_sitter_python as tspython
+from tree_sitter import Language, Parser
+
+PY_LANGUAGE = Language(tspython.language())
+parser = Parser(PY_LANGUAGE)
+
+tree = parser.parse(b"def hello(): pass")
+print(tree.root_node.sexp())
+```