Memory you can see
Most assistants keep a hidden profile of you that you never get to read. Holt keeps yours as files you own: a knowledge graph you can walk and a cross-linked wiki you can read and edit. Nothing about you stays a black box.
Everything you know, kept and connected.
An open-source personal agent OS. Any LLM, your skills, and a memory you can actually see, running on your own machine.
brew install holt-os/tap/holt Needs Homebrew. No Homebrew yet? Quickstart has both steps.
New to the terminal? Setup guide → Running a company? Holt Teams →
01What it is
Most assistants forget you the moment a session ends, or they keep a private profile you never get to read. Holt does the opposite. It keeps your knowledge as files you own: a navigable graph and a cross-linked wiki, on your own machine, under your own keys.
You choose the model, from Claude to a local one. You choose the skills. Memory stays per folder and local, and a local model powers recall, so it works offline and nothing leaves unless you decide it should.
It is MIT licensed and speaks MCP, so your other tools can read its memory and the whole thing is yours to extend.
02Different
Most assistants keep a hidden profile of you that you never get to read. Holt keeps yours as files you own: a knowledge graph you can walk and a cross-linked wiki you can read and edit. Nothing about you stays a black box.
Install one hook and Holt feeds the right past notes into every Claude Code prompt, then saves what mattered when the session ends. No command to run. Your memory grows while you work.
Claude, OpenAI, Gemini, Kimi, Grok, or a local model. Switch the brain in the middle of a conversation and the thread carries over. The same memory, skills, and hooks run under whichever one you pick. Gemini connects with an API key now that Google has retired its personal sign-in, and Holt walks you through it.
It runs in the folder you launch it from, on your machine, under your own keys. Memory is per folder and local, and a local model powers recall, so it works offline and nothing leaves unless you send it.
Thirteen skills ship in the box, and more live in a community registry you can search and add. Skills use the agentskills.io format so they travel, and Holt speaks MCP so Claude Code, Cursor, or Codex can read this folder's memory directly.
Run a task once, on a schedule, or as a named routine. Reach it from your phone over Telegram. Have it draft in your own writing voice. It works while you are away from the keyboard.
You never see a raw error. If something breaks, Holt logs the detail, tells you in one sentence, and holt doctor --fix repairs the usual causes on its own: it starts the memory engine, fetches what is missing, and mends a damaged config without losing a thing.
holt tour walks a first-timer from install to the moment it remembers something about them. One word updates it, one word resets a folder, and the help reads like a person wrote it. Built for people who have never opened a terminal.
An empty assistant gives generic answers, which is why most people install one and drift away. The onboard skill is a fifteen minute interview that fills its memory with your work, then does one real task with it. After that, audit shows what is still missing and level-up turns one manual chore a week into something Holt does for you.
03How it remembers
Recall and storage run on your machine. Only your question and the notes it needs go to the brain you picked.
04Benchmarks
Holt 0.19 on the three public benchmarks for long-term AI memory. Every question, answer and grade is published.
500 questions about a user’s past chats. Graded by GPT-4o, the benchmark’s own grader. 89.7% on the 399 questions never used for tuning.
1,540 questions across long two-person conversations. Graded with the original, stricter LoCoMo prompt.
700 questions over conversations of about a million tokens each, too long for any context window.
| LongMemEval | LoCoMo | BEAM 1M | |
|---|---|---|---|
| Holt | 91.2% | 88.2% | 79.6% |
| Mem0 | 94.4% | 92.5%* | 70.1% |
| Tavus Memories | 93.4% | – | – |
| Zep | 71.2% | ~80% | – |
About 6,000 tokens of memory per question. Search and storage run on your own machine with a local model. Answers came from Claude Sonnet 5.5. LongMemEval was graded by GPT-4o, LoCoMo and BEAM by Claude Opus 5.5.
All tuning used the same 101 LongMemEval questions. LoCoMo, BEAM and the other 399 were never used to choose anything. Other systems’ numbers are their own published results, with different models and graders. *Mem0’s LoCoMo grader is more lenient than the one used here.
See every answer and rerun it yourself →05Commands
Everything runs from your terminal, in the folder you launch it from. Here is what you can reach for.
$ holt Start your assistant. It sets the folder up the first time, then launches your brain branded as Holt, with your memory wired in. A CLI brain opens its own full interface, a direct API brain runs inside Holt. One command either way.
holtholt initholt memoryholt wikiholt graphholt hookholt runholt scheduleholt routineholt skillholt mcpholt voiceholt writeholt telegramholt doctorholt tourholt updateholt resetFull command and configuration reference lives in the docs.
06Quickstart
Let your agent install it
Already have Claude Code or Codex installed? Just copy this prompt and paste it.
About 5 minutes. It asks before anything system-wide, and never asks for a password or API key.
Set up Holt for me (https://github.com/holt-os/holt), an open-source personal AI assistant whose memory stays on my own machine. Read https://raw.githubusercontent.com/holt-os/holt/main/docs/INSTALL.md and follow it exactly. It is written for an agent doing this install. When Holt runs, tell me to open it in the folder I want to work in with `holt`, and to run `/skill onboard` in that first session so it learns who I am. Ground rules: only download from the GitHub links above. Ask me before using sudo, installing anything system-wide (Homebrew, Node, Python, ffmpeg) or changing files outside the install folder. Never ask me to paste a password or API key into this chat. When you finish, tell me what you installed, where it lives, and the one command I run to use it. If you cannot run terminal commands, give me the exact steps to run myself instead.
macOS
1 · Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"2 · Install Holt
brew install holt-os/tap/holtHomebrew pulls Node in for you.
Linux
1 · Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"2 · Install Holt
brew install holt-os/tap/holtHomebrew on Linux pulls Node in for you.
Windows
1 · Install Node
winget install OpenJS.NodeJS.LTS2 · Install Holt
npm i -g @holt-os/holtHomebrew is not available on Windows.
holt initTrust the folder, choose a brain, and turn on local memory.
holtLaunches your brain branded as Holt, with memory wired in. The wiki, hooks, and the rest build on this.
/skill onboardA fifteen minute interview that fills its memory with your work, then does one real task with it. Everything else gets better once it knows you.
Prefer to read the code first? The whole thing is on GitHub, MIT licensed.
07Roadmap
Most of the plan is already shipping. What is left is the registry and richer views. Each piece stands on its own, and the repo shows it land in real time.
Bare holt launches the real interactive brain (Claude Code, Codex, or Gemini) branded as Holt, with setup and memory wired in. Any brain as a CLI or a direct API connection, and brain switching that keeps context.
Per folder memory, semantic recall on a local model, distilled facts, ambient hooks for Claude Code, and opt-in memory shared across folders.
Your memory as an interactive graph that now weaves in your code and docs with community structure, plus a cross-linked wiki an LLM maintains and can keep current on its own.
Run, schedule, routines, a skill registry to search and share, an MCP server, Telegram, a machine advisor, and voice aware writing.
No raw errors, ever: crashes log the detail and holt doctor --fix repairs the usual causes. A guided tour, one-word update and reset, and two new direct brains: Kimi and Grok, beside Claude, OpenAI, and Gemini.
An onboarding interview that fills memory with your work in about fifteen minutes, a weekly audit of what is still missing, and a level-up session that turns one manual chore into something Holt does. Scheduled jobs now install real OS timers on Windows too, not just Mac and Linux.
Voice and mobile ways to reach Holt, beyond the terminal.
08Built on Holt
An open-source job-search agent that runs the whole loop on top of Holt. It builds your profile, scores a role on fit, tailors your resume, writes the cover letter, preps you for interviews, reads your inbox for replies, drafts the follow-ups, and keeps your pipeline board current. The core needs no API keys, and it drafts everything while you keep the submit button.
About 5 minutes. It asks before anything system-wide, and never asks for a password or API key.
Set up holt-jobsearch for me (https://github.com/holt-os/holt-jobsearch), an open-source job-search agent that runs inside Holt. 1. Run `holt --version`. If Holt is not installed, install it first by reading https://raw.githubusercontent.com/holt-os/holt/main/docs/INSTALL.md and following it exactly. 2. Clone https://github.com/holt-os/holt-jobsearch and read its README. 3. Ask me whether I want the job skills in one folder only or in every folder, then run `./install.sh` or `./install.sh --global` to match. On Windows without bash, use the per-skill `holt skill add` commands from the README instead. 4. Tell me to open Holt in my job-hunt folder and run `/skill jobs`. Every connector (job search, inbox, notifications) is optional. Do not set any of them up unless I ask. Ground rules: only download from the GitHub links above. Ask me before using sudo, installing anything system-wide (Homebrew, Node, Python, ffmpeg) or changing files outside the install folder. Never ask me to paste a password or API key into this chat. When you finish, tell me what you installed, where it lives, and the one command I run to use it. If you cannot run terminal commands, give me the exact steps to run myself instead.
09Start
Install it and run it today, then star the repo to hear what lands next. Contributions are welcome the moment you want to write a skill or a plugin.
$ brew install holt-os/tap/holt