Lifecycle hooks

{
  "hooks": {
    "afterCreate": "bun install --frozen-lockfile",
    "beforeRun": "bun install --frozen-lockfile",
    "beforeVerify": "bun install --frozen-lockfile",
    "timeoutMs": 600000
  }
}

#Hooks

• afterCreate: runs after a new workspace is cloned and checked out.
• beforeRun: runs before agent workflow execution.
• beforeVerify: runs immediately before verification.
• afterRun: runs after workflow completion; failures warn instead of stopping the run.
• beforeRemove: runs before workspace removal; failures warn instead of stopping removal.

#Timeout

timeoutMs controls hook timeout. The default is 600000 milliseconds.

#Good uses

• Install dependencies.
• Generate local build artifacts required by verification.
• Run lightweight setup checks.

#Avoid

• Writing secrets into Git-tracked files.
• Long-running daemons.
• Interactive prompts.
• Commands that mutate unrelated host state.

For ignored local file copying, prefer workspace.copyToWorktree. See Managed workspaces.

#Next steps

• Use Configuration for the hook reference table.
• Use Verification for pre-verification setup.
• Use Security and secrets before adding hooks on shared hosts.