Skip to main content
SHARED FILESYSTEM

​
Every file your agents touch, in one place.

Upload documents to company knowledge. Browse per-agent memory, instructions, and outboxes. Edit anything inline. Your agents read and write here in real time.

The workspace

​
One filesystem, two views.

The Files page is described by its own header: “A shared filesystem your agents read from and write to. Upload documents to knowledge buckets, or browse per-agent memory, instructions, and outboxes.” A pill switcher at the top flips between Company (shared knowledge accessible by every agent) and Agents (one folder per agent, containing memory logs, context briefs, execution artifacts, and any files it has written during runs, labeled with the agent’s display name and showing a “{N} Folders · {M} Files” count in the workspace header). The underlying filesystem is the same, the view changes what you browse.

live
Total files:·Indexed size:·Knowledge buckets:·Last sync:
docs/
policies
12 files · 4 folders
products
28 files · 2 folders
crm
57 files · 8 folders
md
brand-voice.md
Tone of voice: direct, warm, zero filler. Short sentences win. No exclamation marks.
18 KB · company/docs/
pdfextracted
pricing-2026.pdf
Pro plan pools usage across the team; Basic is single-seat with a monthly reset.
2.4 MB · company/products/
json
integrations.json
{“slack”:{“webhook”:”…”, “channel”:“#ops”}, “stripe”:{…}}
3.1 KB · company/ops/
Agents:·Folders:·Files:·Last sync:
M
Maya
14 folders · 89 files
F
Finance Bot
6 folders · 41 files
S
Support Agent
4 folders · 27 files
R
Research
4 folders · 161 files
md
TODAY.md
09:14, Northwind call: slides not PDF. 11:02, Invoice #2041 escalated.
agents/maya/memory/
csv
report-q3.csv
date,revenue,pipeline,notes: 2026-06,…
agents/maya/outbox/
Choosing between Company and Agents is a question of audience. If other agents need the file, it belongs in Company. If it is specific to one agent’s memory or outputs, it lives under Agents.
At a glance

​
What the four stats tell you.

The hero strip at the top of the Files page gives you a live read on the state of your workspace.

Total files

Count of every file tracked across both workspaces, company files and all agent folders. Useful for auditing how much material your agents have generated or been given over time.

Indexed size

Total volume of content chunked and indexed for semantic search. Uploaded documents are converted to .extracted.md sidecars; this tile shows how much knowledge is live and searchable right now.

Knowledge buckets

Number of named knowledge buckets in your Company workspace. Buckets organise files by topic · for example, docs, policies, products. The “all healthy” sub-label confirms every bucket is indexed and accessible.

Last sync

Timestamp of the most recent file-system event processed by the live sync listener. “Auto-reindex on write” means you do not need to trigger manual reindexing. Every agent write or upload is picked up automatically.
A pulsing live badge in the page header confirms that realtime file sync is active. If it ever disappears, click Refresh to force a full reload.
Navigation

​
Browse and open a file.

Open Files in the sidebar

Click Files in the sidebar. The page loads and defaults to the Company workspace if it has files.

Switch to the workspace you need

Click Company or Agents in the workspace switcher. Company shows shared knowledge files. Agents shows one folder per agent, each labeled with the agent’s display name.

Enter a folder

Click any folder card to enter it. The breadcrumb bar at the top updates. Click any crumb to jump back up a level.

Search within a workspace

Type in the search bar (placeholder: “Search company files…” or “Search agent files…”) to filter file names in place. Search is case-insensitive and recurses through folders. Click X to clear. Note that search resets when you switch between Company and Agents.

Click a file to preview it

Click any file card (tooltip: “click to preview”) to open the full-screen preview dialog. Text-type files (.md, .json, .yaml, .csv, .log, .txt) show up to 240 characters of content directly on the card before you open them.
Files · Company workspacelive
142Total files
38.4 MBIndexed size
6Knowledge buckets
just nowLast sync
Search company files…
policies12 files · 4 folders
products28 files · 2 folders
mdbrand-voice.mdTone of voice: direct, warm, zero filler…
pdfextractedpricing-2026.pdfPro plan pools usage across the team…
jsonintegrations.json{“slack”:{“webhook”:”…”}}
Preview and edit

​
Inside the preview dialog.

Actionist detects the file type and opens the right editor automatically. The dialog header always shows the file’s byte size, full path, type label, and current save state. Click a file type to see how it looks:

company/docs/brand-voice.md · 18 KB · Markdown
UnsavedSave
BIH1H2LinkCodeSource mode
Brand Voice Guidelines

Tone of voice: direct, warm, zero filler. Short sentences win. No exclamation marks. Write like you are briefing a smart colleague, not selling to a stranger.

When in doubt, cut the adjective.

1,840 chars · 42 lines

Files with .md, .markdown, or .mdx extensions open in the @mdxeditor/editor rich-text editor. Use the Rich text / Source mode toggle (top-right of the toolbar) to switch views. The orange Unsaved pill appears whenever edits diverge from the saved version. A three-button modal appears on close if changes are unsaved: Save changes, Discard changes, or Continue editing.

agents/maya/memory/TODAY.md · 4.1 KB · Text
Save
1# TODAY, 2026-06-11
2
3## 09:14 · chat · maya
4- Northwind call: reports as slides, not PDF
5- Saved preference to Memory.md
6
7## 11:02 · workflow · invoice-chase
8- Sent 3 reminders. #2041 escalated.
3,920 chars · 88 lines

Plain text and code files open in a line-numbered textarea. Supported extensions include .txt, .log, .csv, .tsv, .json, .jsonl, .yaml, .yml, .xml, .html, .css, .js, .ts, .py, .rb, .go, .rs, .sh, .sql, and more. The same Save and Unsaved pill behavior applies.

agents/research/outbox/screenshot.png · 3.8 MB · Image
Download
screenshot.png
3.8 MB · inline preview, under 25 MB limit

Image and video files open in a centered lightbox viewer. Supported image formats: .png, .jpg, .jpeg, .gif, .webp, .svg, .bmp. Supported video formats: .mp4, .webm, .mov, .m4v, .ogv. Media files up to 25 MB can be previewed inline. Files larger than 25 MB cannot be previewed. Click Download in the dialog header instead.

agents/maya/outbox/report.xlsx · 890 KB · Spreadsheet
Show in folderDownload
Inline preview is not supported.
Use Download to save the file to disk, or Show in folder to open it in Finder / Explorer.

If Actionist cannot render a file inline, the dialog shows “Inline preview is not supported.” Use the Download button in the header to save the file to disk, or Show in folder to reveal it in Finder or Windows Explorer. Show in folder needs the desktop app, because there is no local folder for a browser to open.

brand-voice.md · preview dialog
company/docs/brand-voice.md · 18 KB · Markdown
UnsavedCopy pathDownloadSave
BIH1H2LinkCodeSource mode
Brand Voice Guidelines
1,840 chars · 42 lines
The orange Unsaved pill only lights up on real user edits. Not when you first open the file. The editor canonicalizes Markdown on load, so the baseline is the canonical form, not the raw bytes.
Knowledge

​
Upload to company knowledge.

Upload a product spec once and every agent can draw on it through semantic search. Without per-agent configuration. Watch a file move through its full pipeline, from drop to indexed:

Pick fileDrop into the Upload Documents dialog, or click to browse. Up to 100 files at once, 10 MB each.
ConvertPDF, DOCX, XLSX are text-extracted. MD, TXT, CSV, JSON index directly, no extraction step.
.extracted.md sidecarExtracted text lands as a plain Markdown sidecar next to the original, immediately readable.
IndexedChunks are embedded and indexed. Every agent’s semantic search returns results from your document on the very next query.
pricing-2026.pdf · 2.4 MBUploading…Extracting text…Uploaded, indexing pending. Searchable shortly.extracted indexed and searchable
runbook.md · 18 KBUploading…indexed searchable immediately · no extraction stepindexed searchable immediately · no extraction stepindexed searchable immediately · no extraction step
No manual reindex needed. Every upload and every agent write triggers the live sync listener automatically. The Indexed size stat updates in real time.
Deleting purges completely. When you delete a file, its .extracted.md sidecar is deleted in the same operation. The content disappears from agent retrieval entirely. No stale chunks remain.
Oversized files skip cleanly. Files over 10 MB are flagged inline and excluded. The remaining valid files in the same drop are still queued and uploaded.
The upload button only appears in the Company workspace. Files uploaded here are accessible to every agent in your workspace. For files that belong to a single agent, browse to that agent’s folder in the Agents workspace and use your operating system or a workflow to place them there.

Click 'Upload to knowledge'

In the Files page header (Company workspace), click Upload to knowledge. Tooltip: “Upload documents to company files.” The Upload Documents dialog opens.

Choose a destination bucket

Use the Destination Bucket dropdown to select which knowledge bucket the files should land in. If a docs bucket exists in your workspace, it is selected by default.

Add your files

Drag files onto the dropzone (“Drop files here or click to browse”) or click to open the native file picker. You can drop up to 100 files at once.Accepted formats: PDF, DOCX, XLSX, XML, HTML, CSV, TXT, MD. Maximum 10 MB per file.Oversized files are flagged inline and skipped automatically. The valid files in the same drop are still queued.

Review the file list

Each queued file shows its name and size. Remove individual files with the remove button, or click Add more files to append to the queue.

Upload

Click Upload N files. A progress indicator appears while the upload runs. On completion, each document is converted to a retrievable .extracted.md sidecar and auto-indexed, no manual reindex step needed.

Done

Click Done to close the dialog. The new files appear in the Company workspace grid immediately, and the Indexed size stat updates to reflect the new chunks.
Upload Documents
Destination Bucket
docs
Drop files here or click to browsePDF, DOCX, XLSX, XML, HTML, CSV, TXT, MD · max 10 MB each
pdfproduct-spec.pdf4.2 MB
mdrunbook.md18 KB
csvpricing.xlsx890 KB
Upload 3 files
Actions

​
What you can do with a file.

Right-click a file card

Right-clicking any file card opens a context menu with two actions:
  • Copy content: copies the full file text to the clipboard. Available for all text-type files.
  • Delete: opens a confirmation modal: “Permanently delete “[name]”? This cannot be undone.” Confirm to delete. Deleting a file also removes its .extracted.md AI sidecar in the same operation, so stale content is fully purged from agent retrieval.
If you delete a file that is currently being written by an active agent run, you are shown two options: Stop run & Delete or Delete anyway. Use “Stop run & Delete” unless you are certain the run can be interrupted safely.
Once a file is open in the preview dialog, the header offers four actions:
  • Copy path: copies the file’s absolute path to the clipboard.
  • Show in folder reveals the file in Finder (macOS) or Windows Explorer. This one needs the desktop app.
  • Download: opens the native save-as dialog to export the file to disk.
  • Save: saves the current editor content.
md
brand-voice.md
Tone of voice: direct, warm, zero filler. Short sentences win. No exclamation marks.
18 KB · company/docs/
Copy content
Delete
Reference

​
Limits at a glance.

10 MBmax upload size per file
100max files per drop
25 MBmax media inline preview
10 MBmax in-app save size
240chars shown in snippet preview
0archives or executables accepted, blocked unconditionally
The 10 MB upload limit is enforced by the app’s validation logic. An older error string in the app reads “50 MB”. That string is stale. The true limit is 10 MB, confirmed in the source.
In practice

​
Agents write here. You find it here.

Every artifact an agent produces lands in its outbox folder the moment the run ends. No chasing threads, no copy-pasting from chat.

”Every artifact an agent produces is sitting in Files before you ask where it went.”

: the workflow, not the person
F
@felix_actionist_bot
ONLINE
Can you pull the May monthly report and save it to Files? 09:03
SEEN · READING CONTEXT
On it. Pulling figures from the ops bucket now. 09:03
TOOL · WRITE_FILE
Done. The report is saved at agents/felix/outbox/may-2026-report.csv: 847 rows, all reconciled. Open it from the Agents workspace anytime. 09:04
Best practices

​
Getting the most from Files.

Upload cross-team knowledge to Company. Company files are accessible to every agent via semantic search. Agent folders are scoped to that one agent. For runbooks, product specs, pricing tables, and anything else your whole workforce needs, upload to Company.
Snippet previews tell you what’s inside. Files with extensions .md, .json, .yaml, .csv, .log, and .txt show the first 240 characters on the card. If a card shows no snippet, the file is binary or unsupported. Use Download rather than editing inline.
The Unsaved pill is your save signal. The orange Unsaved pill in the dialog header appears whenever your edits diverge from the saved version. If it is not showing, your changes are already saved.
Deleting a file purges it from the AI index. When you delete an uploaded file, its .extracted.md sidecar is deleted in the same operation. The content disappears from agent retrieval completely. If you only delete the sidecar manually, the original remains on disk.
Media files over 25 MB cannot preview inline. The 25 MB inline preview cap is enforced at the system level. For large video captures or high-resolution screenshots, click Download in the dialog header to save the file locally.
The Source mode toggle is session-sticky. Switching between Rich text and Source mode is preserved while the preview dialog is open. It resets to Rich text the next time you open any file. Use Source mode when you need to write or inspect raw Markdown. Frontmatter, fenced code blocks, or custom HTML.
Search resets when you switch workspaces. If you searched for a term in Company and then switch to Agents, the search field clears. Re-enter your query after switching.
The Live badge confirms sync is running. The pulsing live badge in the page header (tooltip: “Realtime file sync is active”) confirms the event listener is running. If it disappears, click Refresh to force a full reload. Under normal conditions you should not need the Refresh button.
Desktop differences

​
One control needs the desktop app.

Show in folder is the only file control that depends on the desktop app. It opens the file in Finder or Windows Explorer, and a browser tab has no local folder to open. Everything else on this page, including upload, preview, and download, behaves the same wherever you are working.
Always in sync

​
Your agents are already writing. Now you can see everything.

Open the Files page, upload your first document, and watch your agents draw on it in real time.

Open the DashboardEmail the team

Every file lives on your machine: readable, editable, version-controllable.
Indexed on-device · Auto-synced on every agent write · Nothing leaves your workspace.

Keep going

​
Next steps.

Memory

Understand how memory buckets work, how agents retrieve context, and how to manage what agents remember long-term.

Agents

Configure which agents have read or write access to memory buckets. Set from the Memory tab in the agent studio.

Computer Use

Computer Use runs produce screenshots and session logs that land in the agent’s Files folder automatically.

Schedules

Scheduled agent runs write output artifacts to the Files workspace. Browse them here after each run completes.