flywheel-gravity

Three files that turn any Obsidian vault into a gravity basin.

What is a gravity basin?

Not a folder. Not a second brain. A compressed, reality-filtered context field that any AI must step into before it is allowed to reason about you. Second brain with receipts — every load returns a [[manifest]] of what gravity was applied.

Quickstart

1. Clone this repo.
2. Drop GRAVITY_CONSTITUTION.md, BASIN_PROTOCOL.md, and NUCLEI_INDEX.md into your Obsidian vault root.
3. Point a GBP-compliant tool (e.g. flywheel-memory) at the vault. Done.

What's in this repo

• GRAVITY_CONSTITUTION.md — the living laws of the basin (template).
• BASIN_PROTOCOL.md — GBP v0.1 spec.
• NUCLEI_INDEX.md — living index of gravity centers (template).
• src/basin-compliance.ts — reference compliance shim. Drop into any MCP server / Obsidian plugin to become GBP v0.1 compliant in ~60 lines. Reference snippet — drop into a TS/Node project to compile. Not a standalone buildable module.

Reference implementation

velvetmonkey/flywheel-memory is the reference GBP-compliant MCP server.

Part of the Flywheel suite

• flywheel-memory — MCP server / indexer
• flywheel-crank — Obsidian plugin
• flywheel-concept — theory + benchmarks
• flywheel-gravity (this repo) — the [[protocol]]

Related repositories

Part of the Flywheel suite — local-first knowledge infrastructure over a plain-markdown Obsidian vault:

• vault-core — Shared infrastructure for the Flywheel ecosystem.
• flywheel-memory — Persistent knowledge-graph memory MCP server: semantic search, read, and write over your vault.
• flywheel-crank — Desktop window into your vault's Flywheel MCP server.
• flywheel-gravity (this repo) — A compressed, reality-filtered context field over a vault.
• flywheel-ideas — Local-first decision ledger: falsifiable bets, accepted outcomes, reusable lessons.
• mega-monkey — Telegram-native AI research cockpit over an Obsidian vault.
• roundtable — Local MCP server for delegating tasks to multiple AI models.

Research and experiments:

• flywheel-concept — A falsifiable study of cross-model concept geometry.
• flywheel-geometry — A pre-registered study of cross-domain knowledge retrieval.
• flywheel-universe — Lean 4 / Mathlib-verified core of the descent argument.
• flywheel-velvetgram — Local widescreen Telegram reader for long-form reading.

Verified-cognition demo: mcp-seal (verified MCP approval gate) and canary (the seal demo host).

License

Apache 2.0.