iii / worker
$worker

shell

v0.3.5

Unix 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/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.