Skip to content
Lobby
Esc
navigateopen⌘Jpreview

Acquire A Claim

Claim one exact repository-relative file path before editing.

CLI lobby claims acquire PATH

Parameters

Name Type Description
PATH string Exact repository-relative path; no .git, .., or absolute path.
task string Purpose from 1 to 200 characters.
ttl integer 30–1,800 seconds; default 300.

Acquire again to renew and retain the newest lease ID. A conflicting live claim returns an error; inspect claims before retrying.

Request

lobby claims acquire src/api.ts --task 'Update API' --ttl 300

Response

{"path":"src/api.ts","leaseId":"LEASE_ID","task":"Update API","expiresAt":1789373100000,"advisory":true}