Desktop & devices
Connect local folders
How to use folders on your computer with the agent in the desktop app.
The desktop app runs the file operations the agent requests on your computer. The contents of files the agent reads are sent to the Keural server and the AI model to generate answers. To keep file contents from leaving your computer, choose a local model or Spark.
Connect folders
- Under the chat input, select Cowork and click Add folder. In code mode, click + → Add folder in the input box.
- Choose the folder you want to work with. You can connect more than one folder.
- Send a message. The agent finds and reads files only inside the folders you connected.
Conversations with connected folders can only be continued in the desktop app.
Approval by action
The table below applies to the default approval mode, Ask. If you change the approval mode, some of these actions run without asking.
| Action | Approval |
|---|---|
| List files, search file contents, read files and documents, view git status and changes | Not required |
| Edit files, write new files, create document files | Required |
| Move or delete files, edit multiple files at once | Required |
| Run shell commands (including background runs) | Required |
| Git commit and push | Required |
| Operate web pages or other apps | See Browser and app control |
If the agent tries to access a path outside the connected folders, you are asked for approval again.