GraphFrontier

by pikiby
5
4
3
2
1
Score: 55/100

Description

Interactive graph workspace for Obsidian: arrange connected notes, save layouts, export diagrams and control the graph through MCP.

Reviews

No reviews yet.

Stats

20
stars
9,544
downloads
2
forks
191
days
1
days
1
days
1
total PRs
0
open PRs
0
closed PRs
1
merged PRs
6
total issues
0
open issues
6
closed issues
113
commits

Latest Version

2 days ago

Changelog

Export the graph you mean to share

Filter the graph down to the notes you want, then export it as a standalone HTML page. Notes hidden from that view are no longer included just because they exist in the vault. If you enable Layouts, the file also needs the notes visible in those other layouts, so readers can switch between them.

This changes newly generated files only. If you shared an older export and want the narrower scope, generate a new file and replace the old one. Included notes can still contain sensitive text and metadata; review them before sharing. API clients can omit note bodies with includeContents: false.

Style connections

Choose solid, dashed or dotted links globally, by group or for an individual node. Click an arrow shape to select it, adjust its size, and choose whether it scales with the nodes as you zoom. The eight shapes stay on one row in the compact picker. Exported graphs use the same link styles.

Connect a local agent

On desktop, GraphFrontier now connects through the official Obsidian CLI instead of listening on an HTTP port. Agent access is on by default; an existing OFF preference stays off. Use Sets → MCP or the plugin settings to turn it off. There is no port or token to copy.

If your client used the old HTTP endpoint, replace that entry with the stdio connector for your vault. The graph itself does not require Node.js or an MCP client.

Requires Obsidian 1.12.7+. To update, open Settings → Community plugins → Check for updates.

README file from

Github

GraphFrontier

GraphFrontier is an interactive graph workspace for Obsidian, with its own rendering and physics engine, independent of the built-in Graph View.

Turn connected notes into diagrams you can arrange, style, save, and share. Pin nodes in place, combine selections into named subgraphs, organize them around gravity centers, switch between layouts, and export interactive HTML graphs with note previews.

Include attachments as ordinary graph nodes, filter them by file type, and apply selection actions to multiple nodes at once.

Use it to:

  • Explore connections and discover patterns in your notes
  • Map systems, documentation, and database relationships
  • Build reusable visual layouts for research and presentations
  • Let AI agents search, arrange, and style your graph through the built-in API/MCP

Install · Features · Agent access · Documentation · Support

Get started: install GraphFrontier from Obsidian's Community plugins, then run Open GraphFrontier. Installation and updates.

New in 0.9.6

  • Share one view or several layouts. HTML exports include notes visible in the current graph. Enable Layouts to include the notes visible in the other exported layouts too. Files exported with earlier versions do not change; re-export them before sharing.
  • Distinguish connections at a glance. Use solid, dashed or dotted links, choose from eight arrow shapes, and adjust their size. Arrows can scale with the nodes or keep a fixed size on screen.
  • Connect an agent without manual port or token setup. On desktop, the built-in localhost MCP server is on by default in Sets → MCP and writes its local connection URL to .obsidian/plugins/graphfrontier/mcp.json — no Obsidian CLI or separate Node.js install needed. See connection instructions.
  • Reliable Grow on filtered graphs (0.9.6). Grow now schedules only visible notes, skips hidden ones cleanly, and lets you click Stop or Undo mid-run.

Read the 0.9.6 release notes · 0.9.5 · 0.9.4.

Local GraphFrontier

Open Local GraphFrontier from the command palette, a note's Open linked view submenu, or a graph node's Other submenu. It follows the active note and shows its direct neighbors, with independent settings, pins and layout state. Settings start hidden; use Show to open them. Named layouts and subgraph containers remain available in the global graph.

Sets → Add to search sets the modifier for adding a node name to search (default: Alt + click). Name filtering keeps all same-name nodes and their connections.

Features

  • On-demand rendering and cached physics/style calculations keep settled graphs idle and restore saved settled layouts.
  • Settings are organized into Groups, Display, Physics and Sets tabs.
  • Proportional node sizes, zoom-independent link widths, colors, opacity and directional arrows can be customized globally, by group or by node. Background and grid styling are configurable too.
  • YAML url and path properties support multiple destinations with readable aliases in quick-open submenus.

Attachments And Multi-Node Actions

Show linked attachments alongside notes, or enable Show unlinked attachments to include other files in the vault. Show orphans still applies. Use the File type: search field to choose multiple extensions and set an attachment node color. These settings are saved with each layout.

