Ship first-party dashboard with container

Dashboard package:
- Rename @codeforge/dashboard → codeforge-dashboard, remove private flag
- Add bin wrapper with --port/--host/--version/--help flags
- Add HOST env var support to Bun.serve for container port forwarding
- Add files, engines, prepublishOnly fields for npm publish
- Move build-time deps (Svelte, Vite, Tailwind) to devDependencies

Container feature:
- Rewrite install.sh: bun install -g replaces npm install -g
- Add autostart poststart hook (PID-guarded, nohup background launch)
- Rename command: claude-dashboard → codeforge-dashboard
- Remove persistence symlink hook (DB on bind mount)
- Update feature metadata, README, devcontainer.json, CLAUDE.md

CI/CD:
- Add release-dashboard.yml workflow (dashboard-v* tags → npm publish)
- Add test-dashboard job to ci.yml
- Add dashboard/CHANGELOG.md

Author: AnExiledDev

.github/workflows/ci.yml

@@ -3,10 +3,10 @@ name: CI
 on:
   push:
     branches: [main, staging]
-    paths: ['container/**', 'cli/**']
+    paths: ['container/**', 'cli/**', 'dashboard/**']
   pull_request:
     branches: [main, staging]
-    paths: ['container/**', 'cli/**']
+    paths: ['container/**', 'cli/**', 'dashboard/**']
 
 jobs:
   test:
@@ -52,3 +52,13 @@ jobs:
         working-directory: cli
       - run: bun test
         working-directory: cli
+
+  test-dashboard:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: oven-sh/setup-bun@v2
+      - run: bun install
+        working-directory: dashboard
+      - run: bun test
+        working-directory: dashboard

.github/workflows/release-dashboard.yml

@@ -0,0 +1,75 @@
+name: Release Dashboard
+
+on:
+  push:
+    tags: ['dashboard-v*']
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.extract.outputs.version }}
+    steps:
+      - uses: actions/checkout@v6
+      - id: extract
+        name: Extract and validate version
+        run: |
+          TAG="${GITHUB_REF#refs/tags/dashboard-v}"
+          PKG=$(node -p "require('./dashboard/package.json').version")
+          echo "version=$TAG" >> "$GITHUB_OUTPUT"
+          if [ "$TAG" != "$PKG" ]; then
+            echo "::error::Tag dashboard-v${TAG} does not match dashboard/package.json version ${PKG}"
+            exit 1
+          fi
+
+  publish-and-release:
+    needs: validate
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install
+        working-directory: dashboard
+
+      - name: Run tests
+        run: bun test
+        working-directory: dashboard
+
+      - name: Build SPA
+        run: bun run build
+        working-directory: dashboard
+
+      - name: Verify package contents
+        run: npm pack --dry-run
+        working-directory: dashboard
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 18
+          registry-url: https://registry.npmjs.org
+
+      - name: Publish to npm
+        run: npm publish
+        working-directory: dashboard
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Extract changelog section
+        id: changelog
+        run: |
+          VERSION="${{ needs.validate.outputs.version }}"
+          NOTES=$(sed -n "/^## v${VERSION}/,/^## v/{ /^## v${VERSION}/d; /^## v/d; p; }" dashboard/CHANGELOG.md)
+          [ -z "$NOTES" ] && NOTES="Dashboard Release v${VERSION}"
+          echo "$NOTES" > /tmp/release-notes.md
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="dashboard-v${{ needs.validate.outputs.version }}"
+          gh release create "$VERSION" --title "$VERSION" --notes-file /tmp/release-notes.md

container/.devcontainer/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+### Dashboard
+- **First-party dashboard** — replaced third-party `claude-session-dashboard` npm package with `codeforge-dashboard` (built from monorepo `dashboard/` package)
+- Auto-launch on container start via poststart hook (controllable with `autostart` option)
+- Install switched from npm to Bun (`bun install -g`)
+- Command renamed: `claude-dashboard` → `codeforge-dashboard`
+- Removed persistence symlink hook (dashboard DB now lives on bind mount at `~/.codeforge/data/`)
+
 ### Skills
 - Added `agent-browser` skill to skill-engine plugin — guides headless browser automation with CLI reference, workflow patterns, and authentication
 

container/.devcontainer/CLAUDE.md

@@ -29,7 +29,7 @@ Config files deploy via `.codeforge/file-manifest.json` on every container start
 | `ccusage` / `ccburn` | Token usage analysis / burn rate |
 | `agent-browser` | Headless Chromium (Playwright-based) |
 | `check-setup` | Verify CodeForge setup health |
-| `claude-dashboard` | Session analytics dashboard (port 7847) |
+| `codeforge-dashboard` | Session analytics dashboard — auto-launches on start (port 7847) |
 | `dbr` | Dynamic port forwarding ([devcontainer-bridge](https://github.com/bradleybeddoes/devcontainer-bridge)) |
 | `cc-tools` | List all installed tools with versions |
 

container/.devcontainer/README.md

@@ -203,7 +203,7 @@ claude --resume               # Resume previous session
 | `ccburn` | Visual token burn rate tracker with pace indicators |
 | `ccstatusline` | Status bar display (integrated into Claude Code, not standalone CLI) |
 | `claude-monitor` | Real-time usage tracking |
-| `claude-dashboard` | Local session analytics dashboard (token usage, costs, timelines) |
+| `codeforge-dashboard` | Session analytics dashboard — auto-launches on start (port 7847) |
 
 ## Configuration
 

container/.devcontainer/devcontainer.json

@@ -46,8 +46,9 @@
 
 	// Feature install order: external runtimes first (Node, uv, Bun),
 	// then Claude Code native binary (no Node dependency), then custom features.
-	// npm-dependent features (agent-browser, ccusage, claude-session-dashboard,
-	// biome, lsp-servers) must come after Node. uv-dependent features (ruff, claude-monitor) must
+	// npm-dependent features (agent-browser, ccusage,
+	// biome, lsp-servers) must come after Node. bun-dependent features
+	// (claude-session-dashboard) must come after Bun. uv-dependent features (ruff, claude-monitor) must
 	// come after uv. notify-hook is second-to-last (lightweight, no dependencies).
 	// dbr (devcontainer-bridge) is last — standalone binary, no dependencies.
 	"overrideFeatureInstallOrder": [
@@ -160,7 +161,7 @@
 	"forwardPorts": [7847],
 	"portsAttributes": {
 		"7847": {
-			"label": "Claude Dashboard",
+			"label": "CodeForge Dashboard",
 			"onAutoForward": "notify"
 		},
 		"*": {

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

@@ -1,15 +1,16 @@
-# Claude Session Dashboard (devcontainer feature)
+# CodeForge Dashboard (devcontainer feature)
 
-Installs [claude-session-dashboard](https://github.com/dlupiak/claude-session-dashboard) — a local analytics dashboard for Claude Code sessions.
+Installs [codeforge-dashboard](https://github.com/AnExiledDev/CodeForge) — the first-party analytics dashboard for Claude Code sessions, built from the monorepo `dashboard/` package.
 
 ## What it provides
 
-- `claude-dashboard` command to launch the web UI
+- `codeforge-dashboard` command to launch the web UI
+- Auto-launches on container start via poststart hook (controllable with `autostart` option)
 - 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/`
+- Dashboard DB persisted at `~/.codeforge/data/dashboard.db` on the bind mount
 
 ## Options
 
@@ -19,22 +20,27 @@ Installs [claude-session-dashboard](https://github.com/dlupiak/claude-session-da
 | `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 |
+| `autostart` | `true` | Auto-launch dashboard on container start |
 
 ## Usage
 
 ```bash
 # Start the dashboard (default port 7847)
-claude-dashboard
+codeforge-dashboard
 
 # Start on a custom port
-claude-dashboard -p 8080
+codeforge-dashboard -p 8080
 
 # Show help
-claude-dashboard --help
+codeforge-dashboard --help
 ```
 
 The dashboard reads session data from `~/.claude/projects/`.
 
-## How persistence works
+## Auto-launch behavior
 
-Dashboard settings and cache are stored at `~/.claude-dashboard/`. A poststart hook symlinks `~/.claude-dashboard` → `/workspaces/.claude-dashboard/`, which is bind-mounted and survives rebuilds.
+When `autostart` is enabled (default), a poststart hook starts the dashboard in the background on every container start. It listens on `0.0.0.0:7847` so VS Code port forwarding works automatically. The process writes logs to `/tmp/codeforge-dashboard.log` and tracks its PID at `/tmp/codeforge-dashboard.pid` to avoid duplicate launches.
+
+## Persistence
+
+The dashboard database is stored at `~/.codeforge/data/dashboard.db`, which lives on the Docker named volume backing `~/.claude/`. This survives container rebuilds without any symlink hooks.

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

@@ -1,33 +1,36 @@
 {
-  "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"]
-    },
-    "username": {
-      "type": "string",
-      "description": "Container user to install for",
-      "default": "automatic"
-    }
-  },
-  "installsAfter": [
-    "ghcr.io/devcontainers/features/node:1"
-  ]
+	"id": "claude-session-dashboard",
+	"version": "1.0.0",
+	"name": "Claude Session Dashboard",
+	"description": "First-party analytics dashboard for Claude Code sessions, built from the CodeForge monorepo dashboard package",
+	"documentationURL": "https://github.com/AnExiledDev/CodeForge",
+	"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"]
+		},
+		"username": {
+			"type": "string",
+			"description": "Container user to install for",
+			"default": "automatic"
+		},
+		"autostart": {
+			"type": "boolean",
+			"description": "Auto-launch dashboard on container start",
+			"default": true
+		}
+	},
+	"installsAfter": ["ghcr.io/rails/devcontainer/features/bun:1"]
 }