README file from
GithubGraphFrontier
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
urlandpathproperties 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
- Open the target vault in desktop Obsidian (GraphFrontier MCP is on by default in Sets → MCP).
- 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. - 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
Community Plugins (Recommended)
- Open Obsidian's Settings -> Community plugins and enable community plugins if needed.
- Select Browse, search for GraphFrontier, then select Install and Enable.
- 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
- Getting started: Installation, Usage, Settings.
- Advanced: Hotkeys and commands, Physics model, Local API and embedded MCP, Development and project structure.
- Help: Troubleshooting, Current release notes, release history.
Support
I would be grateful for your support, ideas and bug reports.
License
MIT. See LICENSE.