An Omni.Tool for executing shell commands.

Runs commands in a configured shell (bash by default, falling back to sh) with a working directory, optional environment variables, and timeout.

tool = Omni.Tools.Bash.new(dir: "/path/to/workspace")
tool = Omni.Tools.Bash.new(dir: "/app", timeout: 60_000, env: [{"NODE_ENV", "test"}])

The tool delegates execution to Omni.Tools.Bash.Runner, which can also be used independently of the tool machinery.

Options

• :dir (required) — working directory. Must exist at init time.
• :env — extra environment variables as [{String.t(), String.t()}]. Merged additively with the inherited environment. Default [].
• :timeout — execution timeout in milliseconds. Default 30_000.
• :max_output — output truncation limit in bytes. Tail-biased, snapped to line boundaries. Default 50_000.
• :shell — explicit shell as {executable, args} tuple. Default: auto-resolved (bash then sh fallback).
• :command_prefix — string prepended to every command. Default nil.