MCPcopy Index your code
hub / github.com/Real1tyy/Nexus-Properties

github.com/Real1tyy/Nexus-Properties @2.0.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release 2.0.2 ↗ · + Follow
1,186 symbols 2,610 edges 158 files 92 documented · 8% updated 37d ago2.0.2 · 2026-02-27★ 531 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Nexus Properties

Downloads Release Stars License Obsidian

Automated property management and interactive relationship visualization for Obsidian — bidirectional sync, graph views, and intelligent property inheritance for power users who want structured knowledge networks.


Video Tutorials

View All Video Tutorials →

Full Tutorial — Zero to Mastery

Nexus Properties - Full Tutorial

Complete Workflow Guide: From installation and creating your first relationships, to bidirectional sync, graph views, color rules, filtering, and more.

Feature Previews

Bases View Multi-Row Layout
All Related View MOC View

See the full documentation for all features and video demos.


Who is this for?

Built for system builders with large, long-lived vaults who think in hierarchies and networks.

Good fit if you:

  • Manage complex knowledge systems with hundreds or thousands of notes
  • Want structured workflows with consistent, auto-synced metadata
  • Value visual navigation of your knowledge structure

Not ideal if you:

  • Prefer minimal notes without frontmatter
  • Don't need structured parent-child or related relationships

Documentation

View Full Documentation →

Quick Links:


Installation

Nexus Properties is currently awaiting approval for the Obsidian Community Plugin store. In the meantime, you can install it using one of these methods:

Recommended: BRAT (Beta Reviewers Auto-update Tool)

The easiest way to install and keep Nexus Properties up to date:

  1. Install the BRAT plugin from Obsidian's Community Plugins
  2. Open BRAT settings (Settings → BRAT)
  3. Click Add Beta Plugin
  4. Enter this repository URL: https://github.com/Real1tyy/Nexus-Properties
  5. Click Add Plugin
  6. Enable Nexus Properties in Settings → Community Plugins

BRAT handles updates automatically, so you always have the latest version.

Manual Installation

  1. Go to Releases
  2. Download main.js, manifest.json, and styles.css
  3. Create folder: {VaultFolder}/.obsidian/plugins/nexus-properties/
  4. Move downloaded files into the folder
  5. Reload Obsidian (Ctrl/Cmd + R)
  6. Enable Nexus Properties in Settings → Community Plugins

Mobile Support

Nexus Properties is fully optimized for mobile devices with touch-friendly interfaces, responsive layouts, and gesture support.

See the Mobile Support Documentation for details.


Key Features

Bidirectional Sync

Set relationships in one direction, the reverse syncs automatically. Supports parent-child hierarchies and related connections. Automatic cleanup on file deletion, rename, or relationship removal.

Interactive Graph Views

Visualize relationships with Hierarchical (trees), Related (direct connections), and All Related (constellations) modes. Includes depth control, zoom preview, tooltips, search, and context menus.

Smart Node Creation

Create child, parent, or related nodes with a single command. New nodes inherit frontmatter, get unique Zettel IDs, and establish bidirectional relationships automatically.

Color Rules

JavaScript expression-based color rules for visual categorization. First match wins, with enable/disable toggles and priority ordering.

Filtering

JavaScript expression filtering with named presets, multi-expression AND logic, and indirect connection preservation. Search by filename/path with real-time highlighting.

Bases View

List-based relationship view with Cards, Table, and List display modes. Custom sorting with YAML formulas, archived filtering, and path-based inclusion rules.

MOC View

Collapsible tree outline with clickable wiki links. Toggle between current file or topmost parent as root. Supports bullet-list hierarchies as an alternative to frontmatter properties.

Frontmatter Propagation

Auto-propagate frontmatter changes to children recursively, with optional confirmation and configurable exclusions.


Support & Sponsorship

If you find Nexus Properties useful and want to support its ongoing development, please consider becoming a sponsor. Your contribution helps ensure continuous maintenance, bug fixes, and the introduction of new features.

Every contribution, no matter the size, is greatly appreciated!


License

AGPL-3.0. Versions before v2.0.0 were MIT.

Contributing

PRs welcome! Contributions are licensed under AGPL-3.0. See Contributing Guide for details.


Credits

Built with Cytoscape.js for graph rendering, including hierarchical layouts (via Dagre) and constellation network views.

Extension points exported contracts — how you extend this code

SettingsSection (Interface)
(no doc) [7 implementers]
src/components/settings/types.ts
Command (Interface)
(no doc) [12 implementers]
shared/commands/command.ts
HierarchyStrategy (Interface)
(no doc) [5 implementers]
src/core/hierarchy/hierarchy-strategy.ts
RelationshipResolver (Interface)
(no doc) [2 implementers]
src/types/hierarchy.ts
RelationshipContext (Interface)
(no doc)
src/utils/relationship-context.ts
ActionDef (Interface)
(no doc)
shared/api-gateway/types.ts
WhatsNewModalConfig (Interface)
(no doc)
shared/components/whats-new-modal.ts
NormalizePropertyOptions (Interface)
(no doc)
shared/core/frontmatter-value.ts

Core symbols most depended-on inside this repo

cls
called by 256
shared/core/css-utils.ts
setName
called by 42
tests/mocks/obsidian.ts
parseMocContent
called by 39
src/utils/moc-parser.ts
updateSettings
called by 37
shared/settings/settings-store.ts
stripParentPrefix
called by 31
src/utils/string-utils.ts
execute
called by 30
shared/commands/command.ts
buildGraph
called by 27
src/core/graph-builder.ts
setDesc
called by 23
tests/mocks/obsidian.ts

Shape

Method 649
Function 275
Class 174
Interface 88

Languages

TypeScript98%
Python2%

Modules by API surface

src/components/views/relationship-graph-view.ts49 symbols
src/components/views/nexus-view-switcher.ts37 symbols
tests/mocks/obsidian.ts36 symbols
shared/testing/mocks/obsidian.ts35 symbols
shared/settings/settings-ui-builder.ts29 symbols
src/components/graph/interaction-handler.ts28 symbols
src/core/graph-builder.ts27 symbols
src/components/views/bases-view.ts26 symbols
shared/file/file.ts25 symbols
src/components/views/moc-view.ts24 symbols
src/components/layout/graph-layout-manager.ts24 symbols
src/core/properties-manager.ts20 symbols

For agents

$ claude mcp add Nexus-Properties \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page