skip to content
iii / worker
$worker

ide

(alias: shell)v0.3.4

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
1,951 installs0 in 7d0 today
install
$iii trigger compose::add worker=ide@0.3.4
binarybashexecfilesystemideshellterminal
  • macOS: arm64 · x64
  • Linux: arm64 · armv7 · x64
15functions0triggers16skills0depsv0.3.4version
repoiii-hq/workers

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

skill doc

skills/list.md

Surveying current background jobs

When to use

  • "What background jobs are running right now?" probes.
  • Driving a dashboard or status surface over current shell activity.
  • Pre-cleanup audit before a worker shutdown.

Notes

  • The response carries JobSummary only; argv, stdout, and stderr are deliberately omitted. The JOBS map is process-wide and any caller could otherwise read another caller's command line and captured output (which may embed credentials).
  • For full records (including stdout/stderr), call shell::status with the job_id. The random UUID acts as an unguessable capability.
  • Terminated jobs stay listed for cfg.job_retention_secs (default 3600s) past their finished_at_ms. After that the periodic janitor removes them and the list no longer returns them.