2.4.1 #7
@@ -36,6 +36,9 @@
|
||||
<li><a href="#shortcuts">Shortcuts (Prompt Templates)</a></li>
|
||||
<li><a href="#agent-skills">Agent Skills (SKILL.md)</a></li>
|
||||
<li><a href="#anytype">Anytype Integration</a></li>
|
||||
<li><a href="#external-mcp">External MCP Servers</a></li>
|
||||
<li><a href="#personal-data">Personal Data Tools</a></li>
|
||||
<li><a href="#research-agents">Research Agents</a></li>
|
||||
<li><a href="#bash-execution">Bash Execution</a></li>
|
||||
<li><a href="#icloud-backup">iCloud Backup</a></li>
|
||||
<li><a href="#reasoning">Reasoning / Thinking Tokens</a></li>
|
||||
@@ -49,7 +52,7 @@
|
||||
<!-- Getting Started -->
|
||||
<section id="getting-started">
|
||||
<h2>Getting Started</h2>
|
||||
<p>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.</p>
|
||||
<p>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.</p>
|
||||
|
||||
<div class="steps">
|
||||
<h3>Quick Start</h3>
|
||||
@@ -115,6 +118,10 @@
|
||||
<li><strong>🧠 Thinking</strong> — models that support reasoning / thinking tokens</li>
|
||||
</ul>
|
||||
|
||||
<div class="note">
|
||||
<strong>Note:</strong> 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.
|
||||
</div>
|
||||
|
||||
<h3>Sorting</h3>
|
||||
<p>Click the <strong>↑↓ Sort</strong> button to sort the list by:</p>
|
||||
<ul>
|
||||
@@ -1370,7 +1377,6 @@ Whenever the user asks you to translate something, translate it to Norwegian Bok
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Keyboard Shortcuts -->
|
||||
<!-- Anytype Integration -->
|
||||
<section id="anytype">
|
||||
<h2>Anytype Integration</h2>
|
||||
@@ -1413,6 +1419,104 @@ Whenever the user asks you to translate something, translate it to Norwegian Bok
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
<!-- External MCP Servers -->
|
||||
<section id="external-mcp">
|
||||
<h2>External MCP Servers</h2>
|
||||
<p>Connect any external MCP server that speaks the stdio JSON-RPC protocol (for example <code>safaridriver --mcp</code>) and give the AI access to its tools — no custom integration code needed.</p>
|
||||
|
||||
<h3>Adding a Server</h3>
|
||||
<ol>
|
||||
<li>Press <kbd>⌘,</kbd> to open Settings</li>
|
||||
<li>Go to the <strong>MCP</strong> tab → <strong>External MCP Servers</strong> section</li>
|
||||
<li>Click <strong>Add Server…</strong></li>
|
||||
<li>Enter a <strong>Name</strong> (used to prefix its tools, e.g. "Safari" → <code>safari_navigate_to_url</code>), the <strong>Command</strong> to launch it, and any <strong>Arguments</strong></li>
|
||||
<li>Click <strong>Add</strong> — the server starts automatically and its tools are discovered</li>
|
||||
</ol>
|
||||
|
||||
<div class="tip">
|
||||
<strong>💡 Tip:</strong> Arguments containing spaces can be quoted, e.g. <code>--root "/Users/you/My Documents"</code>.
|
||||
</div>
|
||||
|
||||
<h3>Server Status</h3>
|
||||
<p>Each configured server shows a status dot and label:</p>
|
||||
<ul>
|
||||
<li><strong>🟢 Connected</strong> — running and its tools are available to the AI</li>
|
||||
<li><strong>🟠 Connecting…</strong> — starting up or performing the initial handshake</li>
|
||||
<li><strong>🔴 Error / Crashed</strong> — failed to start or exited unexpectedly</li>
|
||||
<li><strong>⚪ Not started</strong> — disabled via the toggle</li>
|
||||
</ul>
|
||||
<p>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.</p>
|
||||
|
||||
<div class="note">
|
||||
<strong>Note:</strong> 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.
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Personal Data Tools -->
|
||||
<section id="personal-data">
|
||||
<h2>Personal Data Tools <span style="font-size: 0.75em; background: #f90; color: #fff; border-radius: 4px; padding: 1px 5px; vertical-align: middle;">Beta</span></h2>
|
||||
<p>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.</p>
|
||||
|
||||
<h3>Enabling a Service</h3>
|
||||
<ol>
|
||||
<li>Press <kbd>⌘,</kbd> to open Settings</li>
|
||||
<li>Go to the <strong>MCP</strong> tab → <strong>Personal Data</strong> section</li>
|
||||
<li>Toggle on the services you want: <strong>Calendar</strong>, <strong>Reminders</strong>, or <strong>Location & Maps</strong></li>
|
||||
<li>Click <strong>Request Access</strong> next to a service — macOS shows its standard permission prompt</li>
|
||||
</ol>
|
||||
|
||||
<h3>What the AI Can Do</h3>
|
||||
<ul>
|
||||
<li><strong>Calendar</strong> — list your calendars and upcoming events, create new events</li>
|
||||
<li><strong>Reminders</strong> — list reminder lists and items, create new reminders, mark reminders complete</li>
|
||||
<li><strong>Location & Maps</strong> — get your current location, search for places, geocode addresses, and get directions (all read-only)</li>
|
||||
</ul>
|
||||
|
||||
<div class="warning">
|
||||
<strong>⚠️ Write actions require approval:</strong> 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 <strong>Deny</strong>, <strong>Allow Once</strong>, or <strong>Allow for Session</strong>. Toggle this requirement off in Settings → MCP → Personal Data → Require Approval for Changes.
|
||||
</div>
|
||||
|
||||
<div class="note">
|
||||
<strong>Note:</strong> Contacts support exists internally but is currently hidden while a macOS permission bug affecting hardened-runtime apps is worked out on Apple's side.
|
||||
</div>
|
||||
|
||||
<h3>Example Prompts</h3>
|
||||
<ul>
|
||||
<li>"What's on my calendar tomorrow?"</li>
|
||||
<li>"Remind me to call the dentist on Friday at 2pm"</li>
|
||||
<li>"How far is the nearest coffee shop from here?"</li>
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
<!-- Research Agents -->
|
||||
<section id="research-agents">
|
||||
<h2>Research Agents</h2>
|
||||
<p>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.</p>
|
||||
|
||||
<div class="warning">
|
||||
<strong>⚠️ Cost warning:</strong> 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.
|
||||
</div>
|
||||
|
||||
<h3>Enabling Research Agents</h3>
|
||||
<ol>
|
||||
<li>Press <kbd>⌘,</kbd> to open Settings</li>
|
||||
<li>Go to the <strong>MCP</strong> tab → <strong>Research Agents</strong> section</li>
|
||||
<li>Toggle <strong>Enable Research Agents</strong> on</li>
|
||||
<li>Adjust <strong>Max Concurrent Agents</strong> (1–5, default 3) to control how many sub-agents can run at once</li>
|
||||
</ol>
|
||||
|
||||
<h3>What Sub-Agents Can Do</h3>
|
||||
<p>Sub-agents are intentionally limited to read-only investigation — they cannot write files, run shell commands, or spawn further sub-agents:</p>
|
||||
<ul>
|
||||
<li>Read file contents</li>
|
||||
<li>List directory contents</li>
|
||||
<li>Search for files</li>
|
||||
<li>Search the web</li>
|
||||
</ul>
|
||||
|
||||
<p class="note">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.</p>
|
||||
</section>
|
||||
|
||||
<section id="keyboard-shortcuts">
|
||||
<h2>Keyboard Shortcuts</h2>
|
||||
<p>Work faster with these keyboard shortcuts.</p>
|
||||
@@ -1490,6 +1594,9 @@ Whenever the user asks you to translate something, translate it to Norwegian Bok
|
||||
<li>Enable/disable write, delete, move, and bash execution permissions</li>
|
||||
<li>Configure gitignore respect</li>
|
||||
<li><strong>Bash Execution</strong> — enable AI shell access, set working directory, timeout, and approval behaviour (see <a href="#bash-execution">Bash Execution</a>)</li>
|
||||
<li><strong>Research Agents</strong> — let the AI spawn parallel read-only research sub-agents (see <a href="#research-agents">Research Agents</a>)</li>
|
||||
<li><strong>External MCP Servers</strong> — connect any stdio MCP server for additional tools (see <a href="#external-mcp">External MCP Servers</a>)</li>
|
||||
<li><strong>Personal Data</strong> — Calendar, Reminders, and Location & Maps access (see <a href="#personal-data">Personal Data Tools</a>)</li>
|
||||
</ul>
|
||||
|
||||
<h3>Sync Tab</h3>
|
||||
|
||||
Reference in New Issue
Block a user