MioruDOCS
  WebsiteWebseite
Mioru documentation

Your knowledge,
in motion.

Mioru combines local Markdown notes with a project-aware agent and Time Anchors. This guide explains the ideas that matter, without turning the product into a manual you have to study first.

Start here Understand the agent
Mioru Dokumentation

Dein Wissen,
in Bewegung.

Mioru verbindet lokale Markdown-Notizen mit einem projektbewussten Agenten und Zeitankern. Diese Doku erklärt, was wichtig ist – ohne aus dem Produkt ein Handbuch zu machen, das du zuerst studieren musst.

Hier starten Den Agenten verstehen

No section matches your search.Kein Abschnitt passt zu deiner Suche.

Getting started

Mioru is in active beta for Windows, Linux, and Android. macOS is planned. There is no Mioru account: your vault and your provider settings are the starting point.

Open or create a vault

Choose a local folder. Existing Markdown files remain normal files and can be opened with other tools.

Create a project and its brief

Projects group related notes. A short Project Brief gives the agent stable goals and background.

Connect an AI provider

Use ChatGPT sign-in or your own Anthropic/OpenAI API key. Basic writing and reading remain available without AI.

Optional: connect Android

Enable Nextcloud/WebDAV sync if you want the same notes, assets, and Time Anchors on multiple devices.

Beta note: Screens and labels can still move while Mioru is being refined. This documentation follows capabilities rather than short-lived version numbers.

Erste Schritte

Mioru ist in aktiver Beta für Windows, Linux und Android. macOS ist geplant. Es gibt kein Mioru-Konto: Dein Vault und deine Provider-Einstellungen sind der Ausgangspunkt.

Vault öffnen oder erstellen

Wähle einen lokalen Ordner. Vorhandene Markdown-Dateien bleiben normale Dateien und lassen sich weiterhin mit anderen Werkzeugen öffnen.

Projekt und Projektbrief anlegen

Projekte bündeln zusammengehörige Notizen. Ein kurzer Projektbrief gibt dem Agenten stabile Ziele und Hintergrund.

KI-Provider verbinden

Nutze die ChatGPT-Anmeldung oder deinen eigenen Anthropic-/OpenAI-API-Key. Schreiben und Lesen funktionieren weiterhin ohne KI.

Optional: Android verbinden

Aktiviere Nextcloud/WebDAV-Sync, wenn du dieselben Notizen, Assets und Zeitanker auf mehreren Geräten möchtest.

Hinweis zur Beta: Oberflächen und Bezeichnungen können sich noch verschieben. Diese Doku beschreibt deshalb Fähigkeiten statt kurzlebiger Versionsnummern.

Notes and projects

The vault is a folder of Markdown files, not a proprietary database. Folders become projects; notes, images, and attachments stay portable.

Plain Markdown

Edit in Mioru or another Markdown tool. Your files remain readable without Mioru.

Projects

Use nested folders and a Project Brief to keep goals, decisions, and context together.

History

Changes are recorded so agent edits remain reviewable and recoverable.

Assets

Images and attachments live alongside the knowledge they belong to.

Read and edit

Read mode gives you a calm rendered view; Edit mode opens the Markdown source. Use Ctrl + E to switch. A Home Note can act as the entry point to your vault.

Notizen und Projekte

Der Vault ist ein Ordner mit Markdown-Dateien, keine proprietäre Datenbank. Ordner werden zu Projekten; Notizen, Bilder und Anhänge bleiben portabel.

Einfaches Markdown

Bearbeite es in Mioru oder einem anderen Markdown-Werkzeug. Deine Dateien bleiben auch ohne Mioru lesbar.

Projekte

Nutze verschachtelte Ordner und einen Projektbrief, um Ziele, Entscheidungen und Kontext zusammenzuhalten.

Verlauf

Änderungen werden festgehalten, damit Agenten-Edits überprüfbar und wiederherstellbar bleiben.

Assets

Bilder und Anhänge liegen beim Wissen, zu dem sie gehören.

Lesen und bearbeiten

Der Lesemodus zeigt eine ruhige, gerenderte Ansicht; im Bearbeitungsmodus siehst du das Markdown. Mit Ctrl + E wechselst du. Eine Home-Notiz kann als Einstieg in deinen Vault dienen.

