Projects and files

Everything the agent works on lives in your workspace storage. Projects give that storage structure, attachments bring your files in, and the Files page lets you manage all of it from the browser.

Projects

A project is a folder in your workspace storage. Each session belongs to one project, and that project's folder is the agent's working directory: code it writes, files it downloads and outputs it produces all land there.

Every account starts with two projects, Project 1 and Project 2. Use them as they are, or create more. Create a new project whenever you want a separate working directory, for example one project per codebase, client or research topic. Sessions in different projects do not share a folder, which keeps the agent focused and your files organized.

The Attachments folder

Each project contains an Attachments folder. When you attach a file to a message in the chat, Windlass saves it there, and the agent can open it by path:

/workspace/Project 1/Attachments/quarterly-report.xlsx

Because attachments are ordinary files in the project, they stay available for the rest of the session and in every later session in the same project. You can also reference them with @ in the message box.

Images and OCR

When you attach an image, Windlass runs text recognition on it and saves the result as a text file next to the image, ending in .ocr.txt. The agent reads that file to work with the text in a screenshot: an error message, a table from a slide, a scanned page. Attach the screenshot, tell the agent what you need, and it finds the text itself.

The Files page

The Files page in your account gives you a full view of your project folders. From there you can:

• Browse every project and folder.
• Upload files directly into any project folder, including large datasets that would be awkward to attach in chat.
• Download anything the agent created, from a single script to a generated report.
• Rename files and move them between folders and projects.
• Delete files you no longer need.

A storage meter shows how much of your plan's storage you are using.

Storage and upload limits

Storage counts every file in every project, including attachments, OCR text files and anything the agent generates. If a project fills up with build output or temporary data, ask the agent to clean up, or delete the files from the Files page. Upgrading your plan raises both limits immediately; see Billing.

Tips

• One project per codebase. Keep a repository and its dependencies in their own project so paths stay predictable and unrelated files never end up in the agent's context.
• Put reference material in the project. Specifications, style guides and data files uploaded once through the Files page can be referenced with @ in every session.
• Download what matters. Files are yours to take at any time. Download deliverables when a task is finished, and before you delete anything.
• Watch the meter. Large datasets and generated media can fill storage faster than you expect. The storage meter on the Files page always shows where you stand.
• Name files clearly. q3-revenue.csv is easier for both you and the agent to refer to than export(3).csv.