Graph view

Reading text line by line is essential for focused thinking, but understanding complex knowledge systems requires spatial awareness. When your notes span months of architectural decisions, customer interviews, and project specs, it is difficult to spot emerging themes or identify isolated ideas from a flat file list alone.

Oyma features an integrated, high-performance Graph View implemented natively in src/renderer/workspace/graph/GraphView.ts.

By mapping your documents as interconnected nodes and relationships as force-directed links, Graph View turns your vault into an interactive visual cosmos, revealing the hidden topography of your thinking.

Spatial navigation for your personal knowledge base

The traditional sidebar tree shows where files are stored on disk. The Graph View shows how ideas relate to one another in your mind.

When you launch the global graph in Oyma, every Markdown note becomes a distinct node, and every wikilink forms an elastic connecting edge. The physics simulation balances repulsive forces between nodes with attractive spring tension along links, causing natural topical clusters to assemble organically before your eyes.

You can observe:

• Central knowledge hubs: Heavily referenced index notes, core architectural frameworks, or foundational clients stand out as dense, luminous clusters with many radiating connections.
• Thematic bridges: Single notes that span two disparate domains—such as a technical briefing that bridged engineering and legal considerations—reveal themselves as structural conduits between clusters.
• Isolated islands: Notes with zero incoming or outgoing connections float on the periphery, signaling draft ideas that require deeper integration or archived items ready for cleanup.

Hovering over any node highlights its direct network path while dimming unrelated clusters. Clicking any node immediately loads that document into the live-preview Markdown editor, letting you transition effortlessly between high-level structural exploration and detailed sentence editing.

Local graph: Focused contextual awareness

While the global graph provides an exhilarating macro-perspective of your entire archive, working on a specific task demands focused clarity. For daily drafting and deep research, Oyma offers a dedicated Local Graph pane.

Positioned in the workspace inspector beside your active editor, the local graph tracks your current cursor position and document focus. It isolates the active note at the center of the canvas and dynamically renders its immediate network environment:

1. Depth control: Dial the connection horizon between 1, 2, or 3 degrees of separation. At 1 degree, you see only direct links and backlinks. At 2 degrees, you see the neighbors of your neighbors, illuminating surrounding context without visual noise.
2. Directional indicators: Visual arrows display link directionality, clarifying which documents point toward your active note and which outward references it emits.
3. Neighbor previews: Hovering over adjacent nodes displays miniature summary cards, allowing you to scan related concepts without switching away from your current writing flow.

When taking notes during a customer interview or team standup, the local graph keeps relevant background notes in peripheral vision, reminding you of related topics discussed weeks prior.

Precision filtering and custom views

A large vault containing thousands of files can quickly become an overwhelming visual thicket without effective filtering tools. Oyma provides a rich set of non-destructive visual controls to help you dissect your network:

• Folder scoping: Restrict the graph to specific directories—such as /projects or /clients—while omitting general administrative archives.
• Tag overlays: Display tags as distinct colored nodes to see how abstract themes (like #security or #ux) intersect across diverse folders.
• Orphan toggling: Show or hide disconnected notes with a single click, allowing you to alternate between comprehensive audits and focused link-building sessions.
• Search filtering: Type any keyword or file prefix into the graph filter bar to isolate matching subgraphs in real time.
• Visual styling: Customize node size scaling based on connection count, adjust link thickness, and tune physics constants like gravity, spring distance, and friction to match your aesthetic preference.

Every filter setting is non-destructive; adjusting visual parameters never alters a single byte in your underlying Markdown files.

Engineered for fluid 60 FPS performance on macOS

Graph visualization engines built on top of sluggish DOM elements or unoptimized web libraries frequently grind to a halt when vaults grow beyond a few hundred documents.

Oyma approaches graph rendering with performance-first principles. Leveraging Canvas 2D and WebGL acceleration, the layout engine executes Barnes-Hut spatial approximation algorithms to compute n-body physics efficiently. Node coordinates are cached and rendered directly to hardware-accelerated buffers, delivering fluid 60 frames per second panning, zooming, and node dragging even on expansive vaults containing tens of thousands of connections.

Because the entire graph calculation operates 100% locally on your Mac without external APIs or cloud synchronization, the view opens instantly without loading spinners or network latency.

Bridge spoken discussions with permanent concepts

When you capture meetings using zero-bot meeting recording and generate structured summaries via local AI with Ollama, each session generates a timestamped Markdown record in your vault.

By incorporating wikilinks to relevant project notes within those meeting records, your meetings transform from disposable transcripts into permanent conversational hubs in your graph. Over months of collaboration, your Graph View visualizes how decisions evolved across time, which team members spearheaded key initiatives, and how organizational momentum accumulated.

Discover the structural geometry of your ideas in Oyma and experience a truly connected personal knowledge base.