Hypernovum

Hypernovum

Turn the projects in your Obsidian vault into a live 3D city — then run your AI coding agents from it and watch them work.

Each project note becomes a building. Status maps to color, priority to height, category to district, and vault backlinks to glowing **Neural Link** arcs. A central **Neural Core** pulses as you work, **Data Arteries** flow to buildings when files change, and every active agent (Claude Code, GPT Codex, Antigravity CLI) orbits its building as a colored orb.


Install

Install from **Settings → Community plugins → Browse → "Hypernovum"**, then enable it and run **Open code city** from the command palette (or click the cube in the ribbon).

Desktop only — the agent half of the plugin talks to your local `git` and terminal.

Quick start

Until you tag anything, Hypernovum shows **your whole vault** — folders become districts, notes become buildings, and height is how many notes link in. That is a preview, not the product: tag one note and the city switches to project mode, where colour, height and windows start reporting real state. Add this frontmatter to a note:

---
tags: [project]
title: My Project
status: active          # active · blocked · paused · complete  → building color
priority: high          # low · medium · high · critical        → building height
category: web-apps      # any string                            → district
projectDir: C:\Users\me\projects\my-project   # unlocks Git signals + agent launch
---

The city rebuilds as you save. `projectDir` is the field that matters most: without it a project has no Git activity, no dependency edges, and no **Launch agent** action. See [SCHEMA.md](SCHEMA.md) for every field.

![Whole-vault fallback — an untagged vault rendered as districts by folder, with hub notes towering](https://