Quickstart

Clone, materialize the cache, and serve the dashboard on loopback.

Three commands between a fresh clone and a running dashboard. Requires Bun 1.3.0 or newer and a local OpenCode database.

01Clone and install

The web workspace installs separately — it is a distinct Vite app.

git clone https://github.com/4i3n6/opencodeview.git
cd opencodeview
bun install
cd web && bun install && cd ..

Reads the source read-only and writes rollups into its own SQLite file. Point OPENCODE_DB elsewhere if your install is non-standard.

bun src/scan.ts --all

# or a single project
bun src/scan.ts --list
bun src/scan.ts <project>

API and UI run as two processes, both bound to loopback.

bun run serve   # http://127.0.0.1:4317
bun run web     # http://127.0.0.1:5273

Commands
Command	What it does
bun src/scan.ts --list	Cheap project list
bun src/scan.ts <project>	Scan one project into the cache
bun src/scan.ts --all	Scan everything
bun run serve	API on 127.0.0.1:4317
bun run web	UI on 127.0.0.1:5273
bun run check	Full gate: test, typecheck, lint, build, audit, Gitleaks
bun run release:check	Release harness only