Workspace

Voxta Utilities: Workspace lets an assistant read and write real files in the folder a chat works in, shown as a tree beside the chat.

Voxta Utilities: Workspace gives an assistant file tools over the folder its chat is working in, and shows that folder as a file tree beside the chat. What it writes is real and stays on disk after the chat ends.

Experimental. It writes real files on the machine Voxta runs on. It only works for an administrator whose account has a password, checked again on every chat.

Setup

Nothing to add: it is installed with Voxta.

Administration → Workspaces: add a workspace — a name and a folder — and set its rules (below).
In an Assistant chat, pick it from the chat's workspace menu (or browse to a folder). It takes effect on the next reply, without reopening the chat.

Where it can work

The workspace — the folder the chat was given. A chat starts with none.
The scratch folder — the chat's own folder, always writable. With no workspace, the tools work here only.

Paths outside these two are refused. System folders cannot be used as a workspace.

Tools

Tool	Does
Get Working Folder	Says which folder the chat works in, or that it has none.
List Files	Lists a folder.
Read File	Reads a text file, cut off at Max File Size.
Search Files	Finds files containing a piece of text (case-insensitive, up to 50 matches).
Write File	Creates or replaces a whole file. Missing folders are created.
Edit File	Replaces one exact passage in a file.

Write File and Edit File are treated as destructive — they can overwrite what was there — so they go through the chat's tool permission prompt.

Needs a model that supports tool calling.

Workspace rules

Set per workspace on the Workspaces page, not on the service:

Chats may change files here — off makes the workspace read-only. The scratch folder stays writable.
Never read — .gitignore-style patterns. Matching files are not listed, read or searched, by the chat or the file tree.
Assistant — who a chat starts with when started for this workspace.

Service settings

Setting	Notes
Available Tools	Which tools to offer. Clear them all to switch the tools off without removing the module.
Offer Tools In	Chat styles the tools are offered in. Assistant only by default; a character that names the `workspace` augmentation gets them in any style.
Max File Size (KB)	How much of a file a read returns. Default 128; larger reads cost context.

Notes

Only in the Voxta app, which can show the file tree. Not in the Playground, and never in chats the server runs on its own.
When the LLM is a coding CLI with its own file tools (Claude Code or Codex with agentic tool use on), these tools stand down; the tree still shows the folder.
The folder paths are placed in the chat's context, so the model knows where it is working.