Back to work
Project / 02Cosmograph / React / Vite

Cosmographer

A way to see a project’s domains and cross-cutting concerns.

Cosmographer is a way to visualise a project’s structure from the top down. It traverses a codebase, follows the path from view to function to state and back again, and turns those relationships into something you can actually inspect rather than infer from dozens of files and tabs.

  • Maps screens, calls, state changes, and ownership boundaries into graph data.
  • Renders pre-indexed datasets in a local viewer built on Cosmograph.
  • Uses the /cosmograph skill to generate the datapoints the viewer renders.

How it works

The viewer itself is intentionally small. The heavier part lives upstream in the skill and model workflow that traverses a codebase, extracts datapoints, and returns a graph structure for the app to render. The web app then stays focused on loading indexed points, links, config, and layout data in a simple self-contained package.

Current state

It is still an active experiment. Getting good output depended heavily on model capability, context, and trial-and-error refinement, especially when working with older 4.x ChatGPT models. I want to revisit it with newer frontier models and push the quality of the traversal much further.

Command surface