Osaurus
A native Mac harness for persistent, tool-using AI agents that can run with local or cloud models.
The evidence describes per-agent Linux users, workspace write restrictions, subagents and browser use disabled by default, first-use or consequential-action approval, pre-cloud review, fail-closed redaction, Keychain-held identity keys, revocable access keys, and explicit telemetry/cloud data boundaries. This supports strong sensitive-data handling and data-flow transparency. Deductions apply because agents may still execute code, use networks, connect remote MCP services, expose public relays, and run automations without evidence that every external effect receives per-action confirmation; the older sandbox has all-or-nothing networking; plaintext local storage is the default; and no general undo mechanism covers file changes or task side effects. Toolchains and dependency inputs receive some pinning and releases are CI-gated, but Actions use moving major-version tags and no vulnerability scan, SBOM, or dependency-update policy is shown. The license attributes Osaurus, Inc. and the repository names project channels and third-party components, but registry verification is absent, so publisher identity remains a repository assertion rather than verified provenance.
The README, platform requirements, architecture, and workflows form a largely coherent product account. CI pins Xcode and the runner, release publication requires named test and lint checks, and the workflow provides unusually detailed diagnostics for incomplete builds, launch hangs, empty test results, ordinary failures, and process crashes; failure messaging therefore earns full credit. Deductions apply because Package.resolved, the dependency graph, and actual CI outcomes are not supplied, so availability cannot be confirmed statically. Broad claims such as “fully offline,” “nothing leaves your Mac,” and “zero risk” require qualifications given optional cloud providers, production crash reporting enabled by default, and the sandbox's host bridge, reducing strict self-consistency.
The material addresses research, coding, file organization, browser work, image generation, voice, automation, APIs, MCP, and plugin development. It clearly states Apple Silicon and OS requirements, local/cloud model choices, the Linux VM and Seatbelt fallback, and the HTTP/SSE-only boundary for remote MCP providers, supporting full scores for scenarios, capability boundaries, and environment fit. Trigger precision is reduced because RAG automatically selects tools and skills, while watchers and schedules invoke agents, but the evidence does not specify selection thresholds, conflict resolution, false-trigger controls, or an auditable matching policy; approval behavior is documented only for selected capabilities.
The README has strong navigation across installation, agents, sandboxing, privacy, models, MCP, plugins, APIs, CLI, architecture, building, and contribution. Commands, system prerequisites, source-build steps, and usage examples are concrete. The supplied MIT text matches the metadata, and important limitations are expressly stated. Deductions apply because no actual FAQ, troubleshooting content, or release history is included; semantic tags, draft release notes, and Sparkle appcast generation establish a versioning path but not changelog quality. Plugin documentation refers to a v3 host API with v1/v2 compatibility while the architecture diagram labels only a v1/v2 ABI, creating minor version-language drift. Copyright ownership, contribution channels, Issues, Discord, and an update pipeline indicate responsibility, but no named maintainers or support commitment are shown and publisher identity is not registry-verified.
Outputs are consumable through a native UI, CLI, compatible OpenAI/Anthropic/Ollama APIs, MCP, system intents, and inline media. Persistent memory, tool execution, identity, sandboxing, and model portability provide substantial apparent value beyond a bare inference endpoint. Cost-benefit is reduced because the product requires Apple Silicon and a recent macOS release, VM isolation requires macOS 26, the privacy model is about 2.8 GB, cold builds may take tens of minutes, and cloud models or the hosted router may incur fees. No performance, resource, quality, or total-cost benchmarks are supplied to quantify those tradeoffs.
Many claims point to named documentation, and the README supplies concrete paths, commands, endpoints, version requirements, algorithms, and data flows. The license and two workflows independently support the MIT license, Swift/macOS build path, CI gating, signing, notarization, release mechanics, and crash-symbol handling. Deductions apply because the referenced feature guides, implementation code, test results, dependency lockfile, and release history are not part of the evidence bundle, leaving most security and feature claims supported only by the README. Absolute conclusions such as “zero risk,” “fully private,” and claims that a man-in-the-middle cannot complete a handshake are not clearly separated from observable facts, assumptions, and inference in the supplied sources.
- This is a low-confidence static review; the app, tests, sandbox, redaction system, secure channel, and release artifacts were not executed.
- Local storage is plaintext by default. Users relying on FileVault should verify that disk encryption is enabled and consider SQLCipher for sensitive agent databases.
- Production crash reporting is enabled by default, while analytics, cloud models, Osaurus Router, remote MCP services, and public relays create distinct data flows; review and configure each privacy control before deployment.
- Older macOS versions use the Seatbelt fallback with all-or-nothing network access. The README's “zero risk” statement is not established by the supplied evidence.
- Automatic tool selection, schedules, watchers, shell access, plugins, and browser use can create external effects. Verify approval scope, permissions, logs, and recovery behavior before using important files or accounts.
- No vulnerability scan, SBOM, complete dependency lockfile, or commit-SHA pinning for GitHub Actions is shown; independently review dependency and supply-chain controls.
What does this agent do, and when should you use it?
Osaurus is a native Swift harness that keeps agents, persistent memory, tools, automation, and cryptographic identities on a user's Mac. It can run local models through MLX or Apple Foundation Models and connect to OpenAI, Anthropic, Gemini, xAI/Grok, Venice AI, OpenRouter, Ollama, LM Studio, and Osaurus Router. Each agent has its own prompts, memory, theme, and optional local database, and can work with files, Git, search, and executable code in a selected workspace. The product exposes a chat UI, CLI, MCP server and client, plus OpenAI-, Anthropic-, and Ollama-compatible HTTP endpoints. Its local-model path can operate fully offline, while cloud providers, remote MCP services, relay access, and browser activity are optional networked features. Adoption requires an Apple Silicon Mac running macOS 15.5 or later; the full Linux VM sandbox requires macOS 26 or later.
After the user selects an agent and working folder, the Agent Loop makes file, search, and Git tools available to the model; enabling the sandbox adds an isolated shell, Python, Node.js, compilers, and package managers. The model writes a Markdown todo list, executes tool calls against it, and returns a verified summary in the same chat. The memory subsystem distills sessions into identity, pinned facts, and episodic memories, scores them for salience, and injects a compact relevant slice into later requests. On macOS 26 or later, execution uses an Alpine Linux VM powered by Apple Containerization, with per-agent Linux users, a VirtioFS workspace, and a vsock host bridge; older systems fall back to a native Seatbelt sandbox using sandbox-exec. osaurus mcp exposes local tools to MCP clients, while Osaurus can also aggregate URL-based HTTP/SSE MCP providers. It serves /v1/chat/completions, /anthropic/v1/messages, and /api/chat, while POST /agents/{id}/run provides a server-side autonomous loop. Optional operations include local image generation, persistent WebKit browser sessions, schedules, folder watchers, subagent delegation, voice input, encrypted agent-to-agent communication, and relay-based internet reachability.
- An Apple Silicon developer who wants source code, files, and conversation context to remain local can pair an MLX model with the isolated execution sandbox.
- A team with existing OpenAI, Anthropic, or Ollama API clients can point them at Osaurus's localhost-compatible endpoints while retaining its current client-side tool loop.
- A researcher or personal-assistant user can create separate agents with dedicated prompts, layered memory, themes, and optional private databases.
- A user who needs an external MCP client to call tools on a Mac can run
osaurus mcpand add a scoped access key when network exposure is enabled. - Someone who changes models frequently can move among local models, Apple Foundation Models, and supported cloud providers without replacing the agent, memory, and tool layer.
- A Mac user with recurring background work can use schedules, folder watchers, or an agent's single self-scheduled next run.
What are this agent's strengths and limitations?
- Agents, memory, tools, and local inference can remain on the Mac, allowing the base workflow to operate without a network connection.
- The model layer is interchangeable across MLX, Apple Foundation Models, and numerous local and cloud providers while the surrounding agent context remains intact.
- A GUI, CLI, bidirectional MCP support, and three compatible HTTP API surfaces provide several concrete integration paths.
- On macOS 26, per-agent Linux users, VirtioFS, and the vsock bridge form a documented isolation architecture for executable workloads.
- Before cloud sends, the optional local privacy filter combines model-based detection, deterministic patterns, human review, fail-closed scanning, and wire-level inspection.
- The MIT-licensed plugin system supports native Swift extensions and simple JSON plugin recipes.
- The core product is restricted to Apple Silicon Macs running macOS 15.5 or later; it is not documented as a direct Windows, Linux-host, or Intel Mac deployment.
- The full Alpine VM sandbox depends on macOS 26. The Seatbelt fallback on older releases limits package installation to pip/npm and offers all-or-nothing rather than per-domain network access.
- Cloud models, remote MCP providers, relay access, and networked browsing introduce external-service or connectivity dependencies that are absent from offline mode.
- Local models and the approximately 2.8 GB privacy-filter model consume storage and unified memory, so practical capacity depends on the Mac's hardware.
- Cloud requests are still processed by upstream providers; Osaurus Router says it omits prompt and response storage but retains usage metadata needed for billing.
- Crash and app-hang reporting is enabled by default in configured distribution builds, although users can disable it; anonymous analytics and crash reporting use separate controls.
How do you install or deploy this agent?
Run brew install --cask osaurus, or download the latest Osaurus.dmg from GitHub Releases. Launch Osaurus from Spotlight or run osaurus ui; the minimum runtime is an Apple Silicon Mac with macOS 15.5 or later. To build from source, run git clone https://github.com/osaurus-ai/osaurus.git, cd osaurus, and open osaurus.xcworkspace, then build and run the osaurus target with Xcode 16 or later. The full Linux VM sandbox additionally requires macOS 26 or later; earlier supported releases use the Seatbelt fallback.
How do you use this agent?
For an initial interactive run, execute osaurus ui, create or select an agent and working folder, and submit a task in chat. Start the server with osaurus serve --port 1337, inspect it with osaurus status, and stop it with osaurus stop; use osaurus serve --port 1337 --expose for LAN exposure. OpenAI-compatible clients use http://127.0.0.1:1337/v1/chat/completions, Anthropic-compatible clients use http://127.0.0.1:1337/anthropic/v1/messages, and Ollama clients use http://127.0.0.1:1337/api/chat. For MCP, configure the client command as osaurus with args ["mcp"]; loopback-only servers can use local trust, while network exposure requires an osk-v1... key in OSAURUS_MCP_ACCESS_KEY. Local models need no network service. Cloud use requires connecting the chosen provider in Osaurus, although the supplied source does not document one universal credential format.
FAQ
Can Osaurus work entirely offline?
Do agent shell commands run directly on my Mac?
Do localhost clients need an access key?
osk-v1... access key through OSAURUS_MCP_ACCESS_KEY; cloud providers still require their own configured connection.