Files you own. Memory your agents can trust. Also: your AI won't gaslight you about what's in your own notes anymore.
View on GitHub ↗Files you own. Memory your agents can trust.
NexusOS is a local-first knowledge operating system for AI agents. It turns ordinary folders of Markdown and text files into a structured, searchable memory layer exposed through a CLI and Model Context Protocol server.
Your source files remain the system of record. NexusOS builds disposable derived state inside .nexusos/, then gives humans and agents deterministic tools to search, browse, read, inspect links, assemble context, and verify workspace health.
[!IMPORTANT] NexusOS v0.1.0 is the first stable release. The planned v0.1 core feature scope, release hardening, packaging validation, cross-platform proof, security review, and public contract freeze are complete. See the release roadmap.
Agent memory should not require surrendering your notes to a proprietary database or trusting an opaque retrieval pipeline.
NexusOS is built around a smaller contract:
- Local first: core workflows require no hosted account or network connection. - Files stay yours: Markdown and text remain readable without NexusOS. - Deterministic retrieval: SQLite FTS5, stable IDs, source paths, and line ranges make results inspectable. - Agent native: the same service layer powers the CLI and MCP tools. - Read-only by default: retrieval never edits source documents. - Rebuildable state: the index can be deleted and regenerated from source files.
- safe workspace initialization with blank and starter templates - path boundaries, deny paths, nested-workspace protection, and doctor checks - deterministic Markdown and plain-text indexing into SQLite wit
From the project README.
Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:
[](https://mcp.liqiwa.com/s/asimons81--nexusos.html)
Turn scattered notes, docs and transcripts into a queryable Markdown wiki — an LLM knowledge-base compiler with MCP access, no embeddings, self-hosted.
ozankasikci/global-agent-memoryLocal-first, project-aware memory MCP server for Claude Code, Codex, and other AI agents, with Obsidian and an owner dashboard.
2672243194/agentbrainLocal-first long-term memory for AI agents - plain Markdown vault + thin MCP server. CJK-aware BM25, token-efficient by design.
do-md/homekbLocal-first personal Markdown knowledge base with semantic search, AI Q&A, MCP, desktop/web clients, and a self-hostable zero-data-at-rest relay.
menot-you/n-memoryMemory your agent can trust — every answer carries its source; when it doesn't know, it says so. Hermetic, local, MCP.
Smitner-Studio/facetRender agent-written Markdown as a live local page, and send the human's click back to the agent as typed data. Human-in-the-loop approval gates for coding agents.
The top new MCP servers of the week, every Monday. No spam, unsubscribe anytime.