foxctl-file-reservations

name	foxctl File Reservations
description	Advisory file locking for multi-agent coordination. Reserve files, check conflicts, prevent concurrent edits.

File Reservations

Prevent concurrent edit conflicts via foxctl run mailbox.

Usage

foxctl run mailbox --input '{"operation": "<op>", ...}'

Operations

Op	Params	Description
reserve	workspace_id, actor_id, paths[], mode, task_id?, reason?, duration_minutes?	Reserve files
check_conflicts	workspace_id, actor_id, paths[], mode	Check for conflicts
release	workspace_id, actor_id, paths[]	Release reservations
list_reservations	workspace_id	List active reservations

Modes

• exclusive - Only holder can edit
• shared - Multiple readers allowed

Integration

hooks/file_guard auto-checks conflicts before writes.

Set mode: FOXCTL_FILE_GUARD_MODE=strict

Full docs: ~/.foxctl/share/configs/skills/foxctl-reservations/Skill.md