codeforge-dev 1.4.0

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 "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/.devcontainer/features/ccusage/README.md

@@ -0,0 +1,205 @@
+# ccusage - Claude Code Usage Analyzer
+
+A DevContainer feature that installs the ccusage CLI tool for analyzing Claude Code and Codex token usage from local JSONL files.
+
+## Overview
+
+ccusage tracks token usage and costs across daily, monthly, and session-based reports with live monitoring capabilities. This feature configures shell aliases for easy access to the tool via `npx`.
+
+## Installation
+
+Add this feature to your `.devcontainer/devcontainer.json`:
+
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {},
+    "./features/ccusage": {}
+  }
+}
+```
+
+### With Custom Options
+
+```json
+{
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {},
+    "./features/ccusage": {
+      "version": "latest",
+      "shells": "both",
+      "username": "automatic"
+    }
+  }
+}
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `version` | string | `latest` | ccusage version to use (e.g., 'latest', '1.0.0') |
+| `shells` | string | `both` | Which shells to configure: `bash`, `zsh`, or `both` |
+| `username` | string | `automatic` | Container user to install for (auto-detects vscode/node/codespace) |
+
+## Usage
+
+Once installed, use the `ccusage` command from any shell:
+
+### Daily Usage Report
+```bash
+ccusage --daily
+```
+Shows token usage and costs for today.
+
+### Monthly Report
+```bash
+ccusage --monthly
+```
+Displays monthly token consumption and costs.
+
+### Live Monitoring
+```bash
+ccusage --live
+```
+Real-time monitoring of your Claude Code usage.
+
+### JSON Output
+```bash
+ccusage --json
+```
+Output data in JSON format for scripting/integration.
+
+### Compact Display
+```bash
+ccusage --compact
+```
+Minimal output for quick checks.
+
+## Features
+
+- **Beautiful Tables**: Formatted output with clear cost breakdown
+- **Multiple Models**: Supports Claude Opus, Sonnet, and other models
+- **Timezone Support**: Customize timezone and locale settings
+- **Session Tracking**: View usage by individual sessions
+- **Cost Tracking**: Accurate pricing for different models
+
+## How It Works
+
+This feature creates a shell alias that points to `npx -y ccusage@<version>`, which automatically downloads and runs the latest version of ccusage without requiring a global installation.
+
+ccusage automatically reads from Claude Code's JSONL usage logs located in:
+- `~/.claude/` (default)
+- `$CLAUDE_CONFIG_DIR` (if customized)
+
+## Advanced Options
+
+For full list of ccusage command options:
+```bash
+ccusage --help
+```
+
+## Example Configurations
+
+### Install for Specific User (zsh only)
+```json
+{
+  "features": {
+    "./features/ccusage": {
+      "username": "vscode",
+      "shells": "zsh"
+    }
+  }
+}
+```
+
+### Pin to Specific Version
+```json
+{
+  "features": {
+    "./features/ccusage": {
+      "version": "1.0.0"
+    }
+  }
+}
+```
+
+### Bash Only Installation
+```json
+{
+  "features": {
+    "./features/ccusage": {
+      "shells": "bash"
+    }
+  }
+}
+```
+
+## Troubleshooting
+
+### Command Not Found
+
+If `ccusage` is not found after installation:
+
+1. **Reload your shell**:
+   ```bash
+   source ~/.bashrc  # for bash
+   source ~/.zshrc   # for zsh
+   ```
+
+2. **Check if alias is configured**:
+   ```bash
+   grep ccusage ~/.bashrc  # for bash
+   grep ccusage ~/.zshrc   # for zsh
+   ```
+
+3. **Verify npx is available**:
+   ```bash
+   npx --version
+   ```
+
+### Permission Errors
+
+If you see permission errors:
+```bash
+sudo chown -R $(whoami):$(whoami) ~/.bashrc
+sudo chown -R $(whoami):$(whoami) ~/.zshrc
+```
+
+### Network Issues
+
+If ccusage fails to download:
+- Check your internet connection
+- The tool will be cached after first successful download
+- Try running manually: `npx -y ccusage@latest --version`
+
+## Dependencies
+
+This feature requires:
+- **Node.js**: Install the `node` feature first
+- The feature automatically declares this dependency via `installsAfter`
+
+## Integration with Other Tools
+
+This tool complements:
+- **splitrail**: Real-time monitoring during active sessions
+- **ccstatusline**: Visual status display in terminal
+
+## Links
+
+- **GitHub**: https://github.com/ryoppippi/ccusage
+- **NPM**: https://www.npmjs.com/package/ccusage
+- **DevContainer Features**: https://containers.dev/features
+
+## Version History
+
+### 1.0.0
+- Initial release as DevContainer feature
+- Automatic user detection
+- Configurable shell support (bash/zsh/both)
+- Version pinning support
+- Idempotent installation
+
+## License
+
+This feature wrapper follows the same license as the underlying ccusage tool.

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

