File Structure
Mioru stores everything as plain Markdown files. No database, no proprietary format.
Vault Layout
~/mira-notes/ # Your notes directory (configurable)
├── _home.md # Home Note (Ctrl+H) — optional
├── _aliases.md # Alias definitions for AI — optional
├── personal/
│ ├── .project.md # AI context for this folder (optional)
│ ├── Journal.md
│ └── Ideas.md
├── work/
│ ├── projects/
│ │ └── Project-X.md
│ └── Meeting-Notes.md
└── Quick Note.mdSpecial Files
| File | Purpose |
|---|---|
_home.md | Your dashboard / start page. Opens on launch and with Ctrl + H. |
_aliases.md | Short aliases for the AI (e.g. todo: work/Todos.md). Lets you reference notes by nickname. |
.project.md | Per-folder AI context. The AI reads this to understand what the project is about. |
Hidden Folders
| Folder | Purpose |
|---|---|
.history/ | Automatic version backups before AI edits. Every AI change is saved here for rollback. |
.trash/ | Deleted notes go here first. Recoverable until you empty it. |
.assets/ | Images and embedded files for each note. Created per-note (e.g. MyNote.assets/). |
Gedankenspeicher/ | Dedicated folder for captured thoughts. Managed automatically by the Gedankenspeicher feature. |
Vault Index
Mioru maintains a Vault Index — a metadata index of all your notes including titles, summaries, and modification dates. This powers:
- Ctrl+K fuzzy search — instant results across your entire vault
- Sister Notes context — the AI knows what other notes exist in your project
- Sidebar tree — your project and folder structure
The index is self-healing: if a note changes externally (e.g. via cloud sync), Mioru detects it and re-indexes automatically.
Cloud Sync
Mioru works with any cloud sync service:
- Set your Notes Directory inside your Nextcloud / Dropbox / iCloud folder
- Sync happens automatically in the background
- Mioru detects external changes and reloads notes
Conflict handling: If the same note is edited from two places, Mioru keeps both versions. The older one is moved to
.history/.