Step 4

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

  1. Open Files and editing.
  2. Click Add document in the top left.
  3. 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.
  4. 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.
  5. 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.

  1. In the cloud, share the document with anyone with the link and copy the link.
  2. In the Add document window, switch to From the cloud (link) and paste the link.
  3. Click Add and describe.

File preview

A file from the storage or the file tree opens right in a preview:

FilePreview
PDFthe 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 diagrampan, zoom, pages as tabs, layers
Word (.docx)the document's text
Excel (.xlsx), CSV, TSVa table, with sheets for Excel
PowerPoint (.pptx)an outline of the slides
audio and videoa player
text and codethe 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 gestureWhat it does
drag, arrowspan
scroll wheel, pinch, + and -zoom in and out
double-click or double tapzoom in (with Shift, zoom out)
0show all
1 or a click on the percentageactual size
Page Up and Page Downprevious and next page of the diagram
Ffull 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:

Example prompt
/describe-files storage/spreadsheets/budget-2026.xlsx