Inspect and retrieve files from your running app

Read and export files from approved React Native app directories to investigate logs, caches, and other local data.

FileSystem tools help you inspect the files behind a problem and retrieve them for closer analysis. Start with read-only access to approved directories; enable file changes only when a local debugging workflow needs them.

Register the Suite

await Ansight.initializeAndActivate(
  Ansight.createOptionsBuilder()
    .withFileSystemTools({
      additionalRoots: [{ alias: "exports", path: "/tmp/app-exports" }],
    })
    .withReadOnlyToolAccess()
    .build(),
);

Registration API

withFileSystemTools(options): configures native file-system tool options.
remoteTools.fileSystem.additionalRoots: exposes additional approved roots.

Specific Concerns

All access is constrained to approved native roots.
File contents are sensitive even when only read tools are enabled.
Write tools require withReadWriteToolAccess() or withAllToolAccess().
Critical tools such as files.delete_file require withAllToolAccess().

Tool Matrix

Name	Id	Policy	Description
`List Directory`	`files.list_directory`	`Read`	Lists files and folders inside approved roots.
`Read File`	`files.read_file`	`Read`	Reads a constrained file.
`Get File Checksum`	`files.get_file_checksum`	`Read`	Computes file checksums.
`Download File`	`files.download_file`	`Read`	Downloads chunks through JSON fallback.
`Begin Binary Download`	`files.begin_binary_download`	`Read`	Starts binary download for a constrained file.
`Push File`	`files.push_file`	`Write`	Writes caller-provided content into an approved root.
`Copy File`	`files.copy_file`	`Write`	Copies a constrained file.
`Move File`	`files.move_file`	`Write`	Moves or renames a constrained file.
`Delete File`	`files.delete_file`	`Critical`	Deletes a constrained file.

Tool Details

Use read tools for inspection and download. Enable write and critical tools only for specific local repair workflows.