Docs
Settings Reference
All Mioru settings explained. Settings are stored in ~/.config/mira/settings.json and never leave your machine.
General
| Setting | Description | Default |
|---|
| Notes Directory | Where your .md files live. Supports native folder picker on all platforms. | ~/mira-notes/ |
| Language | UI language — English or German | System default |
| Default Mode | Open notes in Read mode by default (safer for AI edits) | On |
AI Providers
| Setting | Description |
|---|
| ChatGPT Sign-in | Sign in with your ChatGPT account (OAuth). No API key needed. |
| Anthropic API Key | Your Claude API key (sk-ant-...) from console.anthropic.com |
| OpenAI API Key | For voice transcription via Whisper (sk-...) |
| Tavily API Key | For web search in AI chat (tvly-...). 1,000 searches/month free. |
AI Models
| Setting | Description | Default |
|---|
| Chat Model | Which model powers the AI chat panel | Provider default |
| Search Model | Which model powers Ctrl+K AI search | Faster/cheaper model |
Voice
| Setting | Description |
|---|
| Voice Mode | Enable the floating Voice Mode bubble Beta |
| Voice Input | Show the microphone button in chat for voice transcription |
Export
| Setting | Description |
|---|
| Script Export Directory | Where code blocks are saved as script files. Supports native folder picker. |
| Custom PDF Export Path | Override the default PDF output location |
System
| Setting | Description |
|---|
| AI Debug Details | Show expandable error details in chat when AI file actions fail |
| MCP Integration | Configure Mioru as an MCP server for external AI agents |
Note: Changing the Notes Directory reloads settings and the project list immediately. The previous selected note is cleared so the UI reflects the new vault.