skip to content
$worker

shell

v0.3.7

Unix shell + filesystem worker — exec with denylist/timeout/output caps and background jobs; fs::ls|stat|mkdir|rm|chmod|mv|grep|sed|read|write with host jail, denylist, size caps, and sandbox-target forwarding

iiiverified
406 installs112 in 7d29 today
install
$iii worker add shell@0.3.7
  • macOS: arm64 · x64
  • Linux: arm64 · armv7 · x64

exact versions are immutable; binary and bundle artifacts are digest-pinned.

functions

15

shell::exec

function

Run an allowlisted command in the foreground and return its full output. Payload: { command: string (program name), args?: string[], timeout_ms?: number, target?: { kind: 'host'|'sandbox', sandbox_id?: string } }. Returns { stdout, stderr, exit_code, duration_ms, timed_out, stdout_truncated, stderr_truncated }. Do NOT pass argv as an array in 'command' — split program and arguments across the two fields.

request
valueunknown
response
valueunknown

shell::exec_bg

function

Spawn an allowlisted command as a background job. Same payload shape as shell::exec; returns { job_id, argv } immediately. Poll with shell::status, terminate with shell::kill, list with shell::list. Do NOT pass argv as an array in 'command' — use 'command' (string) + 'args' (string[]).

request
valueunknown
response
valueunknown

shell::fs::chmod

function

Change permissions on host or sandbox

request
valueunknown
response
valueunknown

shell::fs::grep

function

Recursive regex search on host or sandbox

request
valueunknown
response
valueunknown

shell::fs::ls

function

List directory contents on host or sandbox

request
valueunknown
response
valueunknown

shell::fs::mkdir

function

Create a directory on host or sandbox

request
valueunknown
response
valueunknown

shell::fs::mv

function

Move/rename a path on host or sandbox

request
valueunknown
response
valueunknown

shell::fs::read

function

Stream a file from a host path or sandbox via StreamChannelRef

request
valueunknown
response
valueunknown

shell::fs::rm

function

Remove a path on host or sandbox

request
valueunknown
response
valueunknown

shell::fs::sed

function

Find-and-replace on host or sandbox

request
valueunknown
response
valueunknown

shell::fs::stat

function

Stat a path on host or sandbox

request
valueunknown
response
valueunknown

shell::fs::write

function

Stream a file to a host path or sandbox via StreamChannelRef

request
valueunknown
response
valueunknown

shell::kill

function

Kill a running background job

request
valueunknown
response
valueunknown

shell::list

function

List all background jobs

request
valueunknown
response
valueunknown

shell::status

function

Get status of a background job

request
valueunknown
response
valueunknown

triggers

0
no triggers registered