Use Kept

Ask and check answers

Ask in plain words. Kept answers in a few sentences from your documents only, and every claim links to the passage it came from, so anyone can check it in one click.

Search your runbooks without uploading them

To keep runbooks searchable without uploading them to the cloud or to an external AI service, install Kept on one Mac and point it at your runbooks folder or Git checkout. Kept finds the passage and writes a short cited answer with an AI model that runs on that Mac through Ollama, so your documents, questions and answers stay on the Mac and nobody on your team needs ChatGPT or another cloud AI to search them.

Setup takes about ten minutes, most of it one model download. Then:

  1. Install Kept on one Mac.It needs Apple silicon (M1 or newer), 16 GB of memory and macOS 14 (Sonoma) or later. Setup downloads the AI model once, and nothing about you or your documents is sent. See Install and set up.
  2. Add your runbooks.On the Sources page, drag in files or folders. To keep a whole repo searchable, click Sync a folder… and choose a Git checkout of your runbooks repo. Subfolders become categories, so runbooks/ and policies/ stay apart, and after a git pull changes arrive on their own. Kept keeps its own copy of each file on the Mac. See Add documents.
  3. Bring in Confluence pages as HTML.Export the pages from Confluence as HTML and add the exported files or folder the same way. Kept reads Confluence and Notion HTML exports, and drops scripts and styles without running them.
  4. Check the status on Sources.Each source shows Ready (read and searchable), No text (Kept found nothing readable, such as a blank scan) or Error (damaged, password-protected or not what its name says). Fix anything that isn't Ready before you test.
  5. Ask a test question.On the Ask page, type a question you already know the answer to, such as "What's the rollback procedure for the payments service?", and press Return. Use the words your runbook uses.
  6. Check the cited passage.Click a marker like [1] to see the source, the section and the quoted text, then open the source to read it in full. For commands, numbers and anything you'll act on, read the passage rather than trusting the summary.
  7. Let the team ask.Colleagues on your office network can ask from their browser, with nothing to install. See Share with your team.

What stays on the Mac

Your documents, the search index, your questions and the answers are stored in one folder on the Mac, readable only by your macOS user. Kept goes online for exactly three things: the AI model download (once at setup, and if you switch models), a licence check about once a month that sends your licence key and a random install ID, and an update check once a day if you turn it on. See Privacy and network for how to check this yourself.

One caveat

If you connect a cloud AI tool to Kept over MCP or the API, the answers and passages it receives go to that AI's servers. Use a tool with a local model to keep everything on the Mac.

Numbers to know

WhatValue
Mac neededApple silicon (M1 or newer), 16 GB memory, macOS 14 or later, about 10 GB free disk space
Setup timeAbout ten minutes, most of it one model download
File typesPDF, Word, RTF, text, Markdown, HTML (including Confluence and Notion exports) and photos of documents
Largest file200 MB each
Files in a synced folderUp to 5,000
Question lengthUp to 2,000 characters
Internet needed to askNone. Nothing goes to the internet while Kept answers.

Common questions

Do we need ChatGPT or another cloud AI to search our runbooks? No. A local AI model on the Mac writes each answer from your documents only, and Kept refuses models that run in anyone's cloud.

Which AI engine does Kept use? Ollama, free software that you install. Kept's setup installs it if it's missing and helps you turn off Ollama's online AI features, so the model runs only on your Mac. Ollama downloads models from ollama.com.

Can Kept search our Confluence runbooks? Yes, from an HTML export of the pages. Add the exported files as in step 3.

What if Kept can't find a runbook I know is there? See When Kept can't answer.

Ask a question

Type on the Ask page and press Return. New Question clears the page. Questions can be up to 2,000 characters.

Good questions name the thing you'd search for in the docs:

  • "What's the rollback procedure for the payments service?"
  • "Who approves production database access, and how long does it take?"
  • "How many days of leave do new hires get in their first year?"

Kept treats each question on its own. It doesn't remember the previous question, so ask "What's the rollback for payments?" rather than "And for payments?".

Read an answer

An answer is a short paragraph with numbered markers like [1]. Each number is a citation:

  • Click a marker to see the passage it came from: the source, the page or section, and the quoted text.
  • Open the source from the citation to read it in full.
  • Every number is checked. Kept removes markers that don't point at a passage it actually used, so a citation is never invented.
Check what matters

A local AI model writes the answer. It's good at finding and restating, and it can still misread. For numbers, dates, fees and anything you'll act on, read the cited passage. That's what it's there for.

When Kept can't answer

If nothing in your documents answers the question, Kept says so plainly instead of guessing, and the question goes to the Gaps page. That's on purpose: a "not in your documents" is more useful than a confident wrong answer.

If Kept says it can't find something you know is there:

  • Ask with the words the document uses ("PTO" vs "leave", "runbook" vs "playbook").
  • Check the source's status on the Sources page. A scan with no readable text can't be searched.
  • If it still misses, Settings → AI model has How closely a passage must match. Lower means Kept uses weaker matches; higher means it says "not in your documents" more often. The recommended value is 0.58.

Pinned answers

When an answer is right and people ask it often ("How do I get VPN access?"), pin it. Pin answer under an answer approves it: the same question gets that exact answer again, straight away, without the model.

  • Pins follow their sources. If a document a pinned answer cites changes or is removed, Kept stops serving the pin and answers afresh. The pin shows under Pinned answers to check on the Gaps page, so you can review and pin again.
  • Unpin answer removes a pin.
  • Pinned answers are served the same way to colleagues and to tools over MCP and the API.

Mark an answer wrong

Mark as wrong under an answer flags it. The question goes to the Gaps page, so you know which document needs fixing. Unmark wrong undoes it.

Gaps

The Gaps page lists what your documents are missing, from questions asked in Kept on this Mac:

  • Questions Kept couldn't answer from your documents.
  • Answers someone marked wrong.
  • Pinned answers whose sources changed.

Work through it like an inbox: write or fix the doc (or a note in Kept), then ask again. Only questions asked in the Kept app on this Mac count. Questions from colleagues' browsers, the API and MCP aren't saved, so they don't appear here.

Tone and instructions

Settings → General shapes how Kept writes:

  • Team name, used in answers and shown to colleagues.
  • Tone, for example plain and brief, or friendly.
  • Instructions, one per line. For example "Answer in Canadian English", "Use 24-hour times", "Never quote salaries". Kept always answers only from your documents, whatever the instructions say.

History

Your questions and answers are kept on this Mac so you can scroll back. Settings → Privacy & data → Clear… deletes every question and answer, and the Gaps they fed. Your documents and pinned answers aren't affected.

Updated November 9, 2026 · Something wrong or missing? Tell us.