Agents
An agent is a saved assistant with its own instructions, access and integrations. You pick it in the chat from the Agent selector: from then on the chat works the way you decided, with that agent's folders, email and permissions.
GalleryCreating and editingWorking with an agentToolsConfirmationsLogGranted foldersIntegrations

Gallery
Four ready-made agents. Create asks for the folder they will work on and the agent is ready right away.
| Agent | What it does |
|---|---|
| File assistant | Finds, reads and summarizes the documents in a folder and answers questions about their content. |
| Document organizer | Proposes an order for a messy folder and, if you agree, creates the folders and moves the files. It deletes nothing. |
| Coding assistant | Reads and changes a project's code and can run builds and tests, always asking you first. |
| Mail assistant | Finds, reads and summarizes your emails and writes replies as drafts. It sends only when you ask, and shows you the message first every time. On creation, the editor opens so you can link the account. |
Create an agent from scratch → opens an empty editor.
Creating and editing an agent

| Field | What it is for |
|---|---|
| Name, Description | How you recognize it in the list. |
| Instructions | What it must do and how. A few clear rules work better than a long text, especially with small models. |
| Granted folders | The only folders the agent sees. Optional. The first is where it starts. |
| Can run commands | Turn it on only for agents that need it, like the coding assistant. Every command is shown to you first. |
| Permissions | The actions you allowed forever for this agent, each with Revoke. |
| Integrations | Tick the integrations the agent can use: see Integrations. |
| The email accounts the agent may use: see Email. |
- Save applies the changes; Cancel discards them.
- Delete agent asks for a second click and also deletes its conversations (the action log stays).
- Each agent is a readable JSON file: Open the agents folder shows them, so you can back them up or share them.
Working with an agent

- Use in chat, next to each agent, opens a new chat with that agent. In the chat you can also pick it from the Agent selector at the top: General is the chat with its own access, the others are your agents.
- With an agent picked, the Access panel shows and changes its access, and the log on the right is its own. Automatic roles work as always: the chat turns on files or email when needed, with the agent's access.
- Changing agent in a chat that has already started opens a new chat: a strip asks you first (New chat with … or Cancel). This way what one agent read with its access does not pass to another.
- Conversations with an agent are in the chat history, with its name under the title. Reopening one brings the agent back too.
- Describe the task in your own words: the chat shows the steps it takes (Looks at the folder, Reads, Moves…) and for risky actions it stops on the confirmation card: Allow, Always allow for that kind of action, or Don't allow. After a no it stops and waits for you to say what to change.
What an agent can do
| Tool | What it does |
|---|---|
| Looks at the folder | Lists files and folders (up to 500 entries at a time). |
| Reads | Opens text files, PDFs (page by page) and Word documents (.docx). Long files are read in parts, about a quarter of the model's context at a time, continuing from where the reading stopped: a long PDF no longer fills the whole context. A PDF made only of images is reported as having no text. It also reads Excel (.xlsx and old .xls, one sheet at a time with numbered rows), old Word documents (.doc) and PowerPoint (.pptx and old .ppt, one slide at a time with title, tables and notes). |
| Searches files | Finds files and folders by name (for example *.pdf or invoice*), subfolders included, and optionally only those containing a text, PDF and Word included. |
| Writes | Creates a new text file or replaces its whole content. |
| Edits | Changes just one piece of a text file, leaving the rest as it was (line endings and encoding included). |
| Creates a document | Creates a Word document (.docx) with headings, lists, tables, colors, bold, header and footer with the page number, an Excel file (.xlsx) with sheets, formulas and formatting (colors, number formats, widths, merged cells, frozen rows), or a PowerPoint presentation (.pptx) with a title slide, bullets, tables, colors and speaker notes. It also creates PDFs, with the same syntax and layout as Word. |
| Edits a document | Makes a copy of a Word document, an Excel file or a PowerPoint presentation changing only its contents (texts to replace, Excel or table cells, slide titles and notes, paragraphs or slides added at the end, slides removed): formatting, colors, formulas, images and layout stay as in the original. Old .doc, .xls and .ppt files become .docx, .xlsx and .pptx. The copy of a Word document can also be saved as PDF; a PDF, instead, cannot be edited keeping its layout: it is read and a new one is created. |
| Creates a folder | Including any missing folders in between. |
| Moves | Moves or renames a file or a folder. |
| Deletes | Deletes a file or an empty folder. The file doesn't vanish: it is set aside and can be restored. |
| Runs a command | Only if the agent can run commands. The system command line, at most 2 minutes, not interactive: commands that wait for input stop by themselves. |
| Email tools | If the agent has linked accounts: search, read, save attachments, write drafts, send. See Email. |
| Integration tools | Those of the integrations ticked for the agent, when the request is about them. See Integrations. |
What asks for confirmation
| Action | Confirmation | Can be undone |
|---|---|---|
| Looking, reading, searching | No | — |
| Reading an attachment outside the granted folders | Yes: only that file or the whole folder | — |
| Creating a file or a folder | No | Yes |
| Replacing or editing a file | Yes | Yes (the previous version is restored) |
| Moving or renaming | Yes | Yes |
| Deleting | Yes | Yes |
| Running a command | Yes, showing the command | No |
| Using an integration tool | Yes, showing the data it will receive | No |
| Saving an email draft | No | No (you delete it from your email program) |
| Sending an email | Always, with the full message to review and correct | No |
Always allow applies to one kind of action and to that agent (for integration tools, to the single tool); you revoke it from the editor. Sending email doesn't allow it: it asks every time.
Log and undo

The panel on the right lists everything the agent read, wrote or ran, including denied or failed attempts. Undo puts things back as they were: it deletes a created file, restores the previous content, brings a moved or deleted file back to its place.
If the file was changed again after the action (by you or by another program), undo stops and tells you: better not to undo than to erase later work.
Granted folders
Every path the model asks for goes through a check: it must stay inside a granted folder. For the agent, the rest of the
disk doesn't exist. The check also holds against tricks: paths with .., links and junctions leading outside,
hidden data streams and special Windows paths are refused, and the attempt ends up in the log. A granted folder itself
cannot be moved or deleted by the agent.
Integrations
MCP servers are now called integrations and are no longer added inside the agent. You set them up once on the Integrations page, then in the agent editor, section Integrations, you tick the ones the agent can use. The servers you had added to an agent became integrations automatically, already ticked in that agent.
Smaller models use tools less reliably. For agents, a model marked Good for agents on the Models page is the better choice.
HotMoE is a Virsion project. This guide describes the app as it is today: what is still on the way is marked as such.