The Shell API provides functions for running shell commands and interacting with processes.

shell.run(cmd, args, stdin?)

Runs a shell command and returns its output.

Parameters:
  • cmd: The command to run
  • args: Array of arguments to pass to the command
  • stdin: stdin string (optional)


Returns an object with:
  • stdout: The standard output of the command
  • stderr: The standard error of the command
  • code: The exit code of the command


Example:
local result = shell.run("ls", {"-l"})
print("Output:", result.stdout)
print("Error:", result.stderr)
print("Exit code:", result.code)

local result = shell.run("cat", {}, "hello")
print("Output:", result.stdout) -- "hello"