Skip to main content

Files and permissions

Symptoms​

  • the agent changed files outside the task;
  • the agent cannot read or change the file you need;
  • you need to hide secrets from being read;
  • the agent stops and asks for permission to use a tool.

What to check​

  1. The current Edit Scope.
  2. The .readignore and .writeignore rules.
  3. Whether the selected agent mode is allowed to read and edit.
  4. The settings of the corresponding tool in the Tools menu.
  5. Whether the file is outside the allowed external paths.

Fix​

If the agent changes unnecessary files, set Edit Scope before sending the request. To block writes permanently, add the path to .writeignore. To block both reading and writing, use .readignore.

If a file you need is unavailable, check the ignore rules and the external path settings. Do not unblock a whole directory when allowing a single file is enough.

If Explyt asks for permission, check the tool, the call parameters, and the possible consequences. For safe repeated actions you can allow the call without confirmation; for the terminal, external systems, and irreversible operations it is better to keep confirmation on.

After the changes, review Agent Changes and make sure the diff did not go beyond the agreed area.