Hypernovum — Agent Ops for Your Second Brain

A 3D IDE and agent-ops dashboard for Obsidian, built on Three.js. Hypernovum turns your vault — your second brain — into a living cyberpunk code city: visualize projects and their backlinks in 3D, dispatch AI coding agents (Claude Code, GPT Codex, Antigravity CLI) with full vault context, post research quests for agents to resolve, and watch your entire fleet work in real time.

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

Features

City Visualization

• Bin-packed layout with category districts, block outlines, and drag handles for rearranging
• Procedural architecture — each category gets a unique silhouette (helix towers, data shards, ziggurats, quant blades, hex hives, memory cores)
• Cyberpunk shader system with procedural windows, decay dithering, and bloom post-processing
• Smart labels with CSS2D rendering and leader lines
• Hover tooltips showing status, priority, health, and tech stack

Second Brain & Agent Ops

• Prepare vault for AI agents — one click writes a marker-fenced AGENTS.md at the vault root: project schema, live inventory, quest board, skills roster, and heartbeat protocol, so any CLI agent instantly understands your second brain
• Quest board: a questions: list in project frontmatter renders as a floating gold quest marker over the building, shows in the inspector and tooltip, and is published to agents via AGENTS.md — resolving a quest (move it to answered:) fires an emerald shockwave at the building
• Abilities roster: agent skills (SKILL.md files in vault or ~/.claude/skills/) listed in the agents panel — click to copy an invocation
• Neural Links: toggle vault backlinks between projects as pulsing violet knowledge arcs — your knowledge graph as city infrastructure
• Agent fleet presence: multiple agents in the heartbeat file each get their own colored orb orbiting the building they're working on
• Daily briefing: one command writes a digest note — status counts, blocked/stale attention list, quest board, git heat

Interactions

• Search and filters for quickly narrowing the city by title, status, priority, category, path, or stack
• Visual scan modes: status, read-only Git activity, memory-ready, task-progress ramp, recency heatmap, and tech-stack colors — with an adaptive legend
• City overview: the inspector doubles as a district analytics readout (per-district counts, active %, open quests) when nothing is selected
• Snapshot: one click saves a clean cinematic PNG of the city (title card, no HUD) into your vault
• Project inspector with note/folder/agent/context/focus actions
• Click a building to open its note
• Right-click a building for context menu (Launch Agent, Inspect Project, Open in Explorer, Open Note, Focus Camera)
• Right-click the Neural Core orb to launch Claude Code in any folder via OS folder picker
• Double-click a building to enter move mode (reposition individual buildings)
• Drag handles to rearrange entire category blocks
• Scroll to zoom, right-drag to pan
• Keyboard shortcuts: cycle blocked/stale projects, reset camera

Neural Core & Data Arteries

• Central geodesic wireframe sphere with RGB chromatic split and rotating rings
• Data Arteries — animated tube geometry flowing from core to buildings on file changes
• City states: IDLE (cyan) / STREAMING (cyan fast) / BULK_UPDATE (gold)

Claude Code Integration

• Activity Monitor polls .hypernovum-status.json for real-time Claude Code status
• Persistent streaming artery while Claude is actively working on a project
• Activity indicator overlay shows current project and action
• Terminal Launcher for launching Claude Code, GPT Codex, Antigravity CLI, or a custom agent command
• Agent context handoff writes .hypernovum/SETUP.md with project metadata, Git signals, and memory context pointers before launch
• Heartbeat script (scripts/heartbeat.js) for Claude Code hooks integration

Git & Memory Signals

• Read-only Git activity layer shows recent commit velocity, branch, working-tree state, stale projects, and merge conflict signals
• Memory-ready filter finds projects that already have .hypernovum/MEMORY_CONTEXT.md
• Funding metadata is included for users who want to support the free plugin

HUD

• HYPERNOVUM neon title with flashing block cursor at top center
• Adaptive SCAN-MODE legend that re-renders per visual layer (status chips, gradient ramps, live stack roster)
• Controls hint overlay with all mouse and keyboard shortcuts
• Save Layout and Snapshot buttons

Platform Support

Platform	Terminal Emulators	Notes
Windows	Windows Terminal, cmd.exe	Tries wt first, falls back to cmd
macOS	iTerm2, Terminal.app	Tries iTerm2 first (if running), falls back to Terminal.app
Linux	gnome-terminal, konsole, xfce4-terminal, xterm	Tries each in order until one succeeds

All features — Neural Core, Data Arteries, Claude Code integration, context menus — work identically on every platform. The only difference is which terminal emulator opens.

Frontmatter Schema

Projects are detected by frontmatter tag project or field type: project. See SCHEMA.md for the full field reference.

---
tags: [project]
title: My Project
status: active
priority: high
category: web-apps
stack: [TypeScript, React, Vite]
questions:            # optional research quests for AI agents
  - "Which vector DB fits this workload?"
projectDir: C:\Users\me\projects\my-project   # Windows
# projectDir: /Users/me/projects/my-project   # macOS
# projectDir: /home/me/projects/my-project    # Linux
---

AI Integration

Hypernovum has no built-in AI. External AI tools (Claude Code, etc.) read SCHEMA.md to learn the frontmatter format, scan your project directories, and write frontmatter to vault notes. Hypernovum renders the result.

Prepare vault for AI agents (command palette, settings, or the agents panel) writes an AGENTS.md at the vault root containing the frontmatter schema, a live inventory of your projects, and instructions for making agent activity visible in the city — so any CLI agent launched in the vault immediately understands your second brain. Safe to re-run: only the marked Hypernovum section is regenerated; the rest of an existing AGENTS.md is preserved.

The scripts/heartbeat.js script can be wired into Claude Code hooks to enable real-time activity visualization:

# macOS / Linux
node scripts/heartbeat.js --vault="/Users/you/Documents/MyVault" --project="my-project" --action="editing"

# Windows (PowerShell)
node scripts/heartbeat.js --vault="C:\Users\you\Documents\MyVault" --project="my-project" --action="editing"

The heartbeat file (.hypernovum-status.json) is written to the vault root, so the --vault flag must point to your actual vault folder regardless of platform.

Development

npm install
npm run dev    # watch mode
npm run build  # production build

Built with Three.js, Zustand, and the Obsidian Plugin API.

Hypernovum Pro

This Obsidian plugin remains free and open source. For a standalone desktop experience beyond Obsidian — featuring full Engram Persistent Agent Memory, AI agent management, MCP server integration, Tandem Terminal, broader project scanning, and more — check out Hypernovum Pro.

License

AGPL-3.0 — Free to use, modify, and distribute. Any modified version that is deployed must also be open-sourced under AGPL-3.0.

---

Keywords: agent ops, second brain, 3D IDE, Three.js IDE, Obsidian plugin, AI agents, Claude Code, agentic coding, code city, knowledge graph visualization, project dashboard, PKM, developer tools