How to Build a Portable AI OS With Obsidian

TL;DR

Build a portable AI operating system by keeping your notes as local Markdown files in Obsidian, adding maps and manuals that guide AI through them, and treating Claude Cowork as a replaceable external layer. A tool-neutral identity file and vault map help the AI understand your preferences, locate relevant notes, and avoid inaccurately sampling a large knowledge base.

Transcript

This is my AI OS, Obsidian, Claude, and all the pieces that you need to bring them together. By the end of this video, you'll know how I use this system, the actual AI enhanced skills I use, and how you can set up your own system that's both futureproof and works with any AI tool instead of locking you in to Claude, Codex, Gemini, or Frank. Hi, I'm... Read More

Key Insights

• The AI operating system has three layers: a personal Ideaverse, a translation layer containing maps and manuals, and a replaceable external AI tool. This structure keeps the user's ideas and operating instructions independent from Claude, Codex, Gemini, or another future model.
• Obsidian stores a vault as ordinary folders and Markdown text files on the user's computer. Those files can be opened by Obsidian, text editors, development environments, and compatible AI tools, which preserves access even if the original note-taking application disappears.
• The ACE structure organizes notes into Atlas, Calendar, and Efforts. Atlas contains knowledge, ideas, and references, Calendar holds time-based notes such as journals and meetings, and Efforts contains projects, tasks, and other productivity-oriented work.
• Linked notes create visible and mental relationships between ideas. Obsidian represents notes as dots and links as lines in its graph view, while revisiting connected notes can strengthen the user's understanding of how separate concepts relate.
• Claude Cowork works by receiving permission to access a selected folder on the user's computer. Once connected, it can read files, modify content, rename or move items, and create new files without requiring repeated uploads or repeated explanations of the same context.
• The recommended model strategy is to begin with Sonnet for most tasks, use Opus for complex synthesis, deep research, or quality-critical work, and reserve Haiku for lightweight work such as downloading and summarizing articles through the Obsidian Web Clipper.
• The me.md file is a portable identity and collaboration guide for AI. It describes who the user is, how the user thinks, and how an AI should work with them, while a minimal Claude-specific file simply directs Claude to read me.md.
• The vault map is a master table of contents and navigation manual for AI. It directs the model toward relevant notes and collections without scanning an entire vault, reducing the risk that the AI samples only a small selection while implying broader coverage.

Questions & Answers

Q: How do you build a portable AI operating system?

Build the system in three layers. Keep your own thoughts in an Obsidian Ideaverse, create a middle layer of maps and manuals that tells AI how to understand and navigate those thoughts, and connect an external AI tool such as Claude Cowork. Store notes and operating documents as Markdown files so they remain usable with other editors, models, and AI ecosystems.

Q: Why use Obsidian as the foundation of an AI OS?

Obsidian provides a local folder, called a vault, containing individual Markdown text files. This makes the notes readable outside Obsidian through text editors, development environments, and compatible AI tools. The files therefore remain accessible if Obsidian disappears, and the knowledge base can move between different AI applications instead of being confined to one company's ecosystem.

Q: How should an Obsidian vault be organized for this system?

The demonstrated structure uses ACE: Atlas, Calendar, and Efforts. Atlas stores knowledge, ideas, references, and material intended for long-term development. Calendar stores notes anchored to time, including daily notes, journals, and meetings. Efforts stores projects, tasks, and productivity-oriented work. Links between these notes expose relationships and make the system increasingly useful as it grows.

Q: How does Claude Cowork interact with an Obsidian vault?

Claude Cowork connects to a folder that the user explicitly selects and allows. If that folder contains the Obsidian vault, Cowork can see its accessible contents and can read, modify, move, rename, or create files. This removes the need to upload the same documents repeatedly, but it also makes clear instructions and carefully chosen folder access important.

Q: Which Claude model should be used for different tasks?

Sonnet is presented as the best starting point for most general work because it is less intensive and supports more frequent use on a Pro plan. Opus is reserved for complex synthesis, deep research, and work where quality matters most, although it consumes tokens faster. Haiku is used rarely, mainly for simple tasks such as summarizing downloaded articles.

Q: What is the purpose of a me.md file?

A me.md file serves as a portable identity and working guide for any AI. It records who the user is, how the user thinks, and how the AI should collaborate with them. Instead of placing detailed instructions inside a Claude-specific file, the Claude file can contain one instruction directing the application to me.md, preserving portability across tools.

Q: Why does an AI need a vault map for Obsidian?

A vault map tells the AI how to move through the notes and functions as a master table of contents and operating manual. Without it, an AI connected to a large vault may sample only a small portion of the available material while suggesting it reviewed everything. The map directs it toward relevant notes and supports more accurate note creation.

Q: How should AI-generated content be separated from personal notes?

Create an AIOS folder inside the main Ideaverse and use it as a distinct area for AI-related maps, manuals, and generated material. This separation makes AI content easier to identify, isolate, and clear when necessary. It helps preserve a clean distinction between the user's original thinking and material produced or managed through external AI tools.

Summary & Key Takeaways

• The proposed AI operating system has three layers: an Obsidian Ideaverse containing personal thoughts, a translation layer of maps and manuals, and an external AI application such as Claude Cowork. Keeping the foundational files in Markdown makes the system portable because multiple editors and AI tools can read them.

• The Obsidian vault is organized through the ACE structure: Atlas for knowledge and ideas, Calendar for time-based material, and Efforts for projects and tasks. Links between notes reveal relationships through the graph view, while repeated visits to connected notes reinforce those relationships in both the application and the user's thinking.

• Claude Cowork can access an approved computer folder, then read, create, rename, move, and modify files within it. Because an unstructured vault may contain thousands of notes, the AIOS folder provides navigation and operating guidance through files such as me.md and the vault map, while keeping AI-generated content separately identifiable.