Set Up Your Mac

Written & tested for accuracy by a developer (not AI) · Updated October 2026

Knowledgebase Apps for AI

Knowledgebase apps for AI agents on Mac. Obsidian and alternatives such as Tolaria. A starter project for an LLM wiki that an AI agent manages for you.

A knowledgebase (also called a personal knowledge manager, or PKM, and sometimes a "second brain") holds a library of notes that grows over months or years. Many people keep notes in Apple Notes or a text app, and manage them by hand. Experienced users keep their notes as Markdown files in an ordinary folder, where an AI agent can read them, link them, and add to them. Or you can use specialized apps like Obsidian to read and manage Markdown notes in a clever user interface.

The knowledge accumulates. Each source you add, and each question you ask, leaves the collection more useful than before. You can then ask the agent questions that draw on everything you've collected.

A knowledgebase is one topic in "Set Up Your Mac", my guide to setting up a Mac. For everything else, see the home page.

What a knowledgebase is

This page is about a personal knowledgebase that you keep on your own Mac. People use a knowledgebase for research, for a course of study, for a book or a long project, or simply to remember what they read. It is a library of notes that grows over months or years. The notes link to each other, so you can follow an idea from one note to the next. Some apps also show which notes link back to the one you're reading, and draw a graph of the connections.

A knowledgebase differs from the two other kinds of app that open Markdown files:

  • A Markdown editor is built for one document at a time. The article Markdown Editors for AI describes the kinds.
  • A project editor is built for a project folder, where the editor manages instructions and a plan that guides an AI agent. The Yaxed app is a good example. The article Project Editors for AI explains what it does.
  • A knowledgebase is built for a growing library of linked notes, kept for what they record rather than for a task, used for research.

Why a knowledgebase suits AI agents

An AI agent such as Claude Code or Codex can read and write any file in a folder you give it. If your notes are Markdown files in an ordinary folder, the agent can search them, summarize them, add links, and write new notes. If your notes are inside an app's own database, as they are in Apple Notes, the agent can't open them as files.

In April 2026, Andrej Karpathy, an AI researcher and a founding member of OpenAI, described the method that many people now follow. He called it an "LLM wiki" (an LLM, or large language model, is the AI behind an agent). You collect sources, such as articles and papers, in one folder. An AI agent reads each source and writes wiki pages in another folder: a summary of the source, and pages on the topics it covers, all linked together. When you add a source, the agent updates the pages it affects. You mostly read the wiki while the agent writes it. In his idea file, Karpathy summed up his setup this way: "Obsidian is the IDE; the LLM is the programmer; the wiki is the codebase."

The idea spread quickly, because it needs no new software. Any folder, any AI agent, and any Markdown editor will do.

Two ways to keep a knowledgebase

You can start with a folder that an AI agent keeps for you, or with a knowledgebase app. They fit together, since an app such as Obsidian works with an ordinary folder of Markdown files.

An AI wiki in a folder

An AI wiki is a project folder of Markdown files with instructions that tell the agent how to keep the wiki. You add sources and ask questions, while the agent does the writing. You need no special app, only an AI agent and an editor for reading the pages.

My example project, AI-Knowledgebase, sets one up for you. It is a research wiki for a contrived example (a neighborhood group planning a community garden). Here's how it works:

  • Sources - Each source goes in 1-research/ as one note, written in your own words, with the link and the date you read it. The agent never edits a source note once it is added.
  • Pages - The wiki itself is in wiki/, with pages for topics, open questions, and each source. wiki/index.md lists every page, and wiki/log.md records each change.
  • Rules - Every claim on a page links to its source. When sources disagree, the page says so. When something isn't known, the page says "unknown" instead of guessing.
  • Skills - Three skills, add-a-source, ask-the-wiki, and check-the-wiki, tell the agent how to carry out the rules.