@@ -0,0 +1,38 @@
+{
+  "id": "ccusage",
+  "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": {
+      "type": "string",
+      "description": "ccusage version to use (e.g., 'latest', '1.0.0')",
+      "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/ccusage/install.sh

@@ -0,0 +1,132 @@
+#!/bin/bash
+set -euo pipefail
+
+# === SETUP ===
+cleanup() {
+    # No temp files needed for this simple feature
+    :
+}
+trap cleanup EXIT
+
+# === IMPORT OPTIONS ===
+# NOTE: DevContainer converts camelCase options to UPPERCASE without underscores
+# "version" → VERSION, "shells" → SHELLS, "username" → USERNAME
+CCUSAGE_VERSION="${VERSION:-latest}"
+SHELLS="${SHELLS:-both}"
+USERNAME="${USERNAME:-automatic}"
+
+echo "[ccusage] Starting ccusage 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 DEPENDENCIES ===
+if ! command -v npx &>/dev/null; then
+    echo "[ccusage] 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 ===
+# Validate shells parameter
+if [[ ! "${SHELLS}" =~ ^(bash|zsh|both)$ ]]; then
+    echo "[ccusage] ERROR: shells must be 'bash', 'zsh', or 'both'"
+    echo "  Provided: ${SHELLS}"
+    exit 1
+fi
+
+# Validate version format (basic check)
+if [[ ! "${CCUSAGE_VERSION}" =~ ^[a-zA-Z0-9.-]+$ ]]; then
+    echo "[ccusage] ERROR: version contains invalid characters"
+    echo "  Provided: ${CCUSAGE_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 "[ccusage] Installing for user: ${USERNAME}"
+
+# === GET USER HOME ===
+USER_HOME=$(eval echo "~${USERNAME}")
+if [ ! -d "${USER_HOME}" ]; then
+    echo "[ccusage] ERROR: Home directory not found for user ${USERNAME}"
+    exit 1
+fi
+
+# === INSTALL (CREATE ALIASES) ===
+ALIAS_CMD="alias ccusage=\"npx -y ccusage@${CCUSAGE_VERSION}\""
+
+configure_shell() {
+    local shell_rc="$1"
+    local shell_name="$2"
+
+    if [ ! -f "${shell_rc}" ]; then
+        echo "[ccusage] Creating ${shell_name} config file: ${shell_rc}"
+        sudo -u "${USERNAME}" touch "${shell_rc}"
+    fi
+
+    if grep -q "alias ccusage=" "${shell_rc}"; then
+        echo "[ccusage] ${shell_name} alias already configured. Skipping..."
+    else
+        echo "[ccusage] Adding ccusage alias to ${shell_name}"
+        echo "${ALIAS_CMD}" >> "${shell_rc}"
+        if ! chown "${USERNAME}:${USERNAME}" "${shell_rc}" 2>/dev/null; then
+            echo "[ccusage] WARNING: Could not set ownership on ${shell_rc}"
+            echo "  Fix: sudo chown ${USERNAME}:${USERNAME} ${shell_rc}"
+        fi
+    fi
+}
+
+# Configure requested shells
+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 "[ccusage] Verifying npx can access ccusage..."
+if sudo -u "${USERNAME}" bash -c "npx -y ccusage@${CCUSAGE_VERSION} --version" &>/dev/null; then
+    echo "[ccusage] ✓ ccusage is accessible"
+else
+    echo "[ccusage] WARNING: Could not verify ccusage installation"
+    echo "  This may be due to network connectivity"
+    echo "  The alias will still work once ccusage is available"
+fi
+
+# === SUMMARY ===
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  ccusage Installation Complete"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Configuration:"
+echo "  • User: ${USERNAME}"
+echo "  • Version: ${CCUSAGE_VERSION}"
+echo "  • Shells: ${SHELLS}"
+echo ""
+echo "Usage:"
+echo "  ccusage --daily      # Daily usage report"
+echo "  ccusage --monthly    # Monthly report"
+echo "  ccusage --live       # Live monitoring"
+echo "  ccusage --help       # Full options"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"