bhatti file ls
List directory contents inside a sandbox.
Synopsis
bhatti file ls <sandbox> <path>
Description
Lists files and subdirectories at the given absolute path. The default human format prints one row per entry: a directory flag, mode, size in bytes, and name.
Listings are capped at 10 000 entries. If the directory has more entries than that, a sentinel row indicates truncation. For listings with this many entries you almost certainly want to be running find inside the sandbox via bhatti exec and processing the results there instead.
Examples
bhatti file ls dev /workspace
drwxr-xr-x 4096 node_modules
-rw-r--r-- 1234 app.js
-rw-r--r-- 256 package.json
-rw-r--r-- 512 README.md
# JSON for scripting
bhatti file ls dev /workspace --json | jq '.[] | select(.is_dir == false) | .name'
Output fields (JSON)
[
{"name": "app.js", "size": 1234, "mode": "0644", "is_dir": false, "mtime": 1761792345},
{"name": "node_modules", "size": 4096, "mode": "0755", "is_dir": true, "mtime": 1761792500}
]
mtime is a Unix timestamp in seconds.
Options
This command takes only global flags. See Global flags for --url, --token, --json, --timing, --data-dir.