Login

Workspace Agent Last updated: 17. Oct 2026

A full-page AI agent that works across all the files in a project. It can search, create, edit, rename, move, copy and delete files — and shows every proposed change for your approval before anything is saved.

Opening the Workspace Agent

  1. Open the folder (project) you want the agent to work in.

  2. Click the 🤖 Assistant button.

  3. The agent opens as a full page, scoped to that folder and everything beneath it.

Tip: while using the inline Document AI Assistant, click 🚀 Workspace Agent to escalate the task to the full agent without losing your place.

The interface at a glance

The screen has a chat panel on the left and a work panel on the right with three tabs:

  • Suggested changes — every file the agent proposes to create, edit, delete, rename, move or copy. Nothing here is saved yet.

  • Diff — a line-by-line comparison of the selected file (before vs. after).

  • Log — the agent's live activity: which tools it ran and what it found.

Making a request

  1. Type what you want in the chat box — e.g. "Create an About page and link it from the menu".

  2. Optionally attach files (drag-and-drop or the attachment button). Max 10 MB per file. Images in JPEG, PNG, GIF and WebP are sent as they are; other formats such as AVIF, HEIC, BMP and TIFF are converted, and every image is scaled to at most 1568 px. SVG files are read as text, and the text of Word .docx files is extracted. The assistant cannot read .doc, .xlsx, .pptx, .zip or PDF attachments, and says so.

  3. Press Enter or click Send. The agent starts working and streams progress into the Log.

  4. Press Esc at any time to cancel the current request.

Tip: be specific about the goal and any constraints ("keep the existing API", "only change files under /news").

Reviewing & approving changes

The agent never writes to disk on its own. In Suggested changes each file is tagged with what will happen: New, Modified, Delete, Rename, Move, Copy (and folder equivalents: rename / move / delete folder).

  • Inspect a change — select a file to open its Diff. Toggle between inline and side-by-side, and step through changes with previous/next.

  • Accept or discard per file — approve only the changes you want.

  • Accept all / Discard all — apply or throw away everything in one click (confirmation required).

  • Revert — undo a file change you already accepted. Publishing and the other workspace actions below cannot be reverted.

Note: if a file changed on disk after the agent proposed its edit, it is flagged as a Conflict and is not accepted by "Accept all". Review it manually first.

Publishing, console, logs and history

Besides the files, the agent can look up what is published where, read the site console and the system log, see who folders and files are shared with, and read the version history — the same information the docly CLI gives you, with the same access rules. IP addresses in logs are shortened before they are sent to the AI.

It can also propose to publish or unpublish, to clear the console and to label a version. These proposals appear in Suggested changes and run only when you click Accept, after the file changes. Changing a publication shows as an unpublish plus a publish. The agent cannot change access rights.

Images

With an image model selected (see Choosing an AI model), the agent can generate and edit image files (.png, .jpg, .jpeg, .webp). Each image is a proposal, shown next to the current one, and is written only when you accept it. Extra variants are named name-2.png and so on.

The agent can also put images into documents — an image you pasted or attached in the chat, or one that is already in the workspace.

Web pages

The agent can read web pages you point it to. Only public HTTPS addresses work; addresses on internal networks are refused. Long pages are read in parts.

Chats (sessions)

  • New chat — start fresh (current chat saved automatically).

  • Select chat — switch between saved conversations.

  • Rename / Delete chat — keep the list tidy.

  • Cleanup — delete all chats older than 30 days in one action.

Cost & usage

  • The header shows the cost of the current session.

  • It also shows your AI usage this month against the monthly limit (default $100, resets on the 1st).