A self-contained, offline graph viewer built from your project's SQLite databases. Tree-sitter structure on the structural side, LLM summaries and architectural layers on the semantic side — rendered as a navigable graph.
The dashboard SPA (Vite + React + react-force-graph) ships as source under
dashboard/. Build the bundle once; it compiles to a single
self-contained HTML the CLI reuses for every project.
npm run build:dashboard # installs + builds dashboard/ -> dashboard/dist
# or build everything (dashboard + CLI):
npm run build:allcd /path/to/your/project
codegps dashboard # writes .codegps/dashboard/index.html + graph.json
codegps dashboard --open # and open it in your browser
The graph snapshot is inlined into index.html, so it opens
directly from disk (file://) with no server. Run it again after
sync / analyze / ingest to refresh.
| View | What it shows |
|---|---|
| Graph | File-level dependency graph (imports + calls), nodes colored by architectural layer. Click a node for its summary and tags. |
| Domains | Classified industries, evidence-cited portfolio highlights, and domain entities. |
| Layers | Files grouped by architectural layer (api · service · data · ui · utility · other). |
| Search | Fuzzy search across files, concepts, entities, and highlights. |
codegps dashboard also writes a standalone
graph.json next to the HTML. It is a bounded export from
code.db + knowledge.db:
Both artifacts are self-contained. Commit graph.json for
teammates, or hand someone the single index.html — it renders
offline with no install. (Inspired by
Understand-Anything's
commit-the-graph workflow.)