The agent inside your notes

Mioru is not a detached chatbot. The agent starts from where you are working and can gather more context only when the task calls for it.

Note ChatWorks with the open note, its attachments, and the surrounding project.
Vault ChatSearches and works across notes and projects when the task spans your knowledge space.
Agent toolsReads, searches, creates, edits, moves, and organizes content instead of only suggesting text.
Agent TimelineShows the steps, sources, and actions behind the result while Mioru works.

Context without sending everything

The current note and Project Brief form the stable starting context. Relevant parts of the vault can be loaded on demand. Mioru does not need to send your entire vault with every request.

You remain the decision point. Sensitive actions and agent-proposed Time Anchor changes are shown for confirmation before they are executed. If a run stops or reaches a limit, Mioru says so instead of presenting an incomplete result as finished.

Der Agent in deinen Notizen

Mioru ist kein losgelöster Chatbot. Der Agent startet dort, wo du arbeitest, und holt weiteren Kontext nur dann, wenn die Aufgabe ihn braucht.

Notiz-ChatArbeitet mit der geöffneten Notiz, ihren Anhängen und dem umgebenden Projekt.
Vault ChatSucht und arbeitet über Notizen und Projekte hinweg, wenn eine Aufgabe den ganzen Wissensraum betrifft.
Agenten-WerkzeugeLiest, sucht, erstellt, bearbeitet, verschiebt und organisiert Inhalte, statt nur Text vorzuschlagen.
Agent-TimelineZeigt Schritte, Quellen und Aktionen hinter dem Ergebnis, während Mioru arbeitet.

Kontext, ohne alles zu senden

Die aktuelle Notiz und der Projektbrief bilden den stabilen Ausgangskontext. Relevante Teile des Vaults können gezielt nachgeladen werden. Mioru muss nicht bei jeder Anfrage den gesamten Vault senden.

Du bleibst der Entscheidungspunkt. Sensible Aktionen und vom Agenten vorgeschlagene Zeitanker-Änderungen werden vor der Ausführung zur Bestätigung gezeigt. Wenn ein Lauf stoppt oder an eine Grenze kommt, sagt Mioru das offen, statt ein unvollständiges Ergebnis als fertig auszugeben.

Time Anchors

A Time Anchor connects a moment to a note or project. When it becomes due, the reminder takes you back to the knowledge it belongs to.

Connected

Attach it to a note, a project page, or the vault rather than creating an isolated reminder.

Full lifecycle

Create, edit, reschedule, snooze, complete, reopen, archive, relink, or delete.

Synced

Time Anchors converge across devices through the same optional WebDAV sync.

Agent-assisted

The agent can prepare actions, but waits for your confirmation before changing a Time Anchor.

Android notifications

Android can deliver due Time Anchors as system notifications even while Mioru is closed. Notification permission is required. Precise timing is a separate, optional “Alarms & reminders” access; without it, reminders still work but Android may delay them.

Never early: approximate Android scheduling does not fire before the planned time, but battery and standby restrictions can postpone delivery.

Zeitanker

Ein Zeitanker verbindet einen Zeitpunkt mit einer Notiz oder einem Projekt. Wenn er fällig wird, bringt die Erinnerung dich zum Wissen zurück, zu dem sie gehört.

Verbunden

Hänge ihn an eine Notiz, eine Projektseite oder den Vault, statt eine losgelöste Erinnerung zu erstellen.

Kompletter Lebenszyklus

Erstellen, bearbeiten, neu planen, schlummern, erledigen, wieder öffnen, archivieren, neu verknüpfen oder löschen.

Synchronisiert

Zeitanker gleichen sich über denselben optionalen WebDAV-Sync zwischen Geräten ab.

Mit Agent

Der Agent kann Aktionen vorbereiten, wartet aber vor jeder Zeitanker-Änderung auf deine Bestätigung.

Benachrichtigungen auf Android

Android kann fällige Zeitanker als Systembenachrichtigung anzeigen, auch wenn Mioru geschlossen ist. Dafür braucht es die Benachrichtigungs-Erlaubnis. Minutengenaue Planung ist ein separater, freiwilliger Zugriff «Wecker und Erinnerungen»; ohne ihn funktionieren Erinnerungen weiter, können von Android aber verzögert werden.

