mac-smb-automount
Skill3 starsChanged yesterdayMITView on GitHub
Auto-mount another Mac's SMB shares on macOS at login and keep them mounted (LaunchAgent + NetFS), over Tailscale or LAN, authenticating with the shared Apple ID (Kerberos LKDC) so no password is stored. Use when mounting a Mac's shares automatically; when an SMB connection to a Mac prompts for a password or returns "Authentication error" despite the right password; when a mount agent keeps declaring healthy mounts stale; or when replacing local Dropbox/Google Drive sync clients with mounts of the server's copies.
In this repository31 other files it gives its agents.
- affix-domainsSkill
- apple-designSkill
- apwcli-pairSkill
- ask-always-on-agentSkill
- asus-esc8000-firmware-upgradeSkill
- asus-esc8000-gpu-bios-tuningSkill
- build-stealth-rustdeskSkill
- chrome-cdp-setupSkill
- cua-macos-lume-sandboxSkill
- deploy-kimi-k26-on-rtx-pro-6000Skill
- deploy-kimi-k3-on-rtx-pro-6000Skill
- deploy-stealth-rustdeskSkill
- ghostty-terminfoSkill
- herdr-rename-hookSkill
- imsg-permissionsSkill
- llm-inference-benchmarkSkill
- lxd-docker-firewall-conflictSkill
- mac-mini-as-headless-serverSkill
- macos-app-multi-instancesSkill
- macos-smb-serverSkill
- openclaw-diagnoseSkill
- paseo-profilesSkill
- private-fork-syncSkill
- refresh-claude-accountSkill
- ssh-claude-authSkill
- sync-claude-accountsSkill
- to-featuresSkill
- trusted-publishSkill
- ubuntu-lxd-gpu-serverSkill
- ubuntu-nvidia-gpu-enablementSkill
- ubuntu-zfs-mirror-installSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 48
Only when the shares are the server's Dropbox / Google Drive folders and the client runs its own copies: RETIRE-SYNC-CLIENTS.md.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Auto-mount a Mac's SMB shares
Deploys scripts/mount-smb-shares.sh behind a LaunchAgent on the client Mac so the server Mac's shares sit at /Volumes/<share> after login and come back by themselves after sleep, network changes and server hiccups. Triggers: login, every 300 s, /var/run/resolv.conf changes, and every power-state change (com.apple.powermanagement.systempowerstate, the same event Time Machine's helper wakes on) so a wake from sleep remounts within seconds instead of waiting for the interval — which launchd stretches well past 5 min on battery. The script exits at once when the lid is closed, so dark wakes cost nothing. Both Macs signed into the same Apple ID is the normal case, and then no password exists anywhere in the setup.
Facts every step rests on
- Mounts happen at login, not boot. NetFS needs the Aqua session (and, with FileVault, the unlocked login keychain), so the agent lives in
gui/<uid>. A LaunchDaemon would mount as root, outside the user's namespace. With auto-login on and FileVault off, login follows boot unattended. - One hostname. Address the server by one name. For a client that travels, use its Tailscale MagicDNS name: Tailscale takes the direct LAN path at home, so the same name works away with no switching logic. For two Macs that never leave one LAN, use
<host>.localand install with--tailscale "", so a Tailscale outage cannot stop the mount: the script then skips its Tailscale check. - NetFS, not
mount_smbfs./Volumesis not user-writable;osascript -e 'mount volume "smb://…"'mounts there through the privileged agent and shows in Finder. It blocks forever when the server cannot authenticate the client, so the script caps it with a watchdog. - Probe with
smbutil statshares -m <mountpoint>(rc 0 live, 64 gone). Reading the directory from a LaunchAgent gets TCC'sOperation not permittedwhile an interactive shell reads fine; anlsprobe turns every healthy pass into an unmount/remount cycle. - SSH is the wrong context. Over SSH,
mount volumehangs, keychain writes are refused, and credential caches are invisible. Reach the GUI session instead:sudo launchctl asuser <uid> sudo -u <user> -i <cmd>. - FileProvider shares need a live GUI session on the server. Dropbox and Google Drive folders under
~/Library/CloudStoragemount fine but read empty while the server sits at the login window: server auto-login on, FileVault off (themac-mini-as-headless-serverskill covers that).
Steps
1. Recon
Server: sharing -l (share names and paths); dscl . -read /Users/<user> AltSecurityIdentities.
Client: nc -z -G 3 <host> 445; dscl . -read /Users/<user> AltSecurityIdentities; stat -f %Su /dev/console.
Shares that a client sees beyond sharing -l are smbd's virtual shares (whole volumes, home folders); the macos-smb-server skill covers trimming them.
Done when the share names are known, port 445 answers on that name, both accounts carry the same com.apple.idms.appleid… under AltSecurityIdentities, and the console owner is the user who will mount.
2. First silent mount
From the client's GUI session (a Terminal there, or the asuser form): open "smb://<host>/<share>".
Done when mount | grep smbfs lists the share within seconds with no dialog, and klist --list-all in the GUI session shows a com.apple.idms.appleid… cache. A dialog, a hang, or Authentication error → AUTH.md, then return here. pkill NetAuthAgent clears a leftover dialog.
3. Install
scripts/install.sh --host <fqdn> --user <server-account> --share <A> --share <B> …
Done when every share is mounted, the log has one mounted <share> line per share, and launchctl print gui/$(id -u)/<label> reports last exit code = 0.
4. Verify
scripts/verify.sh (from a Terminal in the client's GUI session, or over SSH with passwordless sudo — it reaches the GUI session itself) — three checks, all must pass: two forced agent runs add 0 log lines (a healthy pass is silent); unmounting one share is repaired on the next run; kdestroy -A plus unmounting everything ends with all shares remounted silently and a fresh credential cache. A reboot is optional: it adds only boot-ordering evidence.
5. Retire local sync clients (branch)
Only when the shares are the server's Dropbox / Google Drive folders and the client runs its own copies: RETIRE-SYNC-CLIENTS.md.
Reading the log
~/Library/Logs/mount-smb-shares.log is silent while healthy. host … unreachable; skipping this pass is the designed skip: existing mounts are left alone through an outage. FAILED to mount <X> repeating for one share while the others mount is server-side — Dropbox auto-updating on the server takes its FileProvider down for a while — and clears by itself. Entries like //com.apple.idms…@<host>/<user> on /Volumes/<user> come from clicking the server under Finder → Network; umount -f them and connect by hostname.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

