Skip to content

Commit f6c05a4

Browse files
committed
Add dashboard package and update monorepo docs
New Svelte 5 SPA + Bun backend for session analytics, conversation replay, task/plan/agent views, and cost tracking. Updates root CLAUDE.md to reflect four-package monorepo with dashboard-specific test commands and Dashboard vs CLI guidance.
1 parent 706bfad commit f6c05a4

931 files changed

Lines changed: 57137 additions & 1 deletion

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CLAUDE.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# CodeForge Monorepo
22

3-
This repository contains three packages. Each package manages its own dependencies independently.
3+
This repository contains four packages. Each package manages its own dependencies independently.
44

55
## Packages
66

@@ -9,6 +9,7 @@ This repository contains three packages. Each package manages its own dependenci
99
| `container/` | Node.js | npm |
1010
| `cli/` | Bun | bun |
1111
| `docs/` | Node.js | npm |
12+
| `dashboard/` | Bun | npm (frontend) / bun (server) |
1213

1314
## Development Rules
1415

@@ -26,6 +27,7 @@ Each package has its own `CLAUDE.md` with package-specific development rules:
2627
- [`container/CLAUDE.md`](container/CLAUDE.md) — changelog, documentation, and configuration rules for the devcontainer package
2728
- `cli/` — Bun/TypeScript CLI; run `bun test` for tests
2829
- `docs/` — Astro/Starlight site; run `npm run build` to verify
30+
- [`dashboard/CLAUDE.md`](dashboard/CLAUDE.md) — Svelte 5 SPA + Bun backend for session analytics
2931

3032
### Cross-Package Changes
3133

@@ -39,3 +41,21 @@ Run tests for each affected package before committing:
3941
- **Container**: `cd container && npm test`
4042
- **CLI**: `cd cli && bun test`
4143
- **Docs**: `cd docs && npm run build`
44+
- **Dashboard**: `cd dashboard && bun test`
45+
46+
### Dashboard vs CLI
47+
48+
The `dashboard/` and `cli/` packages serve different audiences:
49+
50+
- **CLI** (`codeforge` command) — terminal-first, text/JSON output, scriptable,
51+
runs inside or outside the container. Features: session search, task search/list/show,
52+
plan search, plugin management, index/config commands.
53+
- **Dashboard** (Svelte 5 SPA) — visual analytics, charts, expandable detail views,
54+
real-time SSE updates. Features: session browsing with conversation replay,
55+
task/plan/agent/memory views, project analytics, cost tracking.
56+
57+
When adding a new data view:
58+
- If it's browsable/visual (tables, charts, detail drill-down) → dashboard
59+
- If it's scriptable/automatable (piped output, filters, JSON) → CLI
60+
- If it's both → implement in both, but don't import CLI as a dashboard dependency.
61+
Fork patterns instead.

0 commit comments

Comments
 (0)