skip to content
iii / worker
$worker

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
406 installs91 in 7d0 today
install
$iii worker add shell@0.3.4
binaryshellexecfilesystembashterminal
  • 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/stat.md

Reading a single path's metadata

When to use

  • Confirming a file exists and checking its size before deciding whether to read it whole.
  • Distinguishing a regular file from a symlink without dereferencing it.
  • Pre-flight check for a write target's existing mode before chmod-ing.

Notes

  • A missing path returns the trigger Err (FsError); there is no soft-not-found envelope. Wrap the call when probing optionally.
  • Symlinks are not followed; is_symlink reports the link itself. To get the target's metadata, follow up with another stat on the resolved path.
  • Same jail and denylist rules as shell::fs::ls. mode is an octal string and mtime is epoch seconds.