# Permissions

Dirent operates entirely offline, ensuring all your data remains on your computer. For the app to navigate through folders effectively, certain permissions are necessary.

### Folders (MacOS AppStore only)

You have control over which folders Dirent can access. If you try to access a folder outside the specified range, the app will notify you that it cannot read these locations. For the best experience, it's recommended to select the root folder ("/"). This allows for seamless navigation throughout your entire file system.

### Full Disk Access (MacOS)

Granting this permission is optional and needed only for accessing certain system folders like Trash, Mail, and Safari, which require special permissions. If you wish for Dirent to operate within these folders, you need to manually enable this permission. Go to MacOS System Settings, then navigate to Privacy & Security -> Full Disk Access, and toggle the setting for Dirent.

<figure><img src="/files/1AaQXhI3TbcuArprtt0s" alt="" width="375"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dirent.dev/security/permissions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.