Skip to content
Orbit Docs

Lock Files Against Edits

File locks protect files you don’t want an agent to modify — generated output, vendored code, a file mid-refactor.

Steps

Section titled “Steps”
  1. Lock a file or glob with the orbit_lock_file tool (via Apollo or any MCP client). List active locks with orbit_list_locks; release with orbit_unlock_file.
  2. Locked files appear as advisory chips in the Pipeline, and agents self-enforce the lock through their preamble.
  3. If a completion’s commit modifies a locked file anyway, Orbit rejects that completion as ❌ Failed. The commit itself is never rolled back — you decide what to do with it.

Active locks also surface in orbit_status as fileLocks, so any client can see what’s protected.

Section titled “Related”