The project's README from github.com/8rank/iKnow. As one markdown file: README.md.
See what your Mac knows about you.
macOS builds a knowledge graph about the person who uses it: who you know, how it decided those people are related to you, who you write to and how often, whose faces recur in your photos, where you might be next. Check out the write up.
Apple documents very little of this. The daemon that builds the graph gets a one-line man page, and there is no user-facing account of what it stores or what it infers. iKnow is a look under the hood: a small web app that opens the graph on your own Mac and shows you what is in it, what was recorded, what was inferred, and which other parts of the system read it.
The first screen, rendered from made-up data. No name, number or count in it is real.
Everything stays on your machine.
server.py is a Python standard-library
server. No Flask, no npm, no build step, nothing to install beyond Python 3.127.0.0.1, and there is no flag to change that.
The page fetches from that process and nowhere else; a Content-Security-Policy
blocks anything off-machine.127.0.0.1.
It is not a sandbox: a program running as you, with access to your terminal
or your browser history, could still find it.mode=ro. Nothing on your Mac
is changed.It reads the live stores where macOS keeps them: the graph in
~/Library/IntelligencePlatform, the ontology inside the system's
IntelligencePlatformCore framework, and the four sources the graph resolves
against, which are Messages, Photos, Calendar and Contacts. Nothing is
extracted or copied first.
iKnow has only been tested on these macOS releases:
Apple changes these stores between macOS releases, so on another version some pages may come out incomplete. On macOS 27 and later, not every page may work fully yet. When a page cannot read something, it says so under its title.
git clone https://github.com/8rank/iKnow.git
cd iKnow
python3 server.py
Then open the link it prints. ctrl-c stops it.
open this link to read the store:
http://127.0.0.1:8765/?token=…
The token is new each time the server starts, and it is stored nowhere. Open the link once: the browser swaps the token for a cookie, drops it from the address bar, and reloads and new tabs work from then on, until the server stops. If the page says Open the link from the terminal, it was reached without the token, or the server has been restarted since the tab was opened. Take the current link from the terminal.
The stores are protected by macOS privacy controls, so the terminal you start the server from needs Full Disk Access:
On startup the server checks each store and prints ok or DENY beside it,
followed by these instructions, so a missing permission is obvious rather than
a bare SQLite error.
Full Disk Access is what lets the terminal read the files. It gives iKnow no way to change them; every handle is read-only.
When you are done, switch it off again. The permission covers everything you run from that app, not only iKnow. Go back to System Settings → Privacy & Security → Full Disk Access and turn the app off; turn it back on the next time you run iKnow. The server reminds you when you stop it.
python3 server.py --port 9000 # another port
python3 server.py --bundle /path/to/extracted # an extracted copy, not this Mac
MANUAL_FOR_YOUR_AGENT.md is written for an AI agent with a shell on your Mac, such as Claude Code or Codex. It covers where each store is, how to open it read-only, what the tables and codes mean, how to join out to Contacts, Photos, Calendar and Messages, and which columns mislead. Give the agent the file and ask in plain language:
Read MANUAL_FOR_YOUR_AGENT.md, then tell me who my Mac thinks my family is, and why.
The agent needs the same Full Disk Access as the server. Unlike the server, it sends what it reads to wherever its model runs. So the manual makes it ask you, before it reads anything, whether you trust that provider with your graph, and then read only what each question needs.
Apache 2.0. See LICENSE.
iKnow is fully LLM-generated and may not be 100% accurate. If something should be updated, open an issue.
From the Eighth Rank.