News for hackers. Stuff that matters.

Show HN: Galactica, a TypeScript codebase map for developers and agents

https://github.com/cognitap/galactica

As a part of experiments exploring how we as humans fit into development processes, I built Galactica. I wanted a way to see how a codebase fits together, and to give my coding agent that same information before it starts changing things.

I rather suspected than expected this, but it also makes agents more efficient.

It follows imports and exports to build a map of the repository. The agents get neat commands for questions like "where is this defined?", "what depends on this file?" and “which tests reach it?”, I get an interactive HTML page where I can explore those same relationships.

There’s also a skill that tells the agents when to use it: get an overview before diving in, check dependents before editing, and check for new import cycles afterward.

It runs locally, doesn’t execute the code it analyses, and usually needs no configuration. It supports JavaScript too, including JSX and the script sections of Vue, Svelte and Astro files.

It's still early. I’d be interested to hear whether it helps you find your way around a repository, whether it helps you in your development processes you think it falls short. Does this answer questions you currently piece together manually, or does your existing setup already cover them?

I found it quite useful for situations where agents prototype something quickly and I want to get a good understanding of what's actually being built.

( no comments | on HN )

There are no comments yet.