Skip to main content

Filesystem search and inspection

v0.1.7

Generic filesystem operations an LLM-driven runner needs constantly: bounded find, recursive grep, file head/tail/hash, du, ls -la, stat. All read-only. Paths are validated against simple patterns; the runner's symlink-containment + audit redaction layers still apply on top.

15 allowed by default
Pack ID
fs-search
Vendor
emisar
OS
linux
Actions
15

Install

emisar pack install fetches this pack, re-validates it, and verifies its content hash against the --hash below — the exact bytes this page was rendered against, so a tampered copy is rejected — before copying it into the runner's packs dir. The command reloads a running daemon itself; no manual restart.

on the runner host

Actions 15 total

View on GitHub
  • fs.count_lines exec low

    wc -l <file>

    Count lines in one file.

    View source on GitHub
  • fs.du_top exec low

    du -sh — top N subdirs

    Show the top 20 immediate subdirs of one path by size.

    View source on GitHub
  • fs.file_type exec low

    file <path>

    Show the libmagic-detected type of one file (e.g. "ELF 64-bit executable", "ASCII text").

    View source on GitHub
  • fs.find_by_name exec low

    find -name <glob> under <path>

    Find files matching one shell glob under one path. Capped at 1000 results.

    View source on GitHub
  • fs.find_large_files exec low

    Files larger than N MB

    Find the top files by size under one path. Use to find disk-pressure culprits.

    View source on GitHub
  • fs.find_recent_modified exec low

    Files modified in last N minutes

    Find files under one path modified within the last N minutes. Useful for "what just changed?".

    View source on GitHub
  • fs.find_setuid exec low

    setuid + setgid files

    Find files with setuid or setgid bits. Audit for privilege escalation surface.

    View source on GitHub
  • fs.find_world_writable exec low

    World-writable files

    Find files with the "world-writable" bit set under one path. Security audit.

    View source on GitHub
  • fs.grep_file exec low

    grep <pattern> <file>

    Show matching lines in one file. Pattern is treated as POSIX BRE.

    View source on GitHub
  • fs.grep_recursive exec low

    grep -rE <pattern> <path>

    Search recursively under one path. Bounded to 500 matches.

    View source on GitHub
  • fs.head_file exec low

    head -n <N> <file>

    Show the first N lines of one file.

    View source on GitHub
  • fs.ls_long exec low

    ls -la <path>

    List directory contents in long format.

    View source on GitHub
  • fs.sha256_file exec low

    sha256sum <file>

    Show the SHA-256 of one file. Use to confirm a binary matches a known-good hash.

    View source on GitHub
  • fs.stat_path exec low

    stat <path>

    Show inode + timestamps + permissions for one path.

    View source on GitHub
  • fs.tail_file exec low

    tail -n <N> <file>

    Show the last N lines of one file.

    View source on GitHub