What is Flywheel Crank?

Flywheel Crank turns your Obsidian vault into a knowledge graph. It connects to Flywheel Memory's MCP server to surface entity relationships, suggest wikilinks as you type, and give you semantic search across everything you've written. The more you use it, the smarter its suggestions get -- a flywheel that compounds over time.

Screenshots

Features

Search & Discovery

• Semantic search modal -- Hybrid search (BM25 + embeddings) across your entire vault
• Wikilink completions -- Editor completions powered by the entity index and scoring engine
• Inline suggestions -- Context-aware wikilink suggestions as you type

Graph & Connections

• Graph sidebar -- Interactive graph visualization of your vault's link structure
• Connection explorer -- Discover paths and relationships between entities

Entity Intelligence

• Entity browser -- Browse and explore extracted entities across 18 categories
• Entity page -- Deep-dive view for any entity: backlinks, co-occurrence, feedback history
• Batch entity moves -- Individual and bulk entity moves across categories

Vault Analytics

• Vault health -- Diagnostics for orphans, broken links, and vault stats
• Weekly digest -- Summary of vault activity and emerging patterns
• Task dashboard -- Query and visualize tasks across your vault
• Version display -- Crank and server versions shown in Vault Health

Feedback Loop

• Context menu feedback -- Right-click to approve or reject wikilink suggestions
• Status bar pulse -- Live connection status and index freshness indicator
• Auto-reconnect -- Categorized error handling with actionable status bar messages, graph collision resolution, plus a manual reconnect command

Requirements

• Obsidian desktop (not mobile)
• Flywheel Memory MCP server (provides the vault index and entity data)

Note: The MCP server is developed and tested with Claude Code. Other MCP clients may work but are untested.

Installation

Manual install (copy built artifacts to your Obsidian plugins directory):

cd flywheel-crank
npm install
npm run build
cp main.js manifest.json styles.css flywheel.png /path/to/vault/.obsidian/plugins/flywheel-crank/

Then enable "Flywheel Crank" in Obsidian Settings > Community Plugins.

Configuration

In Obsidian Settings > Flywheel Crank you can configure:

• MCP server path -- Path to the flywheel-memory server binary
• Feature toggles -- Enable/disable individual views (graph sidebar, inline suggestions, etc.)
• Exclude folders -- Folders to skip during indexing

Development

npm install
npm run dev    # watch mode (rebuilds on change)
npm run build  # production build
npm run lint   # type check
npm test       # run vitest suite

Part of the Flywheel ecosystem. Powered by Flywheel Memory.

Apache 2.0 -- see LICENSE for details.