claim
Reserve files or directories before editing to coordinate with other agents. All-or-nothing leases prevent concurrent changes and expire automatically.
Instructions
Lease the files or directories you are about to change.
All or nothing: you get every path or none. If something is taken you get
back who holds it and for how long — wait, take other work, or ask via
say/send. Leases expire on their own, so a crashed agent cannot block
the repo.
A lease on a directory covers everything under it. Editing a free file claims it automatically (hook); use this to reserve ahead — typically before running a script that touches several files.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"paths": "<paths>"
},
"name": "claim"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paths | Yes | ||
| purpose | No | ||
| ttl_seconds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||