Skip to content
Service status

Type to search

Local folders · 5 min read

Technical details

Supported browsers, how a connected folder is reached, what is sent where, and the limits on what an assistant can read.

This page describes how Local folders works: which browsers support it, how the assistant reaches a folder on your computer, and the limits it works within.

Supported Google Chrome and Microsoft Edge, on Windows, macOS and Linux
Not supported Firefox, Safari, any browser on a phone or tablet, and the Intric desktop app

Local folders is built on the browser’s File System Access API, which lets a web page read a folder the user picks. Only Chromium-based desktop browsers provide it. In any other browser, the + menu says To connect a folder, open Intric in Chrome or Edge on a computer.

Intric’s servers cannot reach your computer. Your browser does the reading, and Intric asks it for what the assistant needs.

  1. You pick a folder. The browser’s own folder picker opens, and the browser asks you to confirm that Intric may view its files. Intric asks for read access only, so it has no way to change anything in the folder.
  2. The browser connects to Intric. While Intric is open, the tab keeps a secure WebSocket connection to Intric, signed in as you, and tells Intric which folders it holds.
  3. The assistant asks. When an assistant with Access local files needs something from an attached folder, Intric sends the request to the browser that holds the folder, and only to that browser.
  4. The browser reads and answers. It lists, searches or reads the files on your computer and sends back the result. Intric passes it to the language model as part of the assistant’s answer.

Intric then knows the folder only by its name and an identifier. The files themselves stay on your computer and are not copied to Intric in advance.

  • To Intric and the language model: the results of each step the assistant takes — file names and paths when it lists or finds files, matching lines when it searches, the contents of a file when it reads it. These are stored in the conversation like an uploaded file.
  • Kept in your browser: the list of folders you have connected, and the browser’s permission to read them. They are stored per Intric account, in this browser only. Signing out keeps them; Forget removes one.
  • Never sent: anything in a folder the assistant didn’t open, and anything in a folder that isn’t attached to the message.

Word and PowerPoint files are the exception to “the browser reads”: the browser sends the file to Intric, which extracts its text the same way it does for an upload, and passes the text to the model.

  • Only attached folders. A folder you connected but didn’t attach to the conversation cannot be read. Intric checks this before it contacts your browser, against the folders attached to the message being answered.
  • Only your own browsers. A request goes only to a browser signed in as you. No one else’s assistant or conversation can reach your folders.
  • Read only. Nothing can be created, changed, moved or deleted.
  • Hidden files are never read. Files and folders whose names start with a dot are skipped and cannot be opened, even when asked for by name. So are node_modules folders, Office lock files (~$…), desktop.ini, Thumbs.db, and iCloud placeholders for files that aren’t downloaded.
  • Not in widgets or the API. They have no browser to read from, so the tool is never offered there.

Intric can only reach a folder while Intric is open in the browser that holds it.

  • One tab serves the folders. If you have Intric open in several tabs, the first one serves the folders and the others follow along. If you see Another Intric tab took over these folders, reload the page.
  • A background tab keeps working. You can switch to another tab or window while the assistant reads. A browser that puts a tab to sleep can pause it; the tab picks up again when you return to it.
  • A restart asks again. After the browser restarts, it wants your permission again before Intric may read the folder. The folder shows Needs a click; pick it from the + menu to allow it.
  • Another computer works too. A folder you connected in Chrome on your work laptop can be attached from another computer, as long as Intric is still open on the laptop. Otherwise the folder shows Offline.

If the browser holding a folder doesn’t acknowledge a request within 5 seconds, or doesn’t answer within 60 seconds, the step fails and the assistant tells you so.

Folders connected per browser 20
Folders attached to one conversation 50
Listing Up to 3 levels deep, at most 500 entries
Finding files At most 500 files per step
Searching At most 500 matches; stops after 40 seconds or 200 MB read, and says which paths it covered
Reading At most 200,000 characters per step; the assistant continues from where it stopped
PDF and Excel files Up to 20 MB
Word and PowerPoint files Up to 8 MB
Images Up to 4 MB
PDF pages as images Up to 5 pages per step
Type How it is read
Text files (.txt, .md, .csv, .json, code and similar) As text. UTF-8, with Windows-1252 as a fallback; UTF-16 when the file starts with a byte-order mark
PDF Text, page by page. Charts, pictures and scanned pages have no text, so the assistant can ask for those pages as images instead
Word (.docx) and PowerPoint (.pptx) Text, extracted by Intric
Excel (.xlsx) Rows, sheet by sheet
Images (PNG, JPEG, WebP, GIF) As an image the model can look at. For a GIF, only the first frame
Not supported Older Office formats (.doc, .xls), ZIP archives, and other binary files

Searching covers the contents of text files, PDFs and Excel files. It skips images, binary files and files over 20 MB, and it does not look inside Word or PowerPoint files, because their text is only extracted when one is read. To find something in a folder of Word documents, the assistant finds the likely files by name or date and reads them; naming the file or the period in your question helps it.

A scanned PDF has no text to search. The assistant can still look at its pages, five at a time, if the model it uses can read images.