Skip to content

Native FSKit mount for macOS 26 (mount --native) - #33

Merged
darkspadez merged 1 commit into
mainfrom
claude/architecture-design-3fxhjv
Oct 22, 2026
Merged

darkspadez merged 1 commit into
mainfrom
claude/architecture-design-3fxhjv

Conversation

@darkspadez

Copy link
Copy Markdown
Contributor

Before: mounting a volume on a Mac needed macFUSE (its kernel extension or its FSKit backend, which only mounts under /Volumes), or the NFS loopback.

After: on macOS 26, rustfuse mount <dir> <mountpoint> --native mounts anywhere through rustFUSE's own FSKit module, shipped inside the Mac app, with no macFUSE. The TUI and the Mac app offer it as a third mount backend ("native" / "rustFUSE extension").

The module is a passthrough over the synced directory, like the FUSE backends, so the sync sees writes as ordinary edits. It hides .rustfuse, fills placeholders through the daemon's provider socket before reading them, and re-marks open files every 30 s so eviction leaves them alone.

How: macos/FS (new ExtensionKit target RustFuseFS, com.apple.fskit.fsmodule, Swift 5 mode, deployment macOS 26) implements FSUnaryFileSystem and the volume operations (lookup, attributes, create, remove, rename, readdir, symlinks, open/close, read/write). rustfuse mount --native prepares the sync and provider socket, then runs mount -t rustfuse, and umount on exit. CI checks the extension is embedded with the FSKit extension point and that the CLI has --native. Docs: design.md §2.1, README, macos/README.

Limits: only compiles in CI here (no Swift toolchain in the container). Running it needs a signature from a team granted the FSKit entitlement, and the user turns it on once in System Settings › General › Login Items & Extensions › File System Extensions. It is untested on a Mac until signing exists.


Generated by Claude Code

rustFUSE's own FSKit module (macos/FS) serves a synced directory as a
passthrough without macFUSE; `rustfuse mount --native` runs the sync and
provider socket, then mounts it with `mount -t rustfuse`. The TUI and Mac
app offer it as a mount backend.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017XkM29BZuvUK5RBjQ1fmWx
@coderabbitai

coderabbitai Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Essentials
  • Run ID: 345e162b-ebd1-4487-8080-316da2d8308a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

@darkspadez
darkspadez marked this pull request as ready for review October 22, 2026 23:35
@darkspadez
darkspadez merged commit 519ab2d into main Oct 22, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants