# exec (https://lazyfrog.dev/docs/tools/exec)

{/* Generated by scripts/generate-docs.ts from the gateway's registered tools. Do not edit. */}

**{"Run a command"}** · Can change or delete

<p>{"Run a shell command (bash) in the project's preview workspace, in /workspace by default, as the project's user, with DATABASE_URL and the preview secrets set. Use it for installs, builds, tests, scripts and git. Waits up to timeout seconds (default 60, max 300); with background: true (or a longer timeout) it returns a job id at once and the output is followed with the job tool. Processes the command leaves running are ended when it finishes: long-running servers belong in services.json (service tool)."}</p>