Attachments use the same size and physics controls as other nodes. Their labels include file extensions. Supported files open in Obsidian; other formats use the system's default app where available.

Select several nodes to pin, unpin, change compatible visual settings, or copy names and paths together. Actions apply to eligible selected nodes; actions that require a single node remain separate.

Groups And Node Lists

Style matching nodes with group rules. Groups change color by default; the sliders icon opens additional controls for size, aura, labels, link color and Strong pull. Individual node settings take priority over group settings. Use the eye to hide a group, or Alt-click it to solo; choose Hide to retain physical influence or Exclude to remove hidden nodes from physics.

Create node lists in Sets → Custom lists in the side panel, edit members in Settings -> GraphFrontier -> Node lists, or use Add to list on selected nodes. Use list:<id> as a group filter. Lists define membership; groups define appearance. External scripts can update membership through the API/MCP without editing your notes.

Undo And Backups

Undo manual moves and pin actions with Ctrl/Cmd+Z or the ↶ button next to Hide/Show at the top of the side panel. Redo with Ctrl+Y, Ctrl/Cmd+Shift+Z or ↷; the buttons are grey when there is nothing to undo or redo. Physics movement, colors and other settings are not part of this history. See undo and redo.

Automatic backups keep one current copy of layouts, lists and preferences outside the plugin folder. Configure the location, disable automatic backups or restore a copy in Settings -> GraphFrontier -> Backups. Access tokens are excluded. Existing copies are protected after reinstallation, and a temporary recovery copy protects against interrupted writes. This does not replace backing up your vault.

API And AI-Agent Control

GraphFrontier's built-in MCP lets an external AI agent search and work with the open graph, arrange notes, manage subgraphs, change visual settings, and save or export layouts. It uses the plugin's existing graph operations; it is not a separate chat or model service.

From A Request To A Saved Layout

In this example, an agent worked in GraphFrontier-Demo: it showed two tag groups around matching gravity centers, placed green on the left and blue on the right, added soft color auras, and saved the result as Twin Stars.

An MCP-capable agent can:

  • Search and filter notes, and work with groups, blacklists and whitelists.
  • Arrange and pin nodes, tune physics, and create or position gravity centers.
  • Create and rename subgraphs, open their panes, or ungroup their members.
  • Change global, group or individual visual settings, including colors, sizes and auras.
  • Create node lists and update membership to drive group styles.
  • Create and switch layouts, make backups, and export interactive HTML graphs.

Connect A Client

  1. Open the target vault in desktop Obsidian (GraphFrontier MCP is on by default in Sets → MCP).
  2. Ask your agent to connect using the local URL written to .obsidian/plugins/graphfrontier/mcp.json (connection instructions). No Obsidian CLI, separate Node.js install, or manual port/token entry is needed.
  3. Open a graph and ask the agent to identify the vault before making changes.

Safety And Current Limits

MCP is desktop-only and binds strictly to 127.0.0.1 with a generated per-vault secret URL in mcp.json. Only connect trusted clients: they can change layouts and export note content, and data returned to the client may be sent to its AI provider. GraphFrontier includes no built-in model or AI subscription. See the full tool and API reference for details.

Installation

  1. Open Obsidian's Settings -> Community plugins and enable community plugins if needed.
  2. Select Browse, search for GraphFrontier, then select Install and Enable.
  3. Run Open GraphFrontier from the command palette or use its ribbon icon.

Open the Community directory listing. No separate Node.js installation is needed. For updates, use Check for updates in Community plugins.

Manual Installation

Download main.js, manifest.json and styles.css from the latest release into <vault>/.obsidian/plugins/graphfrontier/, then enable GraphFrontier in Settings -> Community plugins.

When updating, replace the plugin files, not the entire folder: keep your data.json, layouts/, node-lists.json and optional mcp.json. Reload the plugin afterward.

See the installation guide for source builds and troubleshooting.

Compatibility And Privacy

  • Obsidian 1.12.7 or newer; graph works on desktop and mobile. Tested on Android 11 hardware and an Android 15 emulator with Obsidian 1.14.4; iOS is unverified, and touch box selection is unavailable.
  • External-file navigation is desktop-only.
  • GraphFrontier reads vault notes and metadata to build the graph; copy actions write to the clipboard.
  • HTML export stays inside the vault and can include note contents and paths; inspect exports before sharing.
  • Large-graph performance depends on graph size, enabled effects and device.

Documentation

Support

I would be grateful for your support, ideas and bug reports.

Share an idea · Report a bug

License

MIT. See LICENSE.