tags: api/syscall references:

• plug-api/syscalls/shell.ts
• client/plugos/syscalls/shell.ts

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

shell.run

shell.run(command, arguments, stdin?)

Runs a shell command on the server and returns its output.

Parameters:

• command (string) — Executable name.
• arguments (table) — Command arguments.
• stdin? (string) — Text supplied on standard input.

Returns:

• table — stdout, stderr, and numeric exit code.

Examples:

local result = shell.run("ls", {"-l"})
print(result.stdout)

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