Operations
Control Plane
Operational commands against a live mount.
The control plane exposes operational commands against a live mount:
brewfs info /mnt/brewfs # inspect the selected running instance
brewfs gc /mnt/brewfs --dry-run # submit and follow an orphan-GC jobEach mount registers its PID, mount point, Unix socket, and start time in the local
runtime registry. info and gc locate that record and send a request to the
instance-scoped Unix socket. If exactly one instance is running, the mount point can be
omitted; specify it when multiple mounts are active.
The protocol currently supports Ping, GetInfo, RunGc, and GetJob. GC is an
asynchronous job: the CLI submits it, receives a job ID, and follows it until completion.
The control plane is local-only and does not expose a network listener.

