apfs

Explain APFS Copy-on-Write behavior and macOS filesystem decisions.

1|1|Updated Apr 6, 2026

Search Tags:#macos #nix #spotlight #cow #apfs #clonefile #diskutil

Ready to run

npx skills add https://github.com/Jylhis/skills --skill apfs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: apfs
Source: https://github.com/Jylhis/skills/tree/main/skills/apfs
Command: npx skills add https://github.com/Jylhis/skills --skill apfs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clarifies APFS Copy-on-Write behavior and macOS filesystem nuances to help developers optimize file operations and storage layout.

Core Features & Use Cases

CoW behavior overview: explains how clonefile(2) and cp -c enable instant cloning on the same APFS volume and the limitations across volumes.
Volume planning for development: how to set up a case-sensitive dev volume to catch cross-platform bugs.
Spotlight and Time Machine considerations: guidance on excluding dev directories to reduce churn.
Nix-on-macOS architecture overview: synthetic /nix and dedicated Nix Store volume configuration.

Quick Start

Read the guide and apply CoW-aware copy strategies on macOS, including enabling clonefile-based cloning and setting up a case-sensitive development volume.

Frequently Asked Questions about apfs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How does APFS Copy-on-Write behavior work on macOS?▼

APFS CoW limitations prevent instant file cloning across different volumes. While clonefile(2) and cp -c enable instant cloning on the same APFS volume, copying between volumes requires a full data copy, impacting storage layout and benchmarking strategies.

How do I set up a case-sensitive APFS dev volume on macOS?▼

To set up a case-sensitive APFS dev volume on macOS, use diskutil apfs addVolume. This configuration helps developers catch cross-platform bugs by enforcing case-sensitivity, isolating development environments from the main system volume.

How do I reduce Spotlight indexing churn for macOS development directories?▼

To reduce Spotlight indexing churn for macOS development directories, use mdutil to exclude dev paths from indexing. This prevents unnecessary background scanning of rapidly changing files, improving system performance and reducing disk churn.

How does the Nix-on-macOS architecture handle the Nix Store volume?▼

The Nix-on-macOS architecture uses a synthetic /nix path and a dedicated Nix Store volume. This layout leverages APFS volume management to isolate the Nix store, ensuring proper filesystem permissions and CoW compatibility for package installations.