Files Manager
File storage with chat attachments and semantic search.
Overview
Files Manager is a QuoxCORE plugin for uploading, previewing, and organising files directly within the platform. Files you upload become available as context in CommanderQ conversations, so the assistant can read and reference your documents without you needing to paste content manually.
The plugin ships in two tiers. The free tier covers basic upload, preview, and storage tracking. The premium tier adds semantic search across file contents, memory integration, PDF text extraction, and higher storage limits.
Free tier: Included with QuoxCORE Premium tier: Paid add-on
File Operations
Upload
Drag files onto the upload area or click to browse. Each upload shows a progress bar with percentage and transfer speed. Multiple files can be uploaded in a single batch.
File size limits depend on your tier:
- Free: 5 MB per file, 50 MB total storage
- Premium: 10 MB per file, 200 MB total storage
Uploads that exceed either limit are rejected before transfer begins.
Preview
Files open in an in-browser preview pane. Supported formats include common image types (PNG, JPEG, GIF, SVG, WebP) and documents. There is no need to download a file to view it.
- Free tier: Basic document preview (images, plain text, code files).
- Premium tier: Full document preview including rendered PDF pages with text extraction.
Storage Tracking
A visual indicator on the Files Manager dashboard shows current usage against your tier limit. The bar changes colour as you approach capacity -- green below 70%, amber between 70-90%, red above 90%.
Chat Attachments
Files uploaded to the manager can be attached to CommanderQ conversations. When you attach a file, its contents are included in the conversation context, allowing CommanderQ to read, reference, and answer questions about the file.
To attach a file:
- Open a chat with CommanderQ.
- Click the attachment icon in the message input area.
- Select one or more files from your Files Manager library.
- Send your message. CommanderQ receives the file contents alongside your text.
This works for text-based files (code, configuration, logs, markdown, CSV) and, on the premium tier, extracted text from PDFs.
Tier Comparison
| Feature | Free | Premium |
|---|---|---|
| Storage limit | 50 MB | 200 MB |
| Max file size | 5 MB | 10 MB |
| Drag-and-drop upload | Yes | Yes |
| Progress tracking | Yes | Yes |
| Image preview | Yes | Yes |
| Basic document preview | Yes | Yes |
| Chat file attachments | Yes | Yes |
| JSON export/import | Yes | Yes |
| Storage usage indicators | Yes | Yes |
| PDF text extraction | No | Yes |
| Semantic search | No | Yes |
| Memory integration | No | Yes |
| ARCHIVIST agent skills | No | Yes |
Semantic Search
Premium tier only.
Semantic search indexes the text content of your uploaded files and lets you search by meaning rather than exact keywords. When you search for "deployment process", results include files that discuss releases, rollouts, or shipping -- even if they never use the word "deployment".
The index updates automatically when files are uploaded or replaced. Search results return ranked matches with highlighted excerpts showing the relevant passages.
Memory Integration
With memory integration enabled, files surface automatically in relevant CommanderQ conversations. If you are discussing a topic that relates to an uploaded document, CommanderQ can reference it without you manually attaching it. This is driven by the same semantic index used for search.
ARCHIVIST Agent
Premium tier only.
The ARCHIVIST is a specialist agent with three file-oriented skills:
- Summarise -- Produce a structured summary of a file's contents. Works on text documents, code files, and extracted PDF text. Output includes key points, structure breakdown, and notable details.
- Compare -- Take two or more files and produce a diff-style comparison. Useful for reviewing configuration changes, contract revisions, or code versions side by side.
- Extract -- Pull specific information from a file based on a query. For example, "extract all email addresses from this document" or "list the API endpoints mentioned in this spec".
These skills are available through CommanderQ chat. Attach a file and ask CommanderQ to summarise, compare, or extract -- the ARCHIVIST handles the execution.
Export and Import
Files Manager supports JSON export and import for backup and migration between QuoxCORE instances.
Export
Export produces a JSON manifest listing all files with metadata (name, size, upload date, tags). File binary data is included as base64-encoded payloads within the export. The resulting file can be saved locally or transferred to another machine.
Import
Import accepts a previously exported JSON file and restores all files and metadata into the target instance. Duplicate detection is based on file name and hash -- if an identical file already exists, it is skipped rather than duplicated.
This is available on both the free and premium tiers.