$worker
shell
v0.3.5Unix shell + filesystem worker — exec with allowlist/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
- macOS: arm64 · x64
- Linux: arm64 · armv7 · x64
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
JobSummaryonly;argv,stdout, andstderrare 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), callshell::statuswith thejob_id. The random UUID acts as an unguessable capability. - Terminated jobs stay listed for
cfg.job_retention_secs(default 3600s) past theirfinished_at_ms. After that the periodic janitor removes them and the list no longer returns them.