Zecheng Zhang
924ec49796
A unified virtual filesystem for AI agents. Mount S3, Google Drive, Slack, Gmail, GitHub, Linear, Notion, Postgres, MongoDB, SSH, and more behind one filesystem so agents read, write, and pipe across services with familiar shell commands. Ships Python (mirage-ai) and TypeScript (@struktoai/mirage-*) SDKs, a CLI, FUSE mounts, and adapters for OpenAI Agents SDK, Vercel AI SDK, LangChain deepagents, Pydantic AI, CAMEL, OpenHands, Mastra, Pi Coding Agent, plus FUSE-based integration with Claude Code and Codex. Apache 2.0 licensed.
52 lines
1.3 KiB
Plaintext
52 lines
1.3 KiB
Plaintext
---
|
|
title: macOS
|
|
icon: apple
|
|
description: Set up FUSE on macOS for MIRAGE.
|
|
---
|
|
|
|
## Install macFUSE
|
|
|
|
```bash
|
|
brew install --cask macfuse
|
|
```
|
|
|
|
## Enable Kernel Extension
|
|
|
|
<Steps>
|
|
<Step title="Allow the Extension">
|
|
Open **System Settings - Privacy & Security**. Scroll to the bottom, you will see:
|
|
|
|
> "System software from developer 'Benjamin Fleischer' was blocked from loading."
|
|
|
|
Click **Allow**.
|
|
</Step>
|
|
<Step title="Restart">
|
|
Restart your Mac. macOS requires a reboot to load the kernel extension.
|
|
</Step>
|
|
<Step title="Verify">
|
|
```bash
|
|
ls /Library/Filesystems/macfuse.fs
|
|
```
|
|
If this directory exists, macFUSE is installed.
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Apple Silicon (M1/M2/M3/M4)
|
|
|
|
If you don't see the **Allow** button:
|
|
|
|
<Steps>
|
|
<Step title="Shut Down">
|
|
Shut down your Mac completely.
|
|
</Step>
|
|
<Step title="Enter Recovery Mode">
|
|
Hold the power button until "Loading startup options" appears. Click **Options - Continue**.
|
|
</Step>
|
|
<Step title="Enable Kernel Extensions">
|
|
In Recovery: **Utilities - Startup Security Utility**. Set to **Reduced Security** and check **"Allow user management of kernel extensions"**.
|
|
</Step>
|
|
<Step title="Restart">
|
|
Restart, then go back to **System Settings - Privacy & Security** to allow the extension.
|
|
</Step>
|
|
</Steps>
|