Configuration Guide

Settings: configure AI vendors, models, and local providers

Theme Customization

  • Mode -- Light / Dark / System
  • Accent colors -- Custom primary, secondary, tertiary colors
  • Gradient effects -- Toggle gradient UI effects
  • Background -- Custom app and editor background colors

AI Model Configuration

Supported Vendors

Vendor / AgentDescription
AnthropicClaude models, native SDK integration
OpenAIGPT models, native SDK integration
GeminiGoogle Gemini via OpenAI-compatible endpoint
DeepSeekAnthropic-compatible endpoint
QwenAlibaba Qwen via Anthropic-compatible endpoint
MiniMaxOpenAI-compatible endpoint
ZhipuZhipu AI via OpenAI-compatible endpoint
KimiMoonshot Kimi via OpenAI-compatible endpoint
OllamaLocal OpenAI-compatible endpoint, API key optional
CustomCustom Anthropic-compatible endpoint
Claude Code / CodexReuse local CLI Agent configuration

Setup Steps

  1. Go to Settings -> AI
  2. Select a vendor
  3. Enter API key (not needed for Ollama)
  4. Optional: custom Base URL
  5. Choose default model

AI Subpages

Under Settings → AI Assistant, Aino also has subpages for safety, context, and tools:

SubpagePurpose
ProvidersConfigure answer models, API keys, Base URLs, and CLI Agents
Voice (Experimental)Enable voice conversation and configure speech providers and the global shortcut
ToolsConfigure interface control, HTTP Server, and MCP servers
Theme SearchConfigure AI search scope in PARA theme notes
PromptConfigure the vault's prompt folder

Skills live under Settings → Skills Management; apps live under Settings → AI Apps.

The Agent requests authorization in chat when it first needs interface control. You can also enable Always allow AI to control the current interface under Settings → AI Assistant → Tools after confirming the aino-desktop-automation Skill.

Calendar Integration

CalDAV

Supports standard CalDAV protocol:

  • iCloud Calendar
  • Nextcloud
  • Other CalDAV servers

Google Calendar

Connect Google Calendar via OAuth authorization for two-way sync.

Vault Sync

Aino can sync the same Markdown vault through S3-compatible object storage or WebDAV. Start with Sync Your Aino Vault if you want desktop and mobile to share one vault. English-speaking users should usually start with Koofr WebDAV; advanced users can use Cloudflare R2, Backblaze B2, Tigris, AWS S3, or another S3-compatible bucket.

Keyboard Shortcuts

Aino LifeOS supports fully customizable keyboard shortcuts. Go to Settings -> Shortcuts to view and modify.

The file tree uses standard system shortcuts by default: Cmd + C, Cmd + X, and Cmd + V on macOS; Ctrl + C, Ctrl + X, and Ctrl + V on Windows and Linux. To delete a file or folder, use Cmd + Delete on macOS or Ctrl + Delete on Windows and Linux. Select an item in the tree before using the shortcut; the existing deletion confirmation still appears. Cut items appear translucent, and Esc cancels the cut. Copies can be pasted repeatedly, including across the Files tree, PARA trees, and sidebar file entries.

The context menu also includes Copy Content, Copy Path, Copy Relative Path, Reveal in System Explorer, and Open with Default App. Other than Copy, Cut, Paste, and Delete, file-tree actions have no shortcut by default and can be configured under Settings -> Shortcuts -> File Tree.

File-tree context menu and platform shortcuts

File-tree shortcut settings

MCP Servers

Configure MCP servers in:

// ~/.claude/mcp.json or <vault>/.mcp.json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "server-package"]
    }
  }
}

User-level Claude / Codex MCP servers are not exposed to ordinary models by default. Enable Global MCP servers in Settings → AI Assistant → MCP when you want Aino to load them.

Voice Conversation

Voice conversation is off by default. For activation and provider setup, see Voice Conversation.