Files, folders and reports
Kin Browser's agents work on the web. Your computer's files are closed to them until you open a folder, one at a time.
Letting an agent use a folder
Under Settings → Files & folders:
- Ask me each time (the default): when an agent wants a file or a folder, the Grid asks you. Allow once (until Kin Browser closes), Always, or Decline.
- Off: no agent reads or saves anything on this computer.
A yes covers that path and everything under it. Reading and saving are asked separately: a folder you allowed for reading is not one an agent may save in. You can also add a folder yourself, with or without saving, and take any of them back from the same place.
The save folder (Save files to, in the same place) is Downloads unless
you choose another. Your downloads in Kin Browser and Ask Kin's reports go
there, and agents may save there without asking: a file name alone
(report.md) lands in it. Reading from it still asks, like any folder.
Some places are never opened, whatever you allow above them:
- keys and secrets:
.ssh,.gnupg,.aws,.azure,.kube,.docker,.netrc, the keychains,.password-store,.config/gcloud; - Kin Browser's own data.
A link inside an allowed folder is followed to where it really leads, and that place needs its own yes.
What agents can do
| Command | MCP tool | Does |
|---|---|---|
kin-browser files <folder> [--depth 1-3] | list_files | What is in a folder (500 items at most) |
kin-browser read-file <path> [--max chars] | read_file | A text file, or a PDF, Word, Excel or PowerPoint file as text and tables (25 MB at most) |
kin-browser save-file <path> --text "…" [--overwrite] | save_file | Save text as a file; never replaces one unless told to |
Paths are whole paths: ~/Documents/brief.pdf. When an agent is told "a
person has been asked", it waits and tries again; when you decline, it stops
asking for that path.
The built-in agent (Ultra) uses them too: "Read ~/Documents/specs/checkout.pdf, test the checkout against it, and save the report to ~/Documents/QA."
Reports of Ask Kin's tasks (Ultra)
When a task ends, its log (under Ask Kin, and on Tasks & questions) offers:
- Save as PDF: the goal, the answer and its sources, every step with where it landed and the site's HTTP answer, what was said along the way, what went wrong on the page, and the cost.
- Save as Markdown (.md): the same, for a ticket or a document.
The file goes straight into your save folder (Downloads unless you chose another), named after the task
(kin-report-<goal>-<id>.pdf), never over another file; Show in Finder
opens it there. It is made on your computer from the task's own record, and
nothing is sent anywhere.