Documents in the brain
How it works
PDFs, Word files, images, spreadsheets and other files can be anywhere in the brain, for example next to the topic they belong to. For those that belong nowhere else, the brain has a storage at its root (storage/, in a Czech brain uloziste/) with folders by kind: documents, contracts, invoices, presentations, spreadsheets, images, references and other. Files over 1 MB are kept outside the brain's history, so the brain does not grow with every change of them.
For every file in the storage and every file over 1 MB, the brain writes a Markdown description and saves it next to the file: contract.pdf and contract.pdf.md. The description is created by itself, whether the file comes from the web, the onlybrain app or Claude Code. It contains:
- a summary of the document,
- what is where in the document, each part linked to a page (
p. 3) or a paragraph, - images, charts, stamps and signatures and what they show,
- keywords for search.
The AI then answers from the description and cites the source. Clicking a citation opens the document right at that page.
Upload a document from the computer
- Open Files and editing.
- Click Add document in the top left.
- Drag the files into the window (or click and choose them). PDF, PNG, JPG, WebP, GIF, Word (.docx), TXT and CSV work, up to 25 MB.
- Leave the folder at By the kind of file (PDFs to documents, images to images …), or choose another storage folder, and click Add and describe.
- After a moment the finished description opens. Open document shows the original.
A document from the cloud
A document can stay on Google Drive, Dropbox or OneDrive. Only its description with a link is saved in the brain.
- In the cloud, share the document with anyone with the link and copy the link.
- In the Add document window, switch to From the cloud (link) and paste the link.
- Click Add and describe.
File preview
A file from the storage or the file tree opens right in a preview:
| File | Preview |
|---|---|
| the pages right in the page. Where the browser cannot do that (some Android phones), Open PDF in a new tab or download it. | |
| images (PNG, JPG, GIF, WebP, SVG, AVIF and more) | pan and zoom |
| draw.io diagram | pan, zoom, pages as tabs, layers |
| Word (.docx) | the document's text |
| Excel (.xlsx), CSV, TSV | a table, with sheets for Excel |
| PowerPoint (.pptx) | an outline of the slides |
| audio and video | a player |
| text and code | the file's content (up to 2 MB) |
What has no preview can be downloaded and opened on the computer.
Images and draw.io diagrams move like the brain map:
| Key or gesture | What it does |
|---|---|
| drag, arrows | pan |
| scroll wheel, pinch, + and - | zoom in and out |
| double-click or double tap | zoom in (with Shift, zoom out) |
| 0 | show all |
| 1 or a click on the percentage | actual size |
| Page Up and Page Down | previous and next page of the diagram |
| F | full screen, Esc ends it |
Links in a draw.io diagram open in a new tab. Only links to the web and to e-mail work.
What never gets written into the brain
In Settings → File storage, the brain manager sets:
- Never write down, in their own words: for example "employee salaries", "health conditions", "contract numbers with the bank". The AI leaves this information out of the description entirely.
- Always hide: birth numbers, account numbers, card numbers, e-mails, phone numbers. These are removed from the description automatically, even if the AI wrote them.
The rules apply to every new description. An older description can be written again with Describe again on the document.
Who sees a document
Access to the storage is set in the role (the Storage part), by folder. Whoever sees a file sees its description too, and the other way round: a hidden file has no visible description either.
A brain created before the storage
An older brain kept files among the notes. In Settings → File storage, turn the storage on and then, in one step, Move into the storage every file that is not Markdown: the files move together with their descriptions, links in notes are updated, and every role still sees exactly what it saw before.
Add a description in Claude Code
When a description is missing (a file the server cannot describe, like Excel), the /describe-files skill adds it:
/describe-files storage/spreadsheets/budget-2026.xlsx