Go read

To list directory contents and view files safely, use read-only commands like ls, cat, and pwd. These non-destructive operations inspect filesystem data and resolve absolute paths without risking modification to the local environment.

You can inspect filesystem paths and disk usage using a defined allowlist of read-only commands: ls, cd, pwd, cat, less, and du. These are constrained by an argv array and optional cwd to ensure safe, non-destructive operations.

Yes, you can use cd and ls to explore local directory structures without write permissions. The tool operates using strictly read-only commands to list directories, view small files, and resolve paths safely on a local machine.

The best way to verify file contents and compute disk usage is by using read-only commands like cat and du. This approach provides safe directory listing, file viewing, and path resolution for local environments.

A limitation when using read-only commands is that the tool is designed for viewing small files. It uses an allowlist of non-destructive commands like less and cat, which may not be optimal for inspecting very large files.

You do not need to specify a working directory, but you can provide an optional cwd to constrain the operation. The command requires a defined command from the allowlist and an argv array to execute safely.