Open the folder with Claude Desktop's Code tab, the ChatGPT app's Codex, or Claude Code or Codex in a terminal application, and try a prompt such as "What does the wiki say about water for the garden?" No coding is needed. The pages use ordinary Markdown links, so you can read them in any Markdown editor, or open the folder as a vault in Obsidian. The article Starter Projects explains the example projects.

A knowledgebase app

A knowledgebase app adds what a plain folder lacks: links you can click, a list of the notes that link back, a graph of the connections, and search across every note. Choose one that keeps each note as a Markdown file in a folder you choose, so an AI agent can work with the same files. A few older apps use their own database and I don't recommend them.

Obsidian and its alternatives

Here are the best-known knowledgebase apps for the Mac, judged by how often people search for them and how often published comparisons include them, in November 2026. Prices and features change, so check each product's site before you choose.

  • Obsidian - The leader, free for work as well as personal use (it charges only for optional syncing and publishing services). Your notes are Markdown files in an ordinary folder, which Obsidian calls a vault. Obsidian adds links between notes, a graph of the connections, and offers thousands of plugins written by its users. Because a vault is a folder of Markdown files, many people open it in Claude Code or Codex and ask the agent to search, summarize, or organize their notes.
  • Tolaria - A free and open-source knowledgebase released in April 2026, made for working with AI agents. Every note is a Markdown file. Every vault is also a Git repository, so Tolaria keeps a history of changes. Tolaria can run Claude Code, Codex, and other command-line agents from inside the app.
  • Logseq - A free and open-source app that organizes notes as outlines. Logseq's new version, in testing in October 2026, keeps notes in a database rather than as Markdown files, so check which version you install if you want an AI agent to read your notes.
  • Bear - A notes app (free, with a subscription for syncing) that keeps notes in its own database. Since April 2026 it has offered an MCP server, a connection that lets an AI agent read and write your notes.
  • Notion - An online workspace that keeps pages in its own service rather than as files on your Mac. An AI agent reaches your pages through Notion's MCP server. Notion is best only for companies that subscribed to a corporate plan.

Until recently, I used Obsidian for research, record keeping and rough drafts, but now I use simpler Markdown editors like Yaxed with vault-like folders managed by AI agents.

Features that matter with an AI agent

Within the knowledgebase apps, a few features decide how well an AI agent can help. Check these before you choose:

  • Plain files in your own folder - An agent can work only with files it can open. With Markdown files in a folder, you can also switch apps later without converting anything.
  • Kinds of links - Obsidian (by default) and many other apps write links in their own style, with double square brackets around a note's name. AI agents can read these links, but some Markdown editors and websites don't follow them. Ordinary Markdown links work everywhere, and Obsidian has a setting to use them instead.
  • A history of changes - An agent may rewrite dozens of notes at once. Git, the version control system developers use, keeps every earlier version, so you can undo a change you don't want. Tolaria sets up Git for you. You can also add Git to any other folder. Use my app "Set Up Your Mac for the Command Line" to install Git if you don't have it.
  • AI inside the app - Some apps include their own AI chat, usually connected to an AI account you pay for. If you already use Claude Code or Codex, you won't need built-in AI chat.
  • Syncing to other devices - Your notes are only on your Mac unless you sync them. Apps differ in how they sync. Some charge for it.

Knowledgebases in the "Set Up Your Mac" apps

The "Set Up Your Mac" apps have a "Knowledgebase" screen with three choices: the AI-Knowledgebase example project, Obsidian, and Tolaria. Nothing is selected until you choose. Anything you already have is grayed out. Click "Skip" if you don't want any of them. The app copies the example project into ~/Projects/AI-Knowledgebase and installs Obsidian or Tolaria with Homebrew.

Building on what you collect

With a knowledgebase, the notes you keep become something an AI agent can use. You collect sources and ask questions. The agent writes, links, and checks the pages, so the collection grows more useful the longer you keep it.

Recommended reading

Continue setting up your Mac

Don't miss the full visual roadmap and checklist that shows how to set up a Mac for software development, with all the essential tools and settings you might not yet know about.