Files

Every project can have files the agent can read, write, and edit. Where those files live depends on the project's mode.

Cloud mode

Files are stored in Avi's cloud storage, scoped to your project. The agent can:

• List files in the project.
• Read any file.
• Write new files.
• Edit parts of existing files.
• Delete files.

Files persist for as long as the project exists. Upload from the web app or let the agent create them as it works. Size limits apply — you'll see them in the UI.

Local mode

In local mode, the project is bound to a device (your computer, via the desktop app). The agent reads and writes files on that device — no cloud copies.

The agent gets scoped access to directories you've approved through the desktop app. If it asks to read or write somewhere outside the approved scope, you'll be prompted.

Which to pick

• Cloud mode is the right default for research, content, notes, reports, and anything that doesn't need to touch your local machine. Works from any browser.
• Local mode is right when the agent needs to work with your codebase, run terminal commands, or touch files on your machine.

You choose the mode when you create a project, and you can't change it afterwards. If you want to convert, make a new project in the other mode and copy what you need over.