Nie zu früh: Die ungefähre Android-Planung löst nicht vor dem vorgesehenen Zeitpunkt aus, Akku- und Standby-Regeln können die Zustellung aber verschieben.

Capture and voice

Ideas rarely arrive in perfect form. Mioru gives you fast ways to catch them first and organize them later.

Quick NoteCtrl + N creates a date-named note in the current project.
Text captureCtrl + Shift + T opens the thought capture overlay and saves into Gedankenspeicher.
Voice captureCtrl + Shift + G records and transcribes a thought of up to five minutes.
Voice ModeA beta spoken conversation surface for the current context, opened with Ctrl + Shift + L.

Speech transcription and spoken replies use OpenAI speech services and require a separate OpenAI API key, even if ChatGPT or Anthropic is your chat provider.

Erfassen und Sprache

Ideen kommen selten in perfekter Form. Mioru gibt dir schnelle Wege, sie zuerst festzuhalten und später zu ordnen.

Schnelle NotizCtrl + N erstellt eine datierte Notiz im aktuellen Projekt.
Text erfassenCtrl + Shift + T öffnet die Gedankenerfassung und speichert in den Gedankenspeicher.
Sprache erfassenCtrl + Shift + G nimmt einen Gedanken bis zu fünf Minuten auf und transkribiert ihn.
Voice ModeEine Beta-Oberfläche für ein gesprochenes Gespräch im aktuellen Kontext, geöffnet mit Ctrl + Shift + L.

Transkription und gesprochene Antworten nutzen OpenAI-Sprachdienste und brauchen einen separaten OpenAI-API-Key – auch wenn ChatGPT oder Anthropic dein Chat-Provider ist.

Android and sync

The Android app is a full companion for the same knowledge space: browse and edit notes, talk to the agent, capture thoughts, and manage Time Anchors.

Nextcloud / WebDAV

Sync is optional and under your control. Add the Nextcloud URL, username, an app password, and the remote folder in Settings. Mioru then synchronizes notes, assets, and Time Anchor data through your WebDAV storage.

Local firstEach device continues to work with its local vault.
Your serverMioru does not operate a sync cloud; credentials connect the app directly to your WebDAV service.
ConflictsKeep devices synced regularly and review conflict copies instead of silently overwriting diverging notes.

Android und Sync

Die Android-App ist ein vollständiger Begleiter für denselben Wissensraum: Notizen lesen und bearbeiten, mit dem Agenten arbeiten, Gedanken erfassen und Zeitanker verwalten.

Nextcloud / WebDAV

Sync ist optional und bleibt unter deiner Kontrolle. Hinterlege Nextcloud-URL, Benutzername, ein App-Passwort und den Remote-Ordner in den Einstellungen. Mioru synchronisiert danach Notizen, Assets und Zeitanker-Daten über deinen WebDAV-Speicher.

Local firstJedes Gerät arbeitet weiterhin mit seinem lokalen Vault.
Dein ServerMioru betreibt keine Sync-Cloud; die Zugangsdaten verbinden die App direkt mit deinem WebDAV-Dienst.
KonflikteSynchronisiere Geräte regelmässig und prüfe Konfliktkopien, statt auseinanderlaufende Notizen still zu überschreiben.

Bring your own AI

Mioru does not bundle an AI subscription. Choose the connection that fits you and keep the provider relationship in your hands.

ChatGPT sign-in

Use an eligible ChatGPT subscription directly without adding a chat API key.

Anthropic API

Connect your own Anthropic API key and select from the models Mioru currently supports.

OpenAI API

Use an OpenAI API key as the agent provider. A key is also used separately for speech services.

Tavily

An optional key enables explicit Web Search. It is not required for local notes or vault search.

Costs: Provider subscriptions and API usage are billed by the provider, not by Mioru. Check the provider's current terms and pricing before use.

Bring deine eigene KI mit

Mioru bündelt kein KI-Abo. Wähle die Verbindung, die zu dir passt, und behalte die Provider-Beziehung selbst in der Hand.

ChatGPT-Anmeldung

Nutze ein geeignetes ChatGPT-Abo direkt, ohne einen Chat-API-Key zu hinterlegen.

Anthropic API

