avagahana

See how it
all connects.

An agent explains. You understand.

Explore a real map
Avagahana architecture · live map
Opening the architecture…
A real map of Avagahana, in the real viewer. Click anything. Colours: · · Take the Markdown ↗
01 /

See the system↗

02 /

Follow the story↗

03 /

Explore the data↗

There’s more, when you want it

Build with it

Three small pieces. Use them together with your agent, or take just the one you need.

Embeddable
Put the real viewer in your website or your docs. Load it from here, keep the Markdown file on your side:
import { mount } from './map-viewer/index.js';
mount(element, { text: markdown });
Themeable
Hand the viewer a theme object: your colours, your typography. Switch themes any time and the reader stays where they are. Try it under the map above.
Modular
Viewer, Atlas and relay work together while you work with your agent. To publish a finished map, you need only the viewer and static hosting.

Learn the skills

One prompt. So many connections. Two skills teach your agent to draw maps.

illuminate-conceptone idea
Explains one concept as a map: a system, a flow, the states something goes through, a data model, a plan of changes. Use it when three or more things relate, or when you are stuck on an idea and a picture would help.
trace-architecturea whole project
Reviews a whole project or repository and maps it in one file: structure, layers, key flows, lifecycles, data. Use it to understand or document a codebase. It builds on illuminate-concept.

The map on this page came from one trace-architecture prompt:

12.9klines of code
14connected diagrams
$0.36to make

Your next moment of clarity

Let understanding
take shape.

Claude Code 01
/plugin marketplace add nvsravank/avagahana
/plugin install avagahana@avagahana
Codex 02
codex plugin marketplace add nvsravank/avagahana
codex plugin add avagahana@avagahana

Python 3.9+ required. Open source, MIT licensed: see it on GitHub.

A first prompt to try +

“Review this codebase and create an Avagahana map of its architecture. Show me the components, how a request flows, and the data model.”

A little more, if you’re curious

What does Avagahana mean?+

అవగాహన is Telugu for understanding, comprehension and awareness. That’s the point: make the connections clear enough to build your own mental model.

Does exploring this map use AI tokens?+

No. An agent generated the file earlier. The viewer renders that file in your browser. Creating or changing a map with an agent uses that agent’s model allowance or API usage.

Is the viewer an editor?+

The viewer is for reading and exploring. You or your agent edit the Markdown file; the viewer turns it into an interactive explanation.

Do I need a server?+

When you work with an agent, the viewer, Atlas and relay work together to show and update your maps. To publish a finished map on a website or wiki, embed the viewer with the Markdown file. That published view needs static hosting.

Make room for
“oh, I see.”

Start connecting