Use Kept
Add documents
Kept answers only from the documents you give it. Add runbooks, READMEs, specs, policies and handbooks as files, or point Kept at a folder or Git checkout and it keeps up as they change.
What Kept can read
| Kind | Files | Notes |
|---|---|---|
.pdf | Scanned PDFs too: pages without text are read with Apple's on-device text recognition. | |
| Word and RTF | .docx, .rtf | Headings and lists are kept. |
| Text and Markdown | .txt, .md, .markdown | Markdown headings become sections Kept can cite. |
| Web pages | .html, .htm | Notion and Confluence HTML exports included. Scripts and styles are dropped, never run. |
| Photos of documents | .png, .jpg, .heic, .tiff | Read with on-device text recognition. |
Each file can be up to 200 MB. Kept reads the text, not the layout: tables come through as rows of text, and images inside documents are skipped.
Add files
- Drag files or folders onto the Sources page, or
- Click Add files… (or File → Add Documents…) and choose them.
Kept keeps its own copy of each file, so the original can move or change without breaking anything. A file added twice is only read once. Adding a folder adds every readable file inside it, skipping hidden files.
Keep a folder or Git checkout in sync
For docs that change, sync the folder instead of adding files once.
- Click Sync a folder… and choose the folder.A docs folder, a shared drive, or a Git checkout of your runbooks repo.
- Kept reads everything in it.Subfolders become categories, so
runbooks/andpolicies/stay apart. - Kept watches for changes.When a file is added, edited or deleted, Kept reads it again or removes it. After a
git pull, changes arrive on their own. Sync now forces a check.
To keep the index clean, a synced folder skips hidden files and folders (like .git) and tooling folders such as node_modules and build. Symbolic links are not followed, so a link can't pull in files from outside the folder. A folder can hold up to 5,000 files; Kept tells you if it left any out.
Stop syncing leaves the documents Kept already read in place; remove them separately if you want them gone.
Categories
Categories group sources, such as Runbooks, Policies or Onboarding. Kept uses them to search the right documents first, and shows them on every citation.
- Kept can suggest categories from your documents. You review the suggestion before anything changes.
- New category…, Edit category… and Delete category on the Sources page. Deleting a category keeps its documents; they become uncategorised.
- Synced folders use their subfolders as categories.
Write documents in Kept
Missing a doc? Create documents on the Sources page lets you write a note or start From a template… (office hours and contacts, a short staff handbook, a client FAQ and so on). Kept asks you the questions, fills in the template, and the result is a source like any other. Notes are good for answering what the Gaps page shows is missing.
Status of a source
| Status | Meaning | What to do |
|---|---|---|
| Ready | Read and searchable. | Nothing. |
| No text | Kept couldn't find readable text, for example a blank scan. | Check the file opens, then Read again. |
| Error | The file couldn't be read: damaged, password-protected or not what its name says. | Open it on the Mac, save a fresh copy, add that. |
Remove documents
Select sources and click Remove. Kept deletes its copy, the text it pulled out and its search index for those files straight away. Your original files are never touched.
Questions already asked keep their answer text in Kept's history, including the quoted passages, until you clear the history in Settings → Privacy & data. A pinned answer whose source was removed is no longer served; it shows under Pinned answers to check.
Re-read everything
Settings → AI model → Re-read all documents reads every source again. You only need it after changing how Kept splits documents in the same settings, or after switching to a model that needs a fresh index.
Updated November 9, 2026 · Something wrong or missing? Tell us.