Verbinde deinen eigenen Anthropic-API-Key und wähle aus den aktuell von Mioru unterstützten Modellen.

OpenAI API

Nutze einen OpenAI-API-Key als Agenten-Provider. Ein Key wird ausserdem separat für Sprachdienste verwendet.

Tavily

Ein optionaler Key ermöglicht ausdrückliche Web-Suchen. Für lokale Notizen und die Vault-Suche ist er nicht nötig.

Kosten: Provider-Abos und API-Nutzung werden vom Provider verrechnet, nicht von Mioru. Prüfe vor der Nutzung dessen aktuelle Bedingungen und Preise.

MCP for external agents

The Model Context Protocol lets compatible tools work with your Mioru vault. It is an advanced integration, separate from Mioru's built-in agent.

Enable MCP in Mioru

Open the MCP area in Settings and let Mioru prepare its local server configuration.

Choose a client

Connect a compatible desktop agent or development tool through the local stdio transport shown by Mioru.

Review permissions

An MCP client can receive powerful note-management tools. Only connect software you trust and inspect its requested actions.

What clients can do

Depending on the exposed tool and your request, clients can search, read, create, update, move, and organize notes or projects. Your Markdown vault remains the source of truth.

Security boundary: MCP is local access for another program running under your user account. It does not make the vault public, but it does grant the connected client meaningful power over your files.

MCP für externe Agenten

Das Model Context Protocol lässt kompatible Werkzeuge mit deinem Mioru-Vault arbeiten. Es ist eine fortgeschrittene Integration, getrennt vom eingebauten Mioru-Agenten.

MCP in Mioru aktivieren

Öffne den MCP-Bereich in den Einstellungen und lass Mioru die lokale Server-Konfiguration vorbereiten.

Client auswählen

Verbinde einen kompatiblen Desktop-Agenten oder ein Entwicklungswerkzeug über den von Mioru angezeigten lokalen stdio-Transport.

Berechtigungen prüfen

Ein MCP-Client kann mächtige Werkzeuge zur Notizverwaltung erhalten. Verbinde nur Software, der du vertraust, und prüfe ihre Aktionen.

Was Clients tun können

Je nach freigegebenem Werkzeug und deiner Anfrage können Clients Notizen oder Projekte suchen, lesen, erstellen, bearbeiten, verschieben und organisieren. Dein Markdown-Vault bleibt die Quelle der Wahrheit.

Sicherheitsgrenze: MCP ist lokaler Zugriff für ein anderes Programm unter deinem Benutzerkonto. Der Vault wird dadurch nicht öffentlich, aber der verbundene Client erhält bedeutende Macht über deine Dateien.

Keyboard shortcuts

The shortcuts below describe the current desktop workflow. On macOS, supported shortcuts use the platform command modifier when the app becomes available.

Command paletteCtrl + K
Quick NoteCtrl + N
Read / EditCtrl + E
Home NoteCtrl + H
Toggle sidebarCtrl + B
Note ChatCtrl + Shift + C
Vault ChatCtrl + Shift + V
Chat voice inputCtrl + Shift + M
Text captureCtrl + Shift + T
Voice captureCtrl + Shift + G
Voice ModeCtrl + Shift + L

Tastaturkürzel

Die Kürzel unten beschreiben den aktuellen Desktop-Ablauf. Auf macOS verwenden unterstützte Kürzel den plattformüblichen Command-Modifikator, sobald die App verfügbar ist.

Kommando-PaletteCtrl + K
Schnelle NotizCtrl + N
Lesen / BearbeitenCtrl + E
Home-NotizCtrl + H
Sidebar ein/ausCtrl + B
Notiz-ChatCtrl + Shift + C
Vault ChatCtrl + Shift + V
Sprache im ChatCtrl + Shift + M
Text erfassenCtrl + Shift + T
Sprache erfassenCtrl + Shift + G
Voice ModeCtrl + Shift + L

Settings and privacy

Mioru has no account, telemetry, or storage cloud of its own. The app keeps notes locally and connects directly to services you configure.

AISelect the chat provider and model. API keys are stored in the app's local settings.
VoiceConfigure speech-to-text, spoken replies, and Voice Mode independently from the chat provider.
SyncEnable or disable Nextcloud/WebDAV and choose the remote path.
SystemControl notifications, Time Anchor timing, appearance, and platform behavior.
DebugInspect AI, audio, sync, Time Anchor, and vault-index diagnostics when something goes wrong.

