diff --git a/oAI/Resources/oAI.help/Contents/Resources/en.lproj/index.html b/oAI/Resources/oAI.help/Contents/Resources/en.lproj/index.html index dfd00e2..9d32f91 100644 --- a/oAI/Resources/oAI.help/Contents/Resources/en.lproj/index.html +++ b/oAI/Resources/oAI.help/Contents/Resources/en.lproj/index.html @@ -36,6 +36,9 @@
  • Shortcuts (Prompt Templates)
  • Agent Skills (SKILL.md)
  • Anytype Integration
    • +
  • External MCP Servers
    • +
  • Personal Data Tools
    • +
  • Research Agents
  • Bash Execution
  • iCloud Backup
  • Reasoning / Thinking Tokens
    • @@ -49,7 +52,7 @@

    Getting Started

    -

    oAI is a powerful AI chat assistant that connects to multiple AI providers including OpenAI, Anthropic, OpenRouter, and local models via Ollama. The app is available in English, Norwegian BokmΓ₯l, Swedish, Danish, and German β€” it follows your macOS language preference automatically.

    +

    oAI is a powerful AI chat assistant that connects to multiple AI providers including OpenAI, Anthropic, OpenRouter, and local models via Ollama. The app is available in English, Norwegian BokmΓ₯l, Swedish, Danish, German, and French β€” it follows your macOS language preference automatically.

    Quick Start

    @@ -115,6 +118,10 @@
  • 🧠 Thinking β€” models that support reasoning / thinking tokens
    • +
    + Note: On OpenRouter, dedicated image-generation models (e.g. Sourceful, Seedream, Flux) are fetched from OpenRouter's separate images catalog and merged into the picker automatically β€” you don't need to configure anything extra to see them. +
    +

    Sorting

    Click the ↑↓ Sort button to sort the list by:

    -

    Anytype Integration

    @@ -1413,6 +1419,104 @@ Whenever the user asks you to translate something, translate it to Norwegian Bok
    + +
    +

    External MCP Servers

    +

    Connect any external MCP server that speaks the stdio JSON-RPC protocol (for example safaridriver --mcp) and give the AI access to its tools β€” no custom integration code needed.

    + +

    Adding a Server

    +
      +
    1. Press ⌘, to open Settings
      2. +
    2. Go to the MCP tab β†’ External MCP Servers section
      3. +
    3. Click Add Server…
      4. +
    4. Enter a Name (used to prefix its tools, e.g. "Safari" β†’ safari_navigate_to_url), the Command to launch it, and any Arguments
      5. +
    5. Click Add β€” the server starts automatically and its tools are discovered
      6. +
    + +
    + πŸ’‘ Tip: Arguments containing spaces can be quoted, e.g. --root "/Users/you/My Documents". +
    + +

    Server Status

    +

    Each configured server shows a status dot and label:

    + +

    Toggle a server off/on or delete it entirely with the trash icon. Crashed servers automatically restart up to 3 times with increasing delay (5s, 15s, 30s) before giving up.

    + +
    + Note: Tool names from every external server are prefixed with that server's slug (derived from its Name) so they never collide with oAI's built-in tools or each other. +
    +
    + + +
    +

    Personal Data Tools Beta

    +

    Let the AI access your Calendar, Reminders, and Location & Maps to answer questions about your schedule and surroundings. Each service is opt-in and uses Apple's own frameworks (EventKit, CoreLocation, MapKit) with standard macOS permission prompts β€” nothing goes through a third-party service.

    + +

    Enabling a Service

    +
      +
    1. Press ⌘, to open Settings
      2. +
    2. Go to the MCP tab β†’ Personal Data section
      3. +
    3. Toggle on the services you want: Calendar, Reminders, or Location & Maps
      4. +
    4. Click Request Access next to a service β€” macOS shows its standard permission prompt
      5. +
    + +

    What the AI Can Do

    + + +
    + ⚠️ Write actions require approval: Creating a calendar event or reminder, or completing a reminder, shows an approval sheet first with a plain-language summary of what will happen. Choose Deny, Allow Once, or Allow for Session. Toggle this requirement off in Settings β†’ MCP β†’ Personal Data β†’ Require Approval for Changes. +
    + +
    + Note: Contacts support exists internally but is currently hidden while a macOS permission bug affecting hardened-runtime apps is worked out on Apple's side. +
    + +

    Example Prompts

    + +
    + + +
    +

    Research Agents

    +

    For tasks that involve searching or reading many files, the AI can spawn several read-only research sub-agents that work in parallel instead of doing everything itself, one step at a time.

    + +
    + ⚠️ Cost warning: Each sub-agent runs its own full chain of model calls. A single request that spawns several agents can cost several times a normal reply. Leave this off unless you specifically want that tradeoff. +
    + +

    Enabling Research Agents

    +
      +
    1. Press ⌘, to open Settings
      2. +
    2. Go to the MCP tab β†’ Research Agents section
      3. +
    3. Toggle Enable Research Agents on
      4. +
    4. Adjust Max Concurrent Agents (1–5, default 3) to control how many sub-agents can run at once
      5. +
    + +

    What Sub-Agents Can Do

    +

    Sub-agents are intentionally limited to read-only investigation β€” they cannot write files, run shell commands, or spawn further sub-agents:

    + + +

    Intended for genuinely independent research tasks (e.g. "compare these five files" or "look into three unrelated topics"), not everyday questions β€” the AI is instructed to reserve this for cases that actually benefit from parallelism.

    +
    +

    Keyboard Shortcuts

    Work faster with these keyboard shortcuts.

    @@ -1490,6 +1594,9 @@ Whenever the user asks you to translate something, translate it to Norwegian Bok
  • Enable/disable write, delete, move, and bash execution permissions
  • Configure gitignore respect
  • Bash Execution β€” enable AI shell access, set working directory, timeout, and approval behaviour (see Bash Execution)
    • +
  • Research Agents β€” let the AI spawn parallel read-only research sub-agents (see Research Agents)
    • +
  • External MCP Servers β€” connect any stdio MCP server for additional tools (see External MCP Servers)
    • +
  • Personal Data β€” Calendar, Reminders, and Location & Maps access (see Personal Data Tools)

    • Sync Tab