> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zocomputer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run command

> Run a single shell command on the computer.

Zo can execute shell commands in a bash session, allowing for system operations, script execution, and command-line automation. Use cases include: System automation (execute scripts, manage files, automate tasks), Data processing (process files, run analysis scripts, manage datasets), Environment setup (install packages, configure environments).

## Parameters

<ParamField path="cmd" type="string" required={true}>
  The shell command string to execute.
</ParamField>

<ParamField path="cwd" type="string" default={"/home/workspace"}>
  The working directory in which to execute the command. Defaults to the user's workspace root.
</ParamField>

<ParamField path="timeout" type="number" default={0}>
  Optional time limit in seconds. When set, the command is terminated if it runs longer than this. Defaults to unbounded.
</ParamField>

<ParamField path="description" type="string" default={""}>
  Optional short human-readable label for the command (shown in the UI). Does not affect execution.
</ParamField>