Docs/MCP Tools/hivemind_lock

hivemind_lock

hivemind_lock

Acquire or release advisory file locks to prevent edit conflicts.

Parameters

ParameterTypeRequiredDescription
actionstringYes"acquire" or "release"
resourcestringYesFile path or resource identifier
ttl_secondsnumberNoLock TTL in seconds (default 300, max 3600)

Acquire Example

hivemind_lock(action: "acquire", resource: "src/auth.ts")

Returns { locked: true } if acquired, { locked: false, holder: "agent-xyz" } if already held.

Release Example

hivemind_lock(action: "release", resource: "src/auth.ts")

Best Practices

  • Always release locks after editing
  • Use TTL as a safety net — locks auto-expire
  • If a lock is held, work on a different file instead of waiting