wiiiv operates inside an isolated sandbox for safety. By mounting a folder, you allow wiiiv to read and modify files in that folder.
Why
Why do I need to register folders?
The wiiiv AI agent operates inside a sandbox.
A sandbox is an isolated workspace that acts as a fence,
preventing the agent from freely accessing any file on your computer.
Typical AI tools can access your entire computer when you say "read the file on my desktop."
Convenient, but risky. wiiiv takes the opposite approach: the agent can only access
folders you explicitly allow. This "allowing" is what we call a mount.
Mount = a pathway that connects an outside folder into the sandbox
In short: the sandbox protects, and mounts open up only what you need.
No need to upload files one by one, and at the same time, access to unauthorized files is blocked.
What
What you can do with mounts
Once a folder is mounted, you can request file operations naturally during a conversation,
like "summarize this month's files from the reports folder."
📂
Folder-level access
Register an entire directory. All files and subfolders become accessible.
🏷
Easy access via labels
Give names like "Reports" or "Server Logs" and reference them by label in conversation.
🛡
Exposed only when needed
Only mounts relevant to the conversation context are visible to the agent.
⚡
Real-time sync
Files added or modified inside the folder are reflected instantly. No re-registration needed.
Where
Where to find it
Click the ⚙️ Settings icon at the bottom of the left sidebar,
then select the "Mount" tab at the top.
wiiiv — Settings
💬
📁
📚
⚡
⚙️
Profile
Connections
Memory
API Keys
AI
Mount
Preferences
About
Mount
Register local folders that wiiiv can access.
/home/user/documents/reports
📁
Reports
+
Reports
/home/user/documents/reports reports_2fe
×
Server Logs
/var/log/myapp myapp_a3b
×
Project Source
C:\Users\me\dev\project project_8cd
×
Each mount is assigned an auto-generated mountId (e.g., reports_2fe). It is used along with the label for file access.
Register
Registering a mount
1. Enter a path or browse for a folder
Type the path directly, or click the 📁 button to select a folder from the browser.
2. Assign a label (optional)
Give the folder an easy-to-remember name. If left empty, the folder name becomes the label.
3. Click + to register
Once registered, it is immediately active. You can use it starting from your next conversation.
4. Done
The list displays the label, path, and mountId.
Folder browser
Clicking the 📁 button opens a modal where you can browse the server's file system.
It provides shortcuts to the home folder and drive roots, along with path navigation.
Select Folder
Select Folder
×
🏠 Home📁 Drives|//home/user/documents
📁reports
📁invoices
📁photos
📁templates
In the Desktop app, you can select Windows/Mac folders directly. In server (Web) mode, you browse the server's file system.
Usage
Using mounts in conversation
Once a mount is registered, you can mention files in that folder or request operations during a conversation.
wiiiv analyzes the conversation context and automatically recognizes the relevant mount.
wiiiv — Chat
You
Show me the list of files from this month in the reports folder
wiiiv
Here are the files in the reports folder:
ls mounts/reports_2fe/
───────────────
2026-07-01_weekly-report.docx
2026-07-08_monthly-results.xlsx
2026-07-10_meeting-notes.md
project-summary.pdf
wiiiv — Chat
You
Extract and summarize today's errors from the server logs
wiiiv
I extracted today's ERROR logs from the server logs (myapp) folder.
A total of 3 errors were found:
1. 09:12 — NullPointerException at UserService:142
2. 11:45 — TimeoutException: DB connection pool exhausted
3. 15:33 — FileNotFoundException: /tmp/cache/session_abc
You can access mounts using either a label or mountId.
If you say "reports folder," wiiiv automatically finds the mount labeled "Reports."
When multiple folders are mounted, mounts unrelated to the conversation are not exposed to the agent. wiiiv analyzes context and selects only what is relevant.
Mechanism
How it works
Once a mount is registered, the following happens internally.
Path registration
The sourcePath and label are saved, and a unique mountId is generated from a combination of the folder name and a hash.
Symbolic link creation
Inside the sandbox, mounts/{mountId}/ → is linked to the actual folder.
Relevance check during conversation
The user's message is compared against mount labels, and only relevant mounts are made available to the agent.
File access execution
The agent reads or analyzes files using paths like mounts/Reports/file.txt.
Security
Security
Because mounts allow file system access, several safeguards are in place.
🚫
System paths blocked
/etc, /usr, Windows system folders, and similar paths cannot be registered.
👁
Minimal exposure
Mounts unrelated to the conversation are not visible to the agent.
🔒
API session isolation
Mount access is automatically blocked during external API operations.
Mounted folders allow not only reading but also writing. If you have important original files, back them up before registering, or create and register a copy of the folder.
Tips
Usage tips
📋
Use clear labels
Specific names like "Server Logs" or "Sales Data" help wiiiv understand context more accurately.
📦
Separate by purpose
Registering folders by purpose rather than one large folder improves relevance detection accuracy.
🗑
Remove when unneeded
Mounts you no longer need can be removed instantly with the × button. Original files remain untouched.
🔄
Auto sync
Mounts are symbolic links, so files added or modified in the original folder are reflected instantly.
First time using mounts? Say "show me the mount list" in a conversation to see your registered folders and how to access them.
Although wiiiv's DACS and HazardGuard do their best to prevent destructive actions in advance, they cannot guarantee 100% safety. Files in mounted folders are reflected in the actual file system. Please exercise extreme caution before performing file modifications, deletions, or moves, and always verify before executing.