claudepod 1.1.2 → 1.2.1

package/.devcontainer/features/ccstatusline/README.md

@@ -0,0 +1,296 @@
+# ccstatusline Feature
+
+A DevContainer Feature that installs and configures [ccstatusline](https://github.com/sirmalloc/ccstatusline) - a compact powerline status line for Claude Code with essential metrics.
+
+## Quick Start
+
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {},
+    "ghcr.io/devcontainers/features/common-utils:2": {},
+    "./features/ccstatusline": {}
+  }
+}
+```
+
+**Note:** This feature requires Node.js and common-utils features to be installed first.
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `username` | string | `automatic` | User to install for (auto-detects: vscode, node, codespace, or root) |
+
+## Display Format
+
+### Line 1: Core Metrics
+```
+Model: Opus 4.1 ▶ Ctx: 58.5k ▶ main ▶ (+19, -2) ▶ v1.0.86
+```
+
+- **Model** (maroon bg, white text, bold): Current AI model
+- **Context** (gold bg, black text, bold): Context window size
+- **Git Branch** (blue bg, white text): Active branch
+- **Git Changes** (pink bg, white text): Lines added/removed
+- **Version** (light pink bg, white text): Claude Code version
+
+### Line 2: Location & Cost
+```
+cwd: .../workspaces/project ▶ Cost: $0.39
+```
+
+- **Working Directory** (gold bg, black text): Current directory path
+- **Session Cost** (gold bg, black text, bold): Total session cost in USD
+
+All widgets connected with powerline arrows for a seamless, professional appearance.
+
+## What This Feature Installs
+
+- **ccstatusline npm package**: Installed on-demand via `npx` (not globally)
+- **Configuration file**: `~/.config/ccstatusline/settings.json` with powerline theme
+- **Claude Code integration**: Automatically updates `.claude/settings.json`
+- **Disk Usage**: Minimal (~2MB when cached by npx)
+
+## Requirements
+
+This feature has explicit dependencies that **must** be installed first:
+
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {},
+    "ghcr.io/devcontainers/features/common-utils:2": {},
+    "./features/ccstatusline": {}
+  }
+}
+```
+
+**Required:**
+- **Node.js + npm/npx**: For running ccstatusline package
+- **jq**: For safe JSON generation (from common-utils)
+
+The feature will validate these are present and exit with an error if missing.
+
+## Features
+
+- ✅ **Powerline Mode**: Seamless arrow separators between widgets
+- ✅ **Compact Layout**: 2 clean lines with essential metrics
+- ✅ **7 Key Widgets**: Model, context, git status, version, directory, cost
+- ✅ **Vibrant Colors**: High-contrast truecolor (24-bit hex) optimized for dark terminals
+- ✅ **Automatic Integration**: Auto-configures `.claude/settings.json`
+- ✅ **Idempotent**: Safe to run multiple times
+- ✅ **Multi-user**: Automatically detects container user
+
+## Post-Installation Steps
+
+### ✅ Configuration is Automatic
+
+This feature automatically:
+1. Creates `~/.config/ccstatusline/settings.json` with powerline configuration
+2. Configures `.claude/settings.json` to use ccstatusline
+
+**No manual steps required!**
+
+### Verify It Worked
+
+**1. Check configuration:**
+```bash
+cat ~/.config/ccstatusline/settings.json | jq .
+```
+
+**2. Test manually:**
+```bash
+echo '{"model":{"display_name":"Test Model"}}' | npx -y ccstatusline@latest
+```
+
+You should see formatted output with powerline styling.
+
+**3. Check Claude Code integration:**
+```bash
+cat /workspaces/.claude/settings.json | jq '.statusLine'
+```
+
+Should show:
+```json
+{
+  "type": "command",
+  "command": "npx -y ccstatusline@latest"
+}
+```
+
+## Customization
+
+### Modify Configuration After Installation
+
+Edit the configuration file:
+```bash
+vim ~/.config/ccstatusline/settings.json
+```
+
+**Important:** Changes to runtime config are lost on container rebuild. To persist changes, modify the feature's `install.sh` file where the JSON is generated (lines 60-80).
+
+### Widget Configuration Format
+
+Widgets are configured in the `lines` array:
+
+```json
+{
+  "id": "unique-id",
+  "type": "widget-type",
+  "color": "#FFFFFF",     // Foreground (hex)
+  "bgColor": "#000000",   // Background (hex)
+  "bold": true            // Optional: bold text
+}
+```
+
+### Available Widget Types
+
+**Session Metrics:**
+- `model` - Current AI model
+- `session-clock` - Session elapsed time
+- `session-cost` - Total session cost (USD)
+- `block-timer` - Block execution time
+- `output-style` - Current output style
+
+**Context Tracking:**
+- `context-length` - Context window size
+- `context-percentage` - Context usage percentage
+- `context-percentage-usable` - Usable context percentage
+
+**Token Metrics:**
+- `tokens-input` - Input tokens
+- `tokens-output` - Output tokens
+- `tokens-cached` - Cached tokens
+- `tokens-total` - Total tokens
+
+**Git Integration:**
+- `git-branch` - Current branch
+- `git-changes` - Lines added/removed
+- `git-worktree` - Git worktree info
+
+**Other:**
+- `cwd` - Current working directory
+- `version` - Claude Code version
+- `custom-text` - Static text
+- `custom-command` - Command output
+
+### Color Scheme
+
+The default powerline theme uses:
+
+- **Maroon** (`#9B4F5C`): Model name - bold, authoritative
+- **Gold** (`#FFD700`): Context, directory, cost - attention-grabbing
+- **Blue** (`#4A90E2`): Git branch - clear, standard
+- **Pink/Magenta** (`#D888C8`, `#E8A8C8`): Git changes and version - distinctive
+- **White** (`#FFFFFF`): Text on dark backgrounds
+- **Black** (`#1E1E1E`): Text on gold background
+
+All colors selected for excellent readability on dark terminal themes with proper contrast ratios.
+
+## Troubleshooting
+
+### Status Line Doesn't Appear
+
+**Symptom:** Claude Code starts but no status line visible
+
+**Solution:**
+```bash
+# 1. Verify config exists
+cat ~/.config/ccstatusline/settings.json | jq .
+
+# 2. Test manually
+echo '{"model":{"display_name":"Test"}}' | npx -y ccstatusline@latest
+
+# 3. Check Claude Code settings
+cat /workspaces/.claude/settings.json | jq '.statusLine'
+
+# 4. Manually run auto-config if needed
+configure-ccstatusline-auto
+
+# 5. Restart Claude Code
+```
+
+### Installation Fails: "npm/npx not available"
+
+**Cause:** Node.js feature not installed first
+
+**Solution:**
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {},
+    "./features/ccstatusline": {}
+  }
+}
+```
+
+### Installation Fails: "jq not available"
+
+**Cause:** common-utils feature not installed
+
+**Solution:**
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/common-utils:2": {},
+    "./features/ccstatusline": {}
+  }
+}
+```
+
+### Display Issues (Broken Arrows, Colors)
+
+**Cause:** Terminal doesn't support powerline fonts or truecolor
+
+**Solutions:**
+1. Install powerline fonts in your terminal
+2. Check terminal supports 24-bit color (truecolor)
+3. For VS Code: Ensure using a powerline-compatible font like "Cascadia Code PL" or "MesloLGS NF"
+
+### Performance Issues (Slow Refresh)
+
+**Cause:** `npx` downloads package on each run
+
+**Solution:** Install globally for faster execution:
+```bash
+npm install -g ccstatusline@latest
+```
+
+Then update `.claude/settings.json`:
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "ccstatusline"
+  }
+}
+```
+
+### Permission Errors
+
+**Symptom:** "Permission denied" on config file
+
+**Solution:**
+```bash
+# Check ownership
+ls -la ~/.config/ccstatusline/settings.json
+
+# Fix if needed (replace 'vscode' with your username)
+sudo chown -R vscode:vscode ~/.config/ccstatusline/
+```
+
+## Resources
+
+- [ccstatusline GitHub](https://github.com/sirmalloc/ccstatusline)
+- [ccstatusline npm package](https://www.npmjs.com/package/ccstatusline)
+- [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code/statusline)
+- [Powerline Fonts](https://github.com/powerline/fonts)
+
+## License
+
+This feature configuration is MIT licensed. The ccstatusline package has its own license (see npm package).
+
+---
+
+**Part of your DevContainer Features collection**

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

@@ -0,0 +1,19 @@
+{
+  "id": "ccstatusline",
+  "version": "1.0.0",
+  "name": "ccstatusline",
+  "description": "Compact powerline status line for Claude Code with essential metrics",
+  "maintainer": "AnExiledDev",
+  "documentationURL": "https://github.com/sirmalloc/ccstatusline",
+  "options": {
+    "username": {
+      "type": "string",
+      "description": "Container user to install for",
+      "default": "automatic"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/node:1",
+    "ghcr.io/devcontainers/features/common-utils:2"
+  ]
+}

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

@@ -0,0 +1,290 @@
+#!/bin/bash
+set -euo pipefail
+
+# Cleanup on exit
+cleanup() {
+    rm -f /tmp/ccstatusline-*.json 2>/dev/null || true
+}
+trap cleanup EXIT
+
+# Import options from devcontainer-feature.json
+# NOTE: DevContainer converts camelCase options to UPPERCASE without underscores
+USERNAME="${USERNAME:-automatic}"
+
+echo "[ccstatusline] Starting 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 jq is available (required for JSON generation)
+if ! command -v jq &>/dev/null; then
+    echo "[ccstatusline] ERROR: jq is not available"
+    echo "  Install common-utils feature first"
+    exit 1
+fi
+
+# Validate npm/npx is available
+if ! command -v npm &>/dev/null && ! command -v npx &>/dev/null; then
+    echo "[ccstatusline] ERROR: npm/npx is not available"
+    echo "  Install node feature first"
+    echo "  NVM path: /usr/local/share/nvm/nvm.sh"
+    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 "[ccstatusline] Installing for user: ${USERNAME}"
+
+# Get user's home directory
+USER_HOME=$(eval echo ~${USERNAME})
+
+# Check if ccstatusline is available
+if sudo -u "${USERNAME}" bash -c 'npx -y ccstatusline@latest --version' &>/dev/null 2>&1; then
+    echo "[ccstatusline] ccstatusline already available via npx"
+else
+    echo "[ccstatusline] ccstatusline will be cached on first use via npx"
+fi
+
+echo "[ccstatusline] Generating powerline configuration..."
+
+# Generate powerline configuration using jq (ANSI colors - same as module)
+CONFIG_JSON=$(jq -n '{
+    version: 3,
+    lines: [
+        [
+            {id: "1", type: "context-length", color: "cyan"},
+            {id: "3", type: "git-branch", color: "brightBlack"},
+            {id: "5", type: "tokens-input", color: "magenta"},
+            {id: "7", type: "session-clock", color: "yellow"},
+            {id: "1eafc42e-f222-4090-a463-46de6ba81849", type: "output-style", backgroundColor: "bgBrightBlack"}
+        ],
+        [
+            {id: "db519d5a-80a7-4b44-8a9c-2c7d8c0a7176", type: "context-percentage-usable", backgroundColor: "bgRed"},
+            {id: "a529e50e-b9f3-4150-a812-937ab81545e8", type: "git-changes", backgroundColor: "bgBrightBlue"},
+            {id: "ac094d46-3673-4d41-84e3-dc8c5bcf639f", type: "tokens-output", backgroundColor: "bgMagenta"},
+            {id: "90aae111-3d3f-4bb0-8336-230f322cc2e8", type: "block-timer", backgroundColor: "bgYellow"},
+            {id: "d904cca6-ade8-41c1-a4f5-ddea30607a5e", type: "model", backgroundColor: "bgMagenta"}
+        ],
+        [
+            {id: "9bacbdb4-2e01-45de-a0c0-ee6ec30fa3c2", type: "tokens-total", backgroundColor: "bgGreen"},
+            {id: "a9eaae3f-7f91-459c-833a-fbc9f01a09ae", type: "git-worktree", backgroundColor: "bgBrightBlue"},
+            {id: "2ad12147-05fd-45fb-8336-53ba2e7df56c", type: "tokens-cached", backgroundColor: "bgBrightRed"},
+            {id: "a4fe7f75-2f6c-49c7-88f6-ac7381142c2c", type: "session-cost", backgroundColor: "bgBrightWhite"},
+            {id: "2cdff909-8297-44a1-83f9-ad4bf024391e", type: "version", backgroundColor: "bgRed"}
+        ]
+    ],
+    flexMode: "full-minus-40",
+    compactThreshold: 60,
+    colorLevel: 2,
+    inheritSeparatorColors: false,
+    globalBold: false,
+    powerline: {
+        enabled: true,
+        separators: [""],
+        separatorInvertBackground: [true],
+        startCaps: [""],
+        endCaps: [""],
+        autoAlign: false,
+        theme: "monokai"
+    },
+    defaultPadding: " "
+}')
+
+# Validate generated config
+if ! echo "${CONFIG_JSON}" | jq empty 2>/dev/null; then
+    echo "[ccstatusline] ERROR: Generated configuration is invalid JSON"
+    exit 1
+fi
+
+echo "[ccstatusline] Writing configuration..."
+
+CONFIG_DIR="${USER_HOME}/.config/ccstatusline"
+CONFIG_FILE="${CONFIG_DIR}/settings.json"
+
+# Create directory
+mkdir -p "${CONFIG_DIR}"
+
+# Write config using secure temp file
+TEMP_CONFIG=$(mktemp)
+chmod 644 "${TEMP_CONFIG}"
+echo "${CONFIG_JSON}" | jq . > "${TEMP_CONFIG}"
+
+# Move to final location
+mv "${TEMP_CONFIG}" "${CONFIG_FILE}"
+
+# Set ownership
+if ! chown "${USERNAME}:${USERNAME}" "${CONFIG_FILE}" 2>/dev/null; then
+    echo "[ccstatusline] WARNING: Could not set ownership on ${CONFIG_FILE}"
+    echo "  Fix: sudo chown ${USERNAME}:${USERNAME} ${CONFIG_FILE}"
+fi
+
+if ! chown "${USERNAME}:${USERNAME}" "${CONFIG_DIR}" 2>/dev/null; then
+    echo "[ccstatusline] WARNING: Could not set ownership on ${CONFIG_DIR}"
+fi
+
+echo "[ccstatusline] ✓ Configuration written to ${CONFIG_FILE}"
+
+# Create template directory and save config template
+echo "[ccstatusline] Creating configuration template..."
+mkdir -p /usr/local/share/ccstatusline
+TEMPLATE_FILE=/usr/local/share/ccstatusline/settings.template.json
+echo "${CONFIG_JSON}" | jq . > "${TEMPLATE_FILE}"
+chmod 644 "${TEMPLATE_FILE}"
+echo "[ccstatusline] ✓ Template saved to ${TEMPLATE_FILE}"
+
+# Create wrapper script to protect configuration
+echo "[ccstatusline] Creating wrapper script..."
+cat > /usr/local/bin/ccstatusline-wrapper <<'WRAPPER_EOF'
+#!/bin/bash
+# ccstatusline wrapper script
+# Ensures custom powerline configuration is valid before running ccstatusline
+
+set -euo pipefail
+
+CONFIG_FILE="$HOME/.config/ccstatusline/settings.json"
+TEMPLATE_FILE="/usr/local/share/ccstatusline/settings.template.json"
+
+# Ensure config directory exists
+mkdir -p "$HOME/.config/ccstatusline"
+
+# Function to check if config is valid
+is_config_valid() {
+    if [[ ! -f "$CONFIG_FILE" ]]; then
+        return 1
+    fi
+
+    # Check if powerline is enabled (key indicator of custom config)
+    if ! grep -q '"enabled"[[:space:]]*:[[:space:]]*true' "$CONFIG_FILE" 2>/dev/null; then
+        return 1
+    fi
+
+    # Check if ANSI colors are present (backgroundColor with bg prefix)
+    if ! grep -q 'bgRed\|bgMagenta\|bgGreen\|bgBrightBlue' "$CONFIG_FILE" 2>/dev/null; then
+        return 1
+    fi
+
+    # Validate JSON syntax
+    if ! jq empty "$CONFIG_FILE" 2>/dev/null; then
+        return 1
+    fi
+
+    return 0
+}
+
+# Restore config from template if missing or invalid
+if ! is_config_valid; then
+    if [[ -f "$TEMPLATE_FILE" ]]; then
+        cp "$TEMPLATE_FILE" "$CONFIG_FILE"
+        chmod 644 "$CONFIG_FILE"
+    else
+        echo "[ccstatusline-wrapper] ERROR: Template file not found at $TEMPLATE_FILE" >&2
+        exit 1
+    fi
+fi
+
+# Run ccstatusline with all passed arguments
+exec npx -y ccstatusline@latest "$@"
+WRAPPER_EOF
+
+chmod +x /usr/local/bin/ccstatusline-wrapper
+echo "[ccstatusline] ✓ Wrapper installed at /usr/local/bin/ccstatusline-wrapper"
+
+# Create post-start hook directory (standard pattern for DevContainer features)
+mkdir -p /usr/local/devcontainer-poststart.d
+
+# Create post-start hook script for Claude Code integration
+# Runs on EVERY container start to ensure statusLine is always configured
+# This handles cached images, config deletion, and corruption scenarios
+# Note: Uses prefix 40 to run before MCP servers (50-51) to ensure settings.json exists first
+cat > /usr/local/devcontainer-poststart.d/40-ccstatusline.sh <<'AUTOEOF'
+#!/bin/bash
+set -euo pipefail
+
+echo "[ccstatusline] Auto-configuring Claude Code integration..."
+
+# Validate prerequisites
+if ! command -v jq &>/dev/null; then
+    echo "[ccstatusline] ERROR: jq is not available"
+    echo "  Ensure common-utils feature is installed"
+    exit 1
+fi
+
+SETTINGS_FILE="${WORKSPACE_ROOT:-/workspaces}/.claude/settings.json"
+# Use SUDO_USER since _REMOTE_USER isn't set in post-start hooks
+USERNAME="${SUDO_USER:-vscode}"
+
+# Ensure directory exists
+mkdir -p "$(dirname "${SETTINGS_FILE}")"
+
+# Initialize settings.json if missing
+if [ ! -f "${SETTINGS_FILE}" ]; then
+    echo '{}' > "${SETTINGS_FILE}"
+fi
+
+# Add statusLine configuration (atomic) - use wrapper to protect config
+jq '.statusLine //= {}' "${SETTINGS_FILE}" | \
+jq '.statusLine = {
+    type: "command",
+    command: "/usr/local/bin/ccstatusline-wrapper"
+}' > "${SETTINGS_FILE}.tmp"
+
+# Atomic move (only if jq succeeded)
+if [ $? -eq 0 ]; then
+    mv "${SETTINGS_FILE}.tmp" "${SETTINGS_FILE}"
+    if ! chown "${USERNAME}:${USERNAME}" "${SETTINGS_FILE}" 2>/dev/null; then
+        echo "[ccstatusline] WARNING: Could not set ownership on ${SETTINGS_FILE}"
+    fi
+    echo "[ccstatusline] ✓ Configured in ${SETTINGS_FILE}"
+    echo "[ccstatusline] Verify: cat ${SETTINGS_FILE} | jq '.statusLine'"
+else
+    rm -f "${SETTINGS_FILE}.tmp"
+    echo "[ccstatusline] ERROR: Configuration failed"
+    exit 1
+fi
+AUTOEOF
+
+chmod +x /usr/local/devcontainer-poststart.d/40-ccstatusline.sh
+echo "[ccstatusline] ✓ Post-start hook created at /usr/local/devcontainer-poststart.d/40-ccstatusline.sh"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  ccstatusline Installation Complete"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Configuration:"
+echo "  • Config file: ${CONFIG_FILE}"
+echo "  • User: ${USERNAME}"
+echo "  • Theme: Powerline (3 lines, 13 widgets, ANSI colors)"
+echo "  • Protected by: /usr/local/bin/ccstatusline-wrapper"
+echo ""
+echo "Display:"
+echo "  Line 1: Context | Git Branch | Tokens In | Clock | Output Style"
+echo "  Line 2: Context % | Git Changes | Tokens Out | Block Timer | Model"
+echo "  Line 3: Tokens Total | Git Worktree | Cached | Cost | Version"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Next Steps"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "1. Configuration will be applied automatically on container creation"
+echo ""
+echo "2. Test manually:"
+echo "   echo '{\"model\":{\"display_name\":\"Test\"}}' | npx -y ccstatusline@latest"
+echo ""
+echo "3. View configuration:"
+echo "   cat ${CONFIG_FILE} | jq ."
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"