What leaves your device?

Without AI or sync, your notes stay on the device. When you use AI, relevant content is sent directly to the provider you selected. When sync is enabled, vault data is sent directly to your WebDAV server. Mioru does not receive either transfer.

Einstellungen und Datenschutz

Mioru hat kein eigenes Konto, keine Telemetrie und keine Speicher-Cloud. Die App hält Notizen lokal und verbindet sich direkt mit Diensten, die du einrichtest.

KIWähle Chat-Provider und Modell. API-Keys werden in den lokalen App-Einstellungen gespeichert.
SpracheKonfiguriere Speech-to-Text, gesprochene Antworten und Voice Mode unabhängig vom Chat-Provider.
SyncAktiviere oder deaktiviere Nextcloud/WebDAV und wähle den Remote-Pfad.
SystemSteuere Benachrichtigungen, Zeitanker-Genauigkeit, Darstellung und Plattformverhalten.
DebugPrüfe Diagnosen für KI, Audio, Sync, Zeitanker und Vault-Index, wenn etwas nicht funktioniert.

Was verlässt dein Gerät?

Ohne KI und Sync bleiben deine Notizen auf dem Gerät. Bei KI-Nutzung werden relevante Inhalte direkt an den gewählten Provider gesendet. Mit aktiviertem Sync gehen Vault-Daten direkt an deinen WebDAV-Server. Mioru erhält keine dieser Übertragungen.

Frequently asked

The short answers to the questions that matter most.

Can I use Mioru without AI?

Yes. Notes, projects, reading, editing, and local file organization do not require an AI provider. Agent, AI search, transcription, and spoken features require the corresponding service.

Does Mioru upload my entire vault?

No. Mioru starts with the current note and project context and loads relevant vault content when needed. Content used by an AI feature goes directly to your configured provider.

Do Time Anchors work while Android is closed?

Yes, after Android notification permission is granted. Precise alarms are optional; without that extra access, the operating system may deliver reminders later.

Is Nextcloud required?

No. Mioru is local-first. Nextcloud/WebDAV is only needed if you want Mioru-managed sync between devices.

What if the agent changes the wrong note?

Agent work is visible in the timeline and note changes are recorded in history. Review the affected note and restore an earlier state when necessary.

Where do I report a beta problem?

Use the contact channel through which you received the beta, or email [email protected]. Include the platform, what you expected, what happened, and relevant Debug diagnostics.

Häufig gefragt

Die kurzen Antworten auf die wichtigsten Fragen.

Kann ich Mioru ohne KI verwenden?

Ja. Notizen, Projekte, Lesen, Bearbeiten und lokale Dateiorganisation brauchen keinen KI-Provider. Agent, KI-Suche, Transkription und gesprochene Funktionen benötigen den jeweiligen Dienst.

Lädt Mioru meinen gesamten Vault hoch?

Nein. Mioru startet mit aktueller Notiz und Projektkontext und lädt relevante Vault-Inhalte bei Bedarf. Inhalte einer KI-Funktion gehen direkt an deinen konfigurierten Provider.

Funktionieren Zeitanker, wenn Android geschlossen ist?

Ja, nachdem die Android-Benachrichtigungs-Erlaubnis erteilt wurde. Minutengenaue Alarme sind optional; ohne diesen zusätzlichen Zugriff kann das Betriebssystem Erinnerungen später zustellen.

Ist Nextcloud Pflicht?

Nein. Mioru ist local-first. Nextcloud/WebDAV brauchst du nur, wenn Mioru zwischen Geräten synchronisieren soll.

Was, wenn der Agent die falsche Notiz ändert?

Agenten-Arbeit ist in der Timeline sichtbar und Notizänderungen werden im Verlauf festgehalten. Prüfe die betroffene Notiz und stelle bei Bedarf einen früheren Stand wieder her.

Wo melde ich ein Beta-Problem?

Nutze den Kontaktkanal, über den du die Beta erhalten hast, oder schreibe an [email protected]. Nenne Plattform, Erwartung, tatsächliches Verhalten und passende Debug-Diagnosen.