# File System Tool

The File System Tool enables DinoAI to interact with files in your repository, allowing it to create, modify, read, and search files based on your prompts.

<div data-with-frame="true"><figure><img src="/files/KMvJloGV6FefGr4cAsKT" alt=""><figcaption></figcaption></figure></div>

### Capabilities

| Action          | What DinoAI Can Do                                                                                                                                                                     |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Create File** | SQL models for staging, intermediate, and mart layers; YAML configuration files for sources and documentation; schema.yml and README files; testing configurations                     |
| **Modify File** | Add new columns or properties; update documentation; refactor code to follow standards; fix errors or bugs                                                                             |
| **Read File**   | Understand your project structure; follow your coding patterns; reference existing code when generating new files                                                                      |
| **Search**      | Locate relevant examples, related files, and dependencies between models                                                                                                               |
| **Rename File** | Rename files to follow naming conventions and update references accordingly                                                                                                            |
| **Grep Search** | Scan for specific patterns, column references, or function names; identify all files affected by a refactor or rename; cross-reference model logic, source references, and macro usage |

***

### Security and Guardrails

{% hint style="info" %}
DinoAI always asks for confirmation before creating or modifying files. File operations are limited to your current project, and you have full control over which actions are permitted at all times.
{% endhint %}

***

### Best Practices

* **Be specific with your prompts** — Clearly describe what you want to create or modify so DinoAI can take the right action on the right file
* **Add relevant context** — For modifications, always add the file you want to change as context before running your prompt
* **Review changes carefully** — Always check the preview before accepting any file creation or modification
* **Use** [**`.dinorules`** ](/app-help/documentation/dino-ai/dino-rules.md)— Set up `.dinorules` to ensure consistent formatting and conventions are applied across all files DinoAI creates or modifies


---

# 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.paradime.io/app-help/documentation/dino-ai/tools-and-features/file-system-tool.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.