Skip to content
capcom docs

capcom lock touch

Refresh the heartbeat of the lock you hold

Refresh the heartbeat of the Tree lock you hold, so that it does not go stale; –token, the Lock token acquire printed, is required. Touch it more often than the lock TTL while the work goes on. It prints the lock as it now stands. It fails not_found when nobody holds the lock and locked when another session holds it, both with exit code 3.

capcom lock touch [flags]
capcom lock touch --token <token>
capcom lock touch --token <token> --kv # KEY=VALUE lines ending in STATUS=
-h, --help help for touch
--kv print KEY=VALUE lines ending in STATUS=
--token string the token acquire returned
--json print a versioned JSON envelope
  • capcom lock - Acquire, refresh, release and inspect this worktree’s Tree lock