Cluster Graph

The Cluster Graph is a spatial visualization that shows all your indexed documents as nodes on a canvas, positioned by how similar their content is. Related documents cluster together; unrelated ones drift apart.

It gives you a bird's-eye view of your project's knowledge landscape — where themes concentrate, which documents are closely related, and where isolated content lives.

How it works

The Cluster Graph uses a physics-based layout that positions documents based on a composite similarity score:

  • Content similarity (primary factor) — how semantically similar the actual text is, based on local embeddings
  • Shared tags — documents with the same tags are drawn closer
  • Manual links — documents you have explicitly linked sit nearer each other
  • Folder proximity — documents in the same folder get a mild pull toward each other

The result is a map where clusters of related documents emerge naturally from your content.

Where to find it

  • Project Navigator → Clusters tab — embedded in the main workspace as one of the center view modes
  • Standalone window — open from the command menu for a larger, resizable view

Interacting with the graph

  • Pan — drag the canvas background to move around
  • Zoom — scroll to zoom in and out
  • Click a node — enter focus mode. The selected document highlights, connection lines appear showing its strongest relationships, and unrelated nodes fade.
  • Double-click a node — open that document
  • Drag a node — manually reposition it (resets on reload)

Grouping and filtering

The toolbar offers controls to change how clusters are colored and filtered:

  • Group by — color nodes by Type, Tag, Folder, or Date. This makes it easy to see how different categories distribute across the similarity map.
  • Date filter — show only documents from Today, This Week, This Month, or All Time
  • Search — filter and highlight nodes matching a keyword, semantic query, or tag. Non-matching nodes fade.
  • Max nodes — adjust density from 10 to 500 nodes on screen

Focus mode

When you click a document node, focus mode activates:

  • The selected node highlights with a distinct color
  • Up to 7 connection lines appear showing the strongest relationships
  • Unrelated nodes dim to reduce visual noise
  • The Document Info panel (if visible) shows details about the focused document

Click the canvas background or the same node again to exit focus mode.

How it differs from the Project Navigator

The Project Navigator is a full workspace with file browsing, editing, and management. The Cluster Graph is a focused visualization:

  • Project Navigator — organizes content by folders, lists, and actions. Where you work with files.
  • Cluster Graph — organizes content by meaning and relationships. Where you understand how your project fits together.

The Cluster Graph is most useful for large projects where you want to see the big picture, find unexpected connections between documents, or identify content that is isolated from the rest of your project.

Requires indexed content. Documents must be indexed in project memory to appear in the Cluster Graph. If the visualization is empty, make sure your project content has been indexed.

Related