3. How does direct work with files function?

In the current reference design, this scenario is handled through a synchronization layer. A synchronization service, typically Syncthing, runs on both the client side and the server side. The administrator designates the specific company folders that are to be synchronized. These folders are then transferred to the backend server, where they are mounted into an isolated virtual environment in which CODEXIS AI runs.

For the agent, the synchronized folder then behaves like an ordinary working directory within the VM. The AI can read, edit, and save files back to the same location. The changes are then propagated back through the synchronization layer to the client environment. The user therefore does not perform manual uploads or downloads of individual files.

It is important to note that the AI does not automatically have access to the entire company disk or network. Access is limited to the explicitly configured and synchronized folders that are mounted into the runtime. This makes it possible to control the scope of data the agent can work with.