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 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.
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.
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.
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…
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.
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.
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.
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.
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 (desktop only) to reveal it in Finder or Windows Explorer.
brand-voice.md — preview dialog
company/docs/brand-voice.md · 18 KB · Markdown
UnsavedCopy pathDownloadSave
BIH1H2LinkCodeSource mode
Brand Voice Guidelines
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.
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.
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
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.
Dialog header actions
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. Desktop-only.
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.
0archives or executables accepted — blocked unconditionally
Limit
Value
Upload: max file size
10 MB per file
Upload: max files per drop
100 files
Upload: accepted formats
PDF, DOCX, XLSX, XML, HTML, CSV, TXT, MD
In-app save: max file size
10 MB
In-app save: blocked extensions
.exe.dll.so.dylib.bat.cmd.sh
Upload: blocked types
Archives (.zip.tar.gz.7z.rar) + executables
Media inline preview: max size
25 MB
Snippet preview: max length
240 characters (markdown-stripped)
Snippet preview: eligible types
.md.markdown.txt.json.jsonl.yaml.yml.csv.tsv.log
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.
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.
Files is only available in the Actionist desktop app. The web app returns an unavailable state for the Files section. All upload, preview, and edit features require the desktop app installed on macOS or Windows.
Every file lives on your machine — readable, editable, version-controllable.
Indexed on-device · Auto-synced on every agent write · Nothing leaves your workspace.
