codeforge-dev 1.12.0 → 1.14.1

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

@@ -66,105 +66,16 @@ 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)
-# 6-line layout with session resume command and ccburn burn rate tracking
-CONFIG_JSON=$(jq -n '{
-    version: 3,
-    lines: [
-        [
-            {id: "1", type: "context-length", color: "cyan"},
-            {id: "db519d5a-80a7-4b44-8a9c-2c7d8c0a7176", type: "context-percentage-usable", backgroundColor: "bgRed"},
-            {id: "d904cca6-ade8-41c1-a4f5-ddea30607a5e", type: "model", backgroundColor: "bgMagenta"}
-        ],
-        [
-            {id: "5", type: "tokens-input", color: "magenta"},
-            {id: "ac094d46-3673-4d41-84e3-dc8c5bcf639f", type: "tokens-output", backgroundColor: "bgMagenta"},
-            {id: "2ad12147-05fd-45fb-8336-53ba2e7df56c", type: "tokens-cached", backgroundColor: "bgBrightRed"}
-        ],
-        [
-            {id: "3", type: "git-branch", color: "brightBlack"},
-            {id: "a529e50e-b9f3-4150-a812-937ab81545e8", type: "git-changes", backgroundColor: "bgBrightBlue"},
-            {id: "a9eaae3f-7f91-459c-833a-fbc9f01a09ae", type: "git-worktree", backgroundColor: "bgBrightBlue"}
-        ],
-        [
-            {id: "7", type: "session-clock", color: "yellow"},
-            {id: "a4fe7f75-2f6c-49c7-88f6-ac7381142c2c", type: "session-cost", backgroundColor: "bgBrightWhite"},
-            {id: "90aae111-3d3f-4bb0-8336-230f322cc2e8", type: "block-timer", backgroundColor: "bgYellow"}
-        ],
-        [
-            {id: "9bacbdb4-2e01-45de-a0c0-ee6ec30fa3c2", type: "tokens-total", backgroundColor: "bgGreen"},
-            {id: "2cdff909-8297-44a1-83f9-ad4bf024391e", type: "version", backgroundColor: "bgRed"}
-        ],
-        [
-            {id: "cc-resume-session", type: "custom-command", commandPath: "/usr/local/bin/ccstatusline-session-resume", timeout: 500, preserveColors: false, maxWidth: 50, color: "cyan", backgroundColor: "bgBrightBlack"}
-        ],
-        [
-            {id: "cc-cwd", type: "custom-command", commandPath: "/usr/local/bin/ccstatusline-cwd", timeout: 500, preserveColors: false, maxWidth: 40, color: "brightWhite", backgroundColor: "bgBrightBlack"}
-        ],
-        [
-            {id: "ccburn-compact", type: "custom-command", commandPath: "/usr/local/bin/ccburn-statusline", timeout: 8000, preserveColors: true, maxWidth: 80, color: "green", backgroundColor: "bgBlack"}
-        ]
-    ],
-    flexMode: "full-minus-40",
-    compactThreshold: 60,
-    colorLevel: 2,
-    inheritSeparatorColors: false,
-    globalBold: false,
-    powerline: {
-        enabled: true,
-        separators: ["\ue0b0"],
-        separatorInvertBackground: [false],
-        startCaps: ["\ue0b6"],
-        endCaps: ["\ue0b4"],
-        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..."
+# Widget config is managed by file-manifest.json (deployed by setup-config.sh)
+# Source: .devcontainer/config/defaults/ccstatusline-settings.json
+# Deployed to: ~/.config/ccstatusline/settings.json (if-changed)
+# Template:    /usr/local/share/ccstatusline/settings.template.json (always)
+echo "[ccstatusline] Widget config managed by file-manifest.json"
+
+# Create directories so wrapper doesn't fail before first post-start
+mkdir -p "${USER_HOME}/.config/ccstatusline"
 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}"
+chown "${USERNAME}:${USERNAME}" "${USER_HOME}/.config/ccstatusline" 2>/dev/null || true
 
 # Create session resume helper script for custom-command widget
 # Reads Claude Code JSON from stdin, outputs the session ID
@@ -321,31 +232,22 @@ echo "  ccstatusline Installation Complete"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo ""
 echo "Configuration:"
-echo "  • Config file: ${CONFIG_FILE}"
+echo "  • Source: .devcontainer/config/defaults/ccstatusline-settings.json"
+echo "  • Deployed to: ~/.config/ccstatusline/settings.json (by file-manifest)"
+echo "  • Template: /usr/local/share/ccstatusline/settings.template.json"
 echo "  • User: ${USERNAME}"
-echo "  • Theme: Powerline (8 lines, 17 widgets, ANSI colors)"
 echo "  • Protected by: /usr/local/bin/ccstatusline-wrapper"
 echo ""
-echo "Display:"
-echo "  Line 1: Context Length | Context % | Model"
-echo "  Line 2: Tokens In | Tokens Out | Tokens Cached"
-echo "  Line 3: Git Branch | Git Changes | Git Worktree"
-echo "  Line 4: Session Clock | Session Cost | Block Timer"
-echo "  Line 5: Tokens Total | Version"
-echo "  Line 6: Session ID"
-echo "  Line 7: Working Directory"
-echo "  Line 8: Burn Rate (ccburn compact)"
-echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "  Next Steps"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo ""
-echo "1. Configuration will be applied automatically on container creation"
+echo "1. Widget config is deployed automatically on container start"
 echo ""
-echo "2. Test manually:"
-echo "   echo '{\"model\":{\"display_name\":\"Test\"}}' | npx -y ccstatusline@latest"
+echo "2. To customize: edit .devcontainer/config/defaults/ccstatusline-settings.json"
+echo "   Changes deploy on next container start (if-changed)"
 echo ""
-echo "3. View configuration:"
-echo "   cat ${CONFIG_FILE} | jq ."
+echo "3. Test manually:"
+echo "   echo '{\"model\":{\"display_name\":\"Test\"}}' | npx -y ccstatusline@latest"
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

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

@@ -3,7 +3,6 @@
   "version": "1.0.0",
   "name": "ccusage - Claude Code Usage Analyzer",
   "description": "Installs ccusage CLI tool for analyzing Claude Code token usage",
-  "maintainer": "AnExiledDev",
   "documentationURL": "https://github.com/ryoppippi/ccusage",
   "options": {
     "version": {

package/.devcontainer/features/chromaterm/README.md

@@ -0,0 +1,42 @@
+# chromaterm
+
+Terminal output colorizer using regex-based YAML rules.
+
+## What It Does
+
+Installs [ChromaTerm2](https://github.com/rgcr/ChromaTerm2) via `uv tool`. ChromaTerm2 applies regex-based color highlighting to terminal output using configurable YAML rules.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `version` | `latest` | ChromaTerm2 version to install. Set `"none"` to skip. |
+| `username` | `automatic` | Container user to install for |
+
+## Usage
+
+```bash
+# Pipe any command through ct for colorized output
+some-command | ct
+
+# Use with a custom config
+ct --config ~/.chromaterm.yml
+```
+
+## Configuration
+
+Create a `~/.chromaterm.yml` file with regex rules:
+
+```yaml
+rules:
+  - regex: "ERROR|FATAL"
+    color: red bold
+  - regex: "WARNING|WARN"
+    color: yellow
+  - regex: "INFO"
+    color: green
+```
+
+## Prerequisites
+
+Requires `uv` (pre-installed in CodeForge container).

package/.devcontainer/features/chromaterm/chromaterm.yml

@@ -0,0 +1,35 @@
+# ChromaTerm rules — additive to built-in defaults
+# Customize to taste — this file won't be overwritten on rebuild.
+#
+# Built-in defaults already cover: errors, warnings, success, URLs,
+# IPv4/IPv6, MAC addresses, dates, times, sizes, numbers.
+# See: https://github.com/rgcr/ChromaTerm2
+#
+# These rules add patterns the defaults don't handle.
+# Colors: f#HEX (foreground), b#HEX (background), bold, italic, underline
+
+palette:
+  file_purple: '#bd93f9'
+  line_gray: '#6272a4'
+  info_blue: '#8be9fd'
+  hash_yellow: '#f1fa8c'
+
+rules:
+  # File paths with optional line numbers (e.g., src/main.py:42)
+  # Covers common extensions for languages used in development
+  - description: File paths with line numbers
+    regex: '(?<=[\s(]|^)([a-zA-Z0-9_./-]+\.(py|ts|tsx|js|jsx|md|json|yml|yaml|toml|sh|rs|go|sql|css|html|svelte))(:(\d+))?'
+    color:
+      1: f.file_purple underline
+      4: f.line_gray
+    exclusive: true
+
+  # Info/debug markers (not covered by defaults)
+  - description: Info and debug markers
+    regex: '\b(INFO|DEBUG|HINT|NOTE|TRACE|VERBOSE)\b'
+    color: f.info_blue
+
+  # Git short commit hashes (7-12 hex chars)
+  - description: Git commit hashes
+    regex: '(?<=commit |merge |pick |revert |fixup )[0-9a-f]{7,40}'
+    color: f.hash_yellow

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

@@ -0,0 +1,22 @@
+{
+  "id": "chromaterm",
+  "version": "1.0.0",
+  "name": "ChromaTerm - Terminal Output Colorizer",
+  "description": "Installs ChromaTerm2 for regex-based CLI output colorization via YAML rules",
+  "documentationURL": "https://github.com/rgcr/ChromaTerm2",
+  "options": {
+    "version": {
+      "type": "string",
+      "description": "ChromaTerm2 version to install (e.g., 'latest', '2.1.0', 'none' to skip)",
+      "default": "latest"
+    },
+    "username": {
+      "type": "string",
+      "description": "Container user to install for",
+      "default": "automatic"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers-extra/features/uv"
+  ]
+}

package/.devcontainer/features/chromaterm/install.sh

@@ -0,0 +1,113 @@
+#!/bin/bash
+set -euo pipefail
+
+# ==============================
+# ChromaTerm DevContainer Feature
+# Installs ChromaTerm2 via uv tool
+# ==============================
+
+CT_VERSION="${VERSION:-latest}"
+USERNAME="${USERNAME:-automatic}"
+
+# Skip installation if version is "none"
+if [ "${CT_VERSION}" = "none" ]; then
+    echo "[chromaterm] Skipping installation (version=none)"
+    exit 0
+fi
+
+echo "[chromaterm] Starting ChromaTerm2 installation..."
+
+# ---------- USER ----------
+if [[ "${USERNAME}" == "auto" || "${USERNAME}" == "automatic" ]]; then
+    USERNAME=""
+    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 "[chromaterm] Target user: ${USERNAME}"
+echo "[chromaterm] Version: ${CT_VERSION}"
+
+fail() {
+    echo "[chromaterm] ERROR: $1" >&2
+    exit 1
+}
+
+run_as_user() {
+    sudo -u "${USERNAME}" env \
+        HOME="${USER_HOME}" \
+        "$@"
+}
+
+# ---------- UV DISCOVERY ----------
+find_uv() {
+    command -v uv 2>/dev/null && return 0
+    for p in /usr/local/bin/uv /usr/bin/uv /opt/uv/bin/uv; do
+        [[ -x "$p" ]] && echo "$p" && return 0
+    done
+    find /usr /opt -maxdepth 4 -type f -name uv -executable 2>/dev/null | head -n 1
+}
+
+# ---------- INSTALL ----------
+UV_BIN="$(find_uv || true)"
+[[ -n "${UV_BIN}" ]] || fail "uv is not installed (devcontainer uv feature missing or broken)"
+
+echo "[chromaterm] Using uv at: ${UV_BIN}"
+
+if [[ "${CT_VERSION}" == "latest" ]]; then
+    run_as_user "${UV_BIN}" tool install chromaterm2
+else
+    run_as_user "${UV_BIN}" tool install "chromaterm2==${CT_VERSION}"
+fi
+
+# ---------- DEPLOY DEFAULT CONFIG ----------
+CT_CONFIG="${USER_HOME}/.chromaterm.yml"
+FEATURE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+if [ ! -f "${CT_CONFIG}" ]; then
+    if [ -f "${FEATURE_DIR}/chromaterm.yml" ]; then
+        cp "${FEATURE_DIR}/chromaterm.yml" "${CT_CONFIG}"
+        chown "${USERNAME}:${USERNAME}" "${CT_CONFIG}" 2>/dev/null || true
+        echo "[chromaterm] Deployed default config to ${CT_CONFIG}"
+    fi
+else
+    echo "[chromaterm] Config already exists at ${CT_CONFIG} — not overwriting"
+fi
+
+# ---------- VERIFY ----------
+BIN_DIR="${USER_HOME}/.local/bin"
+
+if [ -x "${BIN_DIR}/ct" ]; then
+    INSTALLED_VERSION="$("${BIN_DIR}/ct" --version 2>/dev/null || echo "unknown")"
+    echo "[chromaterm] ✓ ChromaTerm2 installed (${INSTALLED_VERSION})"
+else
+    echo "[chromaterm] ERROR: ct not found in ${BIN_DIR}" >&2
+    ls -la "${BIN_DIR}" 2>/dev/null || true
+    exit 1
+fi
+
+# ---------- SUMMARY ----------
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  ChromaTerm2 Installation Complete"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Configuration:"
+echo "  • User: ${USERNAME}"
+echo "  • Version: ${CT_VERSION}"
+echo "  • Config: ${CT_CONFIG}"
+echo ""
+echo "Usage:"
+echo "  ct <command>              # Wrap any command with colorization"
+echo "  echo 'ERROR test' | ct   # Pipe output through ChromaTerm"
+echo "  cc / claude               # Auto-wrapped when ct is installed"
+echo ""
+echo "Edit ~/.chromaterm.yml to customize highlighting rules."
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/.devcontainer/features/claude-monitor/devcontainer-feature.json

@@ -3,7 +3,6 @@
   "version": "1.0.0",
   "name": "Claude Monitor - Real-time Usage Tracker",
   "description": "Installs claude-monitor for real-time Claude Code token usage monitoring with ML-based predictions",
-  "maintainer": "AnExiledDev",
   "documentationURL": "https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor",
   "options": {
     "version": {

package/.devcontainer/features/claude-session-dashboard/README.md

@@ -0,0 +1,40 @@
+# Claude Session Dashboard (devcontainer feature)
+
+Installs [claude-session-dashboard](https://github.com/dlupiak/claude-session-dashboard) — a local analytics dashboard for Claude Code sessions.
+
+## What it provides
+
+- `claude-dashboard` command to launch the web UI
+- Session browsing with full-text search and filtering
+- Token usage breakdown, cost estimates, and activity heatmaps
+- Tool call timeline visualization
+- Per-project aggregated analytics
+- Settings persisted across container rebuilds via symlink to `/workspaces/.claude-dashboard/`
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `version` | `latest` | npm package version (`latest`, `1.0.0`, or `none` to skip) |
+| `port` | `7847` | Default port for the dashboard server |
+| `shells` | `both` | Shell configs to add alias to (`bash`, `zsh`, `both`) |
+| `username` | `automatic` | Container user to install for |
+
+## Usage
+
+```bash
+# Start the dashboard (default port 7847)
+claude-dashboard
+
+# Start on a custom port
+claude-dashboard -p 8080
+
+# Show help
+claude-dashboard --help
+```
+
+The dashboard reads session data from `~/.claude/projects/` (symlinked to `/workspaces/.claude/projects/` in this devcontainer).
+
+## How persistence works
+
+Dashboard settings and cache are stored at `~/.claude-dashboard/`. Since the home directory is ephemeral in devcontainers, a poststart hook symlinks `~/.claude-dashboard` → `/workspaces/.claude-dashboard/`, which is bind-mounted and survives rebuilds.

package/.devcontainer/features/claude-session-dashboard/devcontainer-feature.json

@@ -0,0 +1,34 @@
+{
+  "id": "claude-session-dashboard",
+  "version": "1.0.0",
+  "name": "Claude Session Dashboard",
+  "description": "Local analytics dashboard for Claude Code sessions (token usage, tool calls, cost estimates)",
+  "documentationURL": "https://github.com/dlupiak/claude-session-dashboard",
+  "options": {
+    "version": {
+      "type": "string",
+      "description": "Dashboard version (e.g., 'latest', '1.0.0', 'none' to skip)",
+      "default": "latest"
+    },
+    "port": {
+      "type": "string",
+      "description": "Default port for the dashboard server",
+      "default": "7847"
+    },
+    "shells": {
+      "type": "string",
+      "description": "Which shells to configure aliases in (bash, zsh, or both)",
+      "default": "both",
+      "enum": ["bash", "zsh", "both"],
+      "proposals": ["bash", "zsh", "both"]
+    },
+    "username": {
+      "type": "string",
+      "description": "Container user to install for",
+      "default": "automatic"
+    }
+  },
+  "installsAfter": [
+    "ghcr.io/devcontainers/features/node:1"
+  ]
+}

package/.devcontainer/features/claude-session-dashboard/install.sh

@@ -0,0 +1,172 @@
+#!/bin/bash
+set -euo pipefail
+
+# ==============================
+# Claude Session Dashboard
+# DevContainer Feature Installer
+# ==============================
+
+# === IMPORT OPTIONS ===
+DASHBOARD_VERSION="${VERSION:-latest}"
+PORT="${PORT:-7847}"
+SHELLS="${SHELLS:-both}"
+USERNAME="${USERNAME:-automatic}"
+
+# === SKIP IF DISABLED ===
+if [ "${DASHBOARD_VERSION}" = "none" ]; then
+    echo "[claude-session-dashboard] Skipping installation (version=none)"
+    exit 0
+fi
+
+echo "[claude-session-dashboard] Starting installation..."
+
+# === SOURCE NVM ===
+if [ -f /usr/local/share/nvm/nvm.sh ]; then
+    source /usr/local/share/nvm/nvm.sh
+fi
+
+# === VALIDATE DEPENDENCIES ===
+if ! command -v npm &>/dev/null; then
+    echo "[claude-session-dashboard] ERROR: npm is not available"
+    echo "  Ensure the node feature is installed first"
+    exit 1
+fi
+
+NODE_MAJOR="$(node --version 2>/dev/null | sed 's/v\([0-9]*\).*/\1/' || echo 0)"
+if [ "${NODE_MAJOR}" -lt 18 ]; then
+    echo "[claude-session-dashboard] ERROR: Node.js >= 18 required (found v${NODE_MAJOR})"
+    exit 1
+fi
+
+# === VALIDATE INPUT ===
+if [[ ! "${SHELLS}" =~ ^(bash|zsh|both)$ ]]; then
+    echo "[claude-session-dashboard] ERROR: shells must be 'bash', 'zsh', or 'both'"
+    exit 1
+fi
+
+if [[ ! "${DASHBOARD_VERSION}" =~ ^[a-zA-Z0-9._-]+$ ]]; then
+    echo "[claude-session-dashboard] ERROR: version contains invalid characters"
+    exit 1
+fi
+
+# === DETECT 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
+
+USER_HOME=$(eval echo "~${USERNAME}")
+if [ ! -d "${USER_HOME}" ]; then
+    echo "[claude-session-dashboard] ERROR: Home directory not found for user ${USERNAME}"
+    exit 1
+fi
+
+echo "[claude-session-dashboard] Installing for user: ${USERNAME}"
+
+# === INSTALL VIA NPM ===
+echo "[claude-session-dashboard] Installing claude-session-dashboard@${DASHBOARD_VERSION} globally..."
+npm install -g "claude-session-dashboard@${DASHBOARD_VERSION}"
+
+# === PERSISTENCE SYMLINK (POSTSTART HOOK) ===
+# Settings/cache live at ~/.claude-dashboard, which is ephemeral (/home/vscode).
+# Create a poststart hook to symlink it to /workspaces/.claude-dashboard for persistence.
+POSTSTART_DIR="/usr/local/devcontainer-poststart.d"
+HOOK_SCRIPT="${POSTSTART_DIR}/claude-dashboard-symlink.sh"
+
+mkdir -p "${POSTSTART_DIR}"
+cat > "${HOOK_SCRIPT}" << 'HOOKEOF'
+#!/bin/bash
+# Symlink ~/.claude-dashboard → /workspaces/.claude-dashboard for persistence
+DASHBOARD_DATA="/workspaces/.claude-dashboard"
+USER_HOME="${HOME:-/home/vscode}"
+LINK_PATH="${USER_HOME}/.claude-dashboard"
+
+mkdir -p "${DASHBOARD_DATA}"
+
+# Already correct symlink — nothing to do
+if [ -L "${LINK_PATH}" ]; then
+    CURRENT_TARGET="$(readlink "${LINK_PATH}")"
+    if [ "${CURRENT_TARGET}" = "${DASHBOARD_DATA}" ]; then
+        exit 0
+    fi
+    rm "${LINK_PATH}"
+fi
+
+# Real directory exists — merge contents, then replace with symlink
+if [ -d "${LINK_PATH}" ]; then
+    cp -rn "${LINK_PATH}/." "${DASHBOARD_DATA}/" 2>/dev/null || true
+    rm -rf "${LINK_PATH}"
+fi
+
+ln -s "${DASHBOARD_DATA}" "${LINK_PATH}"
+HOOKEOF
+chmod +x "${HOOK_SCRIPT}"
+echo "[claude-session-dashboard] Created poststart hook for settings persistence"
+
+# === SHELL ALIASES ===
+ALIAS_CMD="alias claude-dashboard=\"claude-dashboard --host 0.0.0.0 --port ${PORT}\""
+
+configure_shell() {
+    local shell_rc="$1"
+    local shell_name="$2"
+
+    if [ ! -f "${shell_rc}" ]; then
+        echo "[claude-session-dashboard] Creating ${shell_name} config: ${shell_rc}"
+        sudo -u "${USERNAME}" touch "${shell_rc}"
+    fi
+
+    if grep -q "alias claude-dashboard=" "${shell_rc}"; then
+        echo "[claude-session-dashboard] ${shell_name} alias already configured. Skipping..."
+    else
+        echo "[claude-session-dashboard] Adding alias to ${shell_name}"
+        echo "${ALIAS_CMD}" >> "${shell_rc}"
+        chown "${USERNAME}:${USERNAME}" "${shell_rc}" 2>/dev/null || true
+    fi
+}
+
+if [ "${SHELLS}" = "bash" ] || [ "${SHELLS}" = "both" ]; then
+    configure_shell "${USER_HOME}/.bashrc" "bash"
+fi
+
+if [ "${SHELLS}" = "zsh" ] || [ "${SHELLS}" = "both" ]; then
+    configure_shell "${USER_HOME}/.zshrc" "zsh"
+fi
+
+# === VERIFICATION ===
+echo "[claude-session-dashboard] Verifying installation..."
+if command -v claude-dashboard &>/dev/null; then
+    INSTALLED_VERSION="$(claude-dashboard --version 2>/dev/null || echo "unknown")"
+    echo "[claude-session-dashboard] ✓ claude-dashboard installed (${INSTALLED_VERSION})"
+else
+    echo "[claude-session-dashboard] WARNING: claude-dashboard not found in PATH"
+    echo "  The global npm install may need PATH adjustment"
+    echo "  Try: npx claude-session-dashboard --version"
+fi
+
+# === SUMMARY ===
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  Claude Session Dashboard Installation Complete"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Configuration:"
+echo "  • User: ${USERNAME}"
+echo "  • Version: ${DASHBOARD_VERSION}"
+echo "  • Default port: ${PORT}"
+echo "  • Shells: ${SHELLS}"
+echo "  • Settings persist to: /workspaces/.claude-dashboard/"
+echo ""
+echo "Usage:"
+echo "  claude-dashboard           # Start on port ${PORT}"
+echo "  claude-dashboard -p 8080   # Start on custom port"
+echo "  claude-dashboard --help    # Full options"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/.devcontainer/features/kitty-terminfo/README.md

@@ -0,0 +1,32 @@
+# kitty-terminfo
+
+Installs xterm-kitty terminfo so Kitty terminal users get full color and capability support.
+
+## What It Does
+
+Downloads and compiles the official kitty terminfo entry from the [Kitty terminal repository](https://github.com/kovidgoyal/kitty). This ensures Kitty terminal users connecting to the container get proper color rendering, cursor shapes, and terminal capabilities.
+
+## Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `version` | `latest` | Set `"none"` to skip installation. |
+
+## Usage
+
+No configuration needed. Once installed, containers automatically recognize `TERM=xterm-kitty` and provide full capability support.
+
+```bash
+# Verify installation
+infocmp xterm-kitty
+
+# Check color support
+tput colors  # should return 256
+```
+
+## How It Works
+
+1. Checks if `xterm-kitty` terminfo is already present (skips if so)
+2. Installs `ncurses-bin` if `tic` compiler is not available
+3. Downloads the official kitty terminfo from GitHub
+4. Compiles and installs to `/usr/share/terminfo`