Welcome to Hypermnesic

[leonardsellem]

Hypermnesic is git-first memory for AI agents.

The core idea is simple:

• Markdown files are the source of truth.
• The retrieval index is disposable and rebuildable.
• Every write is a reviewable Git commit.
• One OAuth MCP endpoint can serve multiple clients.

Start here:

• README and quick start: https://github.com/leonardsellem/hypermnesic#quick-start
• Architecture: https://github.com/leonardsellem/hypermnesic/blob/main/ARCHITECTURE.md
• MCP tools: https://github.com/leonardsellem/hypermnesic/blob/main/docs/reference/mcp-tools.md
• CLI reference: https://github.com/leonardsellem/hypermnesic/blob/main/docs/reference/cli.md
• Obsidian companion: https://github.com/leonardsellem/hypermnesic-companion
• Benchmarks and caveats: https://github.com/leonardsellem/hypermnesic/blob/main/harness/BENCHMARKS.md

Good places to contribute:

• Setup friction and docs polish.
• MCP client compatibility reports.
• Obsidian companion UX feedback.
• Small issues labeled good first issue.
• Reproducible bugs with exact commands, config shape, and client name.

Please do not post secrets, bearer tokens, private vault content, or private hostnames. If you need to report a vulnerability, use the process in SECURITY.md instead of a public discussion.