| name | manage-mounts |
| description | Configure which host directories agent containers can access. View, add, or remove mount allowlist entries. Triggers on "mounts", "mount allowlist", "agent access to directories", "container mounts". |
Manage Mounts
Configure which host directories FamilyClaw agent containers can access. The mount allowlist lives at ~/.config/familyclaw/mount-allowlist.json.
Show Current Config
cat ~/.config/familyclaw/mount-allowlist.json 2>/dev/null || echo "No mount allowlist configured"
Show the current config to the user in a readable format: which directories are allowed, whether non-main agents are read-only.
Add Directories
Ask which directories the user wants agents to access. For each path:
- Validate the path exists
- Ask if it should be read-only for non-main agents (default: yes)
Build the JSON config and write it:
npx tsx setup/index.ts --step mounts --force -- --json '{"allowedRoots":[{"path":"/path/to/dir","readOnly":false}],"blockedPatterns":[],"nonMainReadOnly":true}'
Use --force to overwrite the existing config.
Remove Directories
Read the current config, show it, ask which entry to remove, write the updated config.
Reset to Empty
npx tsx setup/index.ts --step mounts --force -- --empty
After Changes
Restart the service so containers pick up the new config (the unit/label names are per-install — see setup/lib/install-slug.sh).
Run from your FamilyClaw project root:
source setup/lib/install-slug.sh
launchctl kickstart -k gui/$(id -u)/$(launchd_label)
systemctl --user restart $(systemd_unit)
