Human Thinks Here, Agent Acts There.
MindOS
Human Thinks Here, Agent Acts There.
English | 中文
MindOS is a Human-AI Collaborative Mind System—a local-first knowledge base that ensures your notes, workflows, and personal context are both human-readable and directly executable by Agents. One shared memory layer for all Agents — auditable, correctable, and smarter with every use.
<source media="(prefers-color-scheme: dark)" srcset="assets/images/demo-flow-dark.png" />
<source media="(prefers-color-scheme: light)" srcset="assets/images/demo-flow-light.png" />
[!IMPORTANT] ⭐ One-click install: Send this to your Agent (Claude Code, Cursor, etc.) to set up everything automatically:
Help me install MindOS from https://github.com/GeminiLight/MindOS with MCP and Skills. Use English template.✨ Try it now: After installation, give these a try:
Read my MindOS knowledge base, see what's inside, then help me write my self-introduction into Profile.Help me distill the experience from this conversation into MindOS as a reusable SOP.Help me execute the XXX SOP from MindOS.
🧠 Human-AI Shared Mind
No more fragmented memory, no more black-box behavior, no more lost experience.
1. Global Sync — Breaking Memory Silos
Each Agent keeps its own memory — switching tools means manually hauling context. MindOS lets all Agents share one knowledge base via MCP and Skills — record once, reuse everywhere.
2. Transparent & Controllable — No More Black Boxes
What did your Agent remember? Is it even correct? You have no way to know. MindOS saves every read/write as local plain text — humans can audit, correct, and delete in the GUI.
3. Symbiotic Evolution — Experience Flows Back as Instructions
All that experience from your conversations — gone the moment you close the window. MindOS auto-distills conversation experience into Skills/SOPs. Notes are instructions. The knowledge base gets better with use.
Foundation: Local-first by default — all data stays in local plain text for privacy, ownership, and speed.
✨ Features
For Humans
- GUI Workbench: browse, edit, search notes with unified search + AI entry (
⌘K/⌘/), designed for human-AI co-creation. - Built-in Agent Assistant: converse with the knowledge base in context; edits seamlessly capture human-curated knowledge.
- Plugin Extensions: multiple built-in renderer plugins — TODO Board, CSV Views, Wiki Graph, Timeline, Agent Inspector, and more.
For Agents
- MCP Server + Skills: stdio + HTTP dual transport, full-lineup Agent compatible (OpenClaw, Claude Code, Cursor, etc.). Zero-config access.
- Structured Templates: pre-set directory structures for Profiles, Workflows, Configurations, etc., to jumpstart personal context.
- Agent-Ready Docs: everyday notes naturally double as high-quality executable Agent commands — no format conversion needed, write and dispatch.
Infrastructure
- Security: Bearer Token auth, path sandboxing, INSTRUCTION.md write-protection, atomic writes.
- Knowledge Graph: dynamically parses and visualizes inter-file references and dependencies.
- Git Time Machine: Git auto-sync (commit/push/pull), records every edit by both humans and Agents. One-click rollback, cross-device sync.
Coming Soon
- ACP (Agent Communication Protocol): connect external Agents (e.g., Claude Code, Cursor) and turn the knowledge base into a multi-Agent collaboration hub
- Deep RAG integration: retrieval-augmented generation grounded in your knowledge base for more accurate, context-aware AI responses
- Backlinks View: display all files that reference the current file, helping you understand how a note fits into the knowledge network
- Agent Inspector: render Agent operation logs as a filterable timeline to audit every tool call in detail
🚀 Get
Tools (2)
read_knowledgeRead content from the local knowledge base.write_knowledgeWrite or update content in the local knowledge base.Configuration
{"mcpServers": {"mindos": {"command": "npx", "args": ["-y", "@geminilight/mindos"]}}}