hivemind_lock
hivemind_lock
Acquire or release advisory file locks to prevent edit conflicts.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | Yes | "acquire" or "release" |
| resource | string | Yes | File path or resource identifier |
| ttl_seconds | number | No | Lock 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