Uploading a document
Open the Document Panel
Click the Paperclip icon in the message input toolbar, or press ⌘D. The Document
Panel slides open on the right side of the chat window.
Upload
Either:
- Drag and drop one or more files directly onto the Document Panel, or
- Click the Upload button and use the file browser to select files
Wait for parsing
Each document card shows a
Parsing spinner while the background worker extracts text.
When parsing completes, the card shows Done and displays the chunk count.Parsing is non-blocking — you can continue chatting while it runs.Per-session toggle
Each document has a toggle that controls whether it’s injected into the context for the current session. You can:- Active (toggle on): Document content is included in the next query’s context
- Inactive (toggle off): Document is uploaded and parsed, but not injected
Document card information
Each document card displays:| Field | Description |
|---|---|
| Filename | Original file name |
| Size | File size in KB or MB |
| Status | Parsing / Done / Error |
| Chunk count | Number of text chunks the document was split into |
| Active toggle | Whether the document is included in the current session |
Removing a document
Click the ✕ button on a document card to remove it. Removing a document:- Deletes its parsed chunks from
mira.db - Removes it from all sessions it was active in
- Does not delete the original file from your disk
Context usage indicator
The status bar at the bottom shows the total context usage including all active documents. If documents push the context over the engine’s budget, older conversation history is compacted automatically (NAE) or the most relevant chunks are selected (RLM).Related
Supported Formats
Every format MIRA can parse
Document Chunking
How MIRA splits documents into context-sized pieces