codeforge-dev 1.5.8 → 1.8.0

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/README.md

@@ -0,0 +1,60 @@
+# ccburn - Visual Token Burn Rate Tracker
+
+Real-time burn-up charts and pace tracking for Claude Code usage limits.
+
+## Quick Start
+
+```bash
+# Full TUI dashboard (auto-detects active limit)
+ccburn
+
+# 5-hour rolling session limit
+ccburn session
+
+# 7-day weekly limit
+ccburn weekly
+
+# Single-line output for status bars
+ccburn --compact --once
+
+# JSON output for scripting
+ccburn --json --once
+```
+
+## Features
+
+- **Burn-up charts** — Live-updating terminal graphics showing usage over time
+- **Pace indicators** — 🧊 Cool (behind pace) | 🔥 On pace | 🚨 Too hot (ahead)
+- **Burn rate** — %/hour via linear regression, with trend classification
+- **Predictions** — Time-to-100% estimates and projection lines
+- **Multiple limits** — Session (5h), Weekly (7d), Weekly Sonnet, Monthly
+- **SQLite history** — 7-day retention at `~/.ccburn/history.db`
+- **Compact mode** — Single-line output for embedding in statuslines
+
+## Display Modes
+
+| Mode | Flag | Description |
+|------|------|-------------|
+| Full TUI | (default) | Interactive dashboard with charts and gauges |
+| Compact | `--compact` | Single line: `Session: 🧊 45% (2h14m) \| Weekly: 🔥 12%` |
+| JSON | `--json` | Structured output with all metrics |
+| Once | `--once` | Single snapshot, no live updates |
+
+## Statusline Integration
+
+This feature installs a wrapper at `/usr/local/bin/ccburn-statusline` for use with
+ccstatusline's `custom-command` widget. The wrapper handles:
+
+- Missing OAuth credentials (shows "awaiting auth")
+- First-run npx caching (shows "unavailable" if download fails)
+- API errors (graceful fallback messages)
+
+## Requirements
+
+- Node.js (via devcontainer node feature)
+- Claude Code OAuth credentials at `~/.claude/.credentials.json`
+
+## Documentation
+
+- [GitHub Repository](https://github.com/JuanjoFuchs/ccburn)
+- [ccburn Specification](https://github.com/JuanjoFuchs/ccburn/blob/main/docs/ccburn-spec.md)

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

@@ -0,0 +1,38 @@
+{
+  "id": "ccburn",
+  "version": "1.0.0",
+  "name": "ccburn - Visual Token Burn Rate Tracker",
+  "description": "Installs ccburn CLI for real-time burn-up charts and pace tracking of Claude Code usage limits",
+  "maintainer": "AnExiledDev",
+  "documentationURL": "https://github.com/JuanjoFuchs/ccburn",
+  "options": {
+    "version": {
+      "type": "string",
+      "description": "ccburn version to use (e.g., 'latest', '0.4.2')",
+      "default": "latest"
+    },
+    "shells": {
+      "type": "string",
+      "description": "Which shells to configure (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/ccburn/install.sh

@@ -0,0 +1,180 @@
+#!/bin/bash
+set -euo pipefail
+
+# === SETUP ===
+cleanup() {
+    :
+}
+trap cleanup EXIT
+
+# === IMPORT OPTIONS ===
+# NOTE: DevContainer converts camelCase options to UPPERCASE without underscores
+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 ===
+if [ -f /usr/local/share/nvm/nvm.sh ]; then
+    source /usr/local/share/nvm/nvm.sh
+fi
+
+# === VALIDATE DEPENDENCIES ===
+if ! command -v npx &>/dev/null; then
+    echo "[ccburn] ERROR: npx is not available"
+    echo "  Ensure node feature is installed first"
+    echo "  NVM path: /usr/local/share/nvm/nvm.sh"
+    exit 1
+fi
+
+# === VALIDATE INPUT ===
+if [[ ! "${SHELLS}" =~ ^(bash|zsh|both)$ ]]; then
+    echo "[ccburn] ERROR: shells must be 'bash', 'zsh', or 'both'"
+    echo "  Provided: ${SHELLS}"
+    exit 1
+fi
+
+if [[ ! "${CCBURN_VERSION}" =~ ^[a-zA-Z0-9.-]+$ ]]; then
+    echo "[ccburn] ERROR: version contains invalid characters"
+    echo "  Provided: ${CCBURN_VERSION}"
+    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
+
+echo "[ccburn] Installing for user: ${USERNAME}"
+
+# === GET USER HOME ===
+USER_HOME=$(eval echo "~${USERNAME}")
+if [ ! -d "${USER_HOME}" ]; then
+    echo "[ccburn] ERROR: Home directory not found for user ${USERNAME}"
+    exit 1
+fi
+
+# === INSTALL (CREATE ALIASES) ===
+ALIAS_CMD="alias ccburn=\"npx -y ccburn@${CCBURN_VERSION}\""
+
+configure_shell() {
+    local shell_rc="$1"
+    local shell_name="$2"
+
+    if [ ! -f "${shell_rc}" ]; then
+        echo "[ccburn] Creating ${shell_name} config file: ${shell_rc}"
+        sudo -u "${USERNAME}" touch "${shell_rc}"
+    fi
+
+    if grep -q "alias ccburn=" "${shell_rc}"; then
+        echo "[ccburn] ${shell_name} alias already configured. Skipping..."
+    else
+        echo "[ccburn] Adding ccburn alias to ${shell_name}"
+        echo "${ALIAS_CMD}" >> "${shell_rc}"
+        if ! chown "${USERNAME}:${USERNAME}" "${shell_rc}" 2>/dev/null; then
+            echo "[ccburn] WARNING: Could not set ownership on ${shell_rc}"
+            echo "  Fix: sudo chown ${USERNAME}:${USERNAME} ${shell_rc}"
+        fi
+    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
+
+# === INSTALL STATUSLINE WRAPPER ===
+# Creates a wrapper script for embedding ccburn compact output in ccstatusline
+# Handles missing credentials, npx availability, and first-run caching gracefully
+echo "[ccburn] Creating statusline wrapper script..."
+
+cat > /usr/local/bin/ccburn-statusline <<'WRAPPER_EOF'
+#!/bin/bash
+# ccburn-statusline: Compact output wrapper for ccstatusline custom-command widget
+# Handles missing credentials, first-run npx cache, and errors gracefully
+# Always outputs something useful — never errors in the statusline
+
+# Source NVM if available (npx may not be on PATH without it)
+if [ -f /usr/local/share/nvm/nvm.sh ]; then
+    source /usr/local/share/nvm/nvm.sh 2>/dev/null
+fi
+
+if ! command -v npx &>/dev/null; then
+    echo "ccburn: npx unavailable"
+    exit 0
+fi
+
+# Check if credentials exist (ccburn needs OAuth token)
+CRED_FILE="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/.credentials.json"
+if [ ! -f "$CRED_FILE" ]; then
+    echo "ccburn: awaiting auth"
+    exit 0
+fi
+
+# Run ccburn compact (suppress stderr, capture output)
+OUTPUT=$(npx -y ccburn --compact --once 2>/dev/null)
+if [ $? -eq 0 ] && [ -n "$OUTPUT" ]; then
+    echo "$OUTPUT"
+else
+    echo "ccburn: unavailable"
+fi
+WRAPPER_EOF
+
+chmod +x /usr/local/bin/ccburn-statusline
+echo "[ccburn] ✓ Statusline wrapper installed at /usr/local/bin/ccburn-statusline"
+
+# === VERIFICATION ===
+echo "[ccburn] Verifying npx can access ccburn..."
+if sudo -u "${USERNAME}" bash -c "npx -y ccburn@${CCBURN_VERSION} --version" &>/dev/null; then
+    echo "[ccburn] ✓ ccburn is accessible"
+else
+    echo "[ccburn] WARNING: Could not verify ccburn installation"
+    echo "  This may be due to network connectivity"
+    echo "  The alias will still work once ccburn is available"
+fi
+
+# === SUMMARY ===
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  ccburn Installation Complete"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Configuration:"
+echo "  • User: ${USERNAME}"
+echo "  • Version: ${CCBURN_VERSION}"
+echo "  • Shells: ${SHELLS}"
+echo ""
+echo "Usage:"
+echo "  ccburn                # Full TUI dashboard (auto-detect limit)"
+echo "  ccburn session        # 5-hour rolling session limit"
+echo "  ccburn weekly         # 7-day limit (all models)"
+echo "  ccburn weekly-sonnet  # 7-day Sonnet-only limit"
+echo "  ccburn --compact      # Single-line for status bars"
+echo "  ccburn --json         # JSON output for scripting"
+echo "  ccburn --help         # Full options"
+echo ""
+echo "Statusline Integration:"
+echo "  • Wrapper: /usr/local/bin/ccburn-statusline"
+echo "  • Used by ccstatusline custom-command widget"
+echo "  • Shows: Session 🧊/🔥/🚨 % | Weekly % | Sonnet %"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

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

@@ -24,26 +24,22 @@ A DevContainer Feature that installs and configures [ccstatusline](https://githu
 
 ## Display Format
 
-### Line 1: Core Metrics
-```
-Model: Opus 4.1 ▶ Ctx: 58.5k ▶ main ▶ (+19, -2) ▶ v1.0.86
-```
+### 6-Line Powerline Layout
 
-- **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
+Line 1: Context Length ▶ Context % ▶ Model
+Line 2: Tokens In ▶ Tokens Out ▶ Tokens Cached
+Line 3: Git Branch ▶ Git Changes ▶ Git Worktree
+Line 4: Session Clock ▶ Session Cost ▶ Block Timer
+Line 5: Tokens Total ▶ Version ▶ cc --resume {sessionId}
+Line 6: Session: 🧊 45% (2h14m) | Weekly: 🔥 12% | Sonnet: 🧊 3%
 ```
 
-- **Working Directory** (gold bg, black text): Current directory path
-- **Session Cost** (gold bg, black text, bold): Total session cost in USD
+- **Lines 1-4**: Core session metrics, token tracking, git status, and cost
+- **Line 5**: Totals + copyable session resume command for `cc --resume`
+- **Line 6**: Live burn rate from [ccburn](https://github.com/JuanjoFuchs/ccburn) with pace indicators
 
-All widgets connected with powerline arrows for a seamless, professional appearance.
+All widgets connected with powerline arrows (monokai theme).
 
 ## What This Feature Installs
 
@@ -74,10 +70,11 @@ 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
+- ✅ **Powerline Mode**: Seamless arrow separators between widgets (monokai theme)
+- ✅ **6-Line Layout**: 16 widgets covering context, tokens, git, cost, session ID, and burn rate
+- ✅ **Session Resume**: Copyable `cc --resume {sessionId}` command via custom-command widget
+- ✅ **Burn Rate Tracking**: Live ccburn compact output showing pace indicators (🧊/🔥/🚨)
+- ✅ **ANSI Colors**: High-contrast colors optimized for dark terminals
 - ✅ **Automatic Integration**: Auto-configures `.claude/settings.json`
 - ✅ **Idempotent**: Safe to run multiple times
 - ✅ **Multi-user**: Automatically detects container user
@@ -151,7 +148,7 @@ Widgets are configured in the `lines` array:
 - `session-clock` - Session elapsed time
 - `session-cost` - Total session cost (USD)
 - `block-timer` - Block execution time
-- `output-style` - Current output style
+- `claude-session-id` - Session ID (raw or with label)
 
 **Context Tracking:**
 - `context-length` - Context window size
@@ -169,11 +166,15 @@ Widgets are configured in the `lines` array:
 - `git-changes` - Lines added/removed
 - `git-worktree` - Git worktree info
 
+**External Metrics (custom-command):**
+- `custom-command` → `/usr/local/bin/ccstatusline-session-resume` - Copyable resume command
+- `custom-command` → `/usr/local/bin/ccburn-statusline` - Burn rate with pace indicators
+
 **Other:**
 - `cwd` - Current working directory
 - `version` - Claude Code version
 - `custom-text` - Static text
-- `custom-command` - Command output
+- `custom-command` - Arbitrary command output (receives Claude Code JSON via stdin)
 
 ### Color Scheme
 

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

@@ -1,11 +1,16 @@
 {
   "id": "ccstatusline",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "name": "ccstatusline",
   "description": "Compact powerline status line for Claude Code with essential metrics",
   "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

@@ -3,14 +3,21 @@ set -euo pipefail
 
 # Cleanup on exit
 cleanup() {
-    rm -f /tmp/ccstatusline-*.json 2>/dev/null || true
+    rm -f "${TMPDIR:-/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
+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)
@@ -62,29 +69,39 @@ 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: "3", type: "git-branch", color: "brightBlack"},
+            {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: "7", type: "session-clock", color: "yellow"},
-            {id: "1eafc42e-f222-4090-a463-46de6ba81849", type: "output-style", backgroundColor: "bgBrightBlack"}
+            {id: "ac094d46-3673-4d41-84e3-dc8c5bcf639f", type: "tokens-output", backgroundColor: "bgMagenta"},
+            {id: "2ad12147-05fd-45fb-8336-53ba2e7df56c", type: "tokens-cached", backgroundColor: "bgBrightRed"}
         ],
         [
-            {id: "db519d5a-80a7-4b44-8a9c-2c7d8c0a7176", type: "context-percentage-usable", backgroundColor: "bgRed"},
+            {id: "3", type: "git-branch", color: "brightBlack"},
             {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: "a9eaae3f-7f91-459c-833a-fbc9f01a09ae", type: "git-worktree", backgroundColor: "bgBrightBlue"}
         ],
         [
-            {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: "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: "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",
@@ -95,7 +112,7 @@ CONFIG_JSON=$(jq -n '{
     powerline: {
         enabled: true,
         separators: ["\ue0b0"],
-        separatorInvertBackground: [true],
+        separatorInvertBackground: [false],
         startCaps: ["\ue0b6"],
         endCaps: ["\ue0b4"],
         autoAlign: false,
@@ -146,6 +163,24 @@ echo "${CONFIG_JSON}" | jq . > "${TEMPLATE_FILE}"
 chmod 644 "${TEMPLATE_FILE}"
 echo "[ccstatusline] ✓ Template saved to ${TEMPLATE_FILE}"
 
+# Create session resume helper script for custom-command widget
+# Reads Claude Code JSON from stdin, outputs the session ID
+echo "[ccstatusline] Creating session resume helper..."
+cat > /usr/local/bin/ccstatusline-session-resume <<'SESSION_EOF'
+#!/bin/bash
+# Reads Claude Code JSON from stdin, outputs just the session ID
+# Used by ccstatusline custom-command widget on line 6
+SESSION_ID=$(jq -r '.session_id // empty' 2>/dev/null)
+if [ -n "$SESSION_ID" ]; then
+    echo "$SESSION_ID"
+else
+    echo "..."
+fi
+SESSION_EOF
+
+chmod +x /usr/local/bin/ccstatusline-session-resume
+echo "[ccstatusline] ✓ Session resume helper installed at /usr/local/bin/ccstatusline-session-resume"
+
 # Create wrapper script to protect configuration
 echo "[ccstatusline] Creating wrapper script..."
 cat > /usr/local/bin/ccstatusline-wrapper <<'WRAPPER_EOF'
@@ -267,13 +302,17 @@ echo ""
 echo "Configuration:"
 echo "  • Config file: ${CONFIG_FILE}"
 echo "  • User: ${USERNAME}"
-echo "  • Theme: Powerline (3 lines, 13 widgets, ANSI colors)"
+echo "  • Theme: Powerline (7 lines, 16 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 "  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: Burn Rate (ccburn compact)"
 echo ""
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo "  Next Steps"

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"
+    }
+  }
+}