iKnow README

项目的 README,来自 github.com/8rank/iKnow。合并为一个 markdown 文件:README.md。

iKnow

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 iKnow landing page: the graph of people, employers and group chats around the owner of the Mac, coloured by what the store says each one is to them, with the key and the reading notes beside it

The first screen, rendered from made-up data. No name, number or count in it is real.

How it works

Everything stays on your machine.

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.

Install and run

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.

Giving it permission

The stores are protected by macOS privacy controls, so the terminal you start the server from needs Full Disk Access:

  1. Open System Settings → Privacy & Security → Full Disk Access.
  2. Add the app you run the command from: Terminal, iTerm, or your editor.
  3. Quit that app completely and open it again. The permission is picked up at launch, not while it is running.

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.

Reading a copy instead

python3 server.py --port 9000                    # another port
python3 server.py --bundle /path/to/extracted    # an extracted copy, not this Mac

Asking an agent

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.

License

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.

iKnow (8rank/iKnow)

正在搜索数据库…

666 ·GitHub
这是什么?iKnow 是一个小型本地网页应用,它会打开 macOS 为你构建的知识图谱,展示其中包含什么、记录了哪些内容、哪些是推断出来的。
这是可安装的应用,还是我要打开的网页?都不完全是。它是一个 Python 进程,在 127.0.0.1 上提供网页服务,并输出一个链接供你在浏览器中打开,无需构建步骤。
怎样才能让它运行起来?先给终端应用授予“完全磁盘访问权限”,然后在该终端中用 Python 3 运行 server.py,再打开它输出的链接。每次启动都会生成一个新的令牌。
除了 Python 3,还需要别的东西吗?不需要任何软件包、npm 或构建步骤。但你需要为终端应用开启“完全磁盘访问权限”,用完之后应该再把它关掉。
它能在我的 macOS 版本上运行吗?目前只在 macOS 26.6.2、26.7.1 和 27.0.1 上测试过。苹果每次发布新版本都会改动相关数据存储,因此部分页面可能显示不完整;在 macOS 27 及更高版本上,也可能并非所有页面都能完全正常工作。
数据会离开我的 Mac 吗?服务器只绑定到 127.0.0.1,内容安全策略(CSP)会阻止来自本机以外的请求,而且不会写入或记录任何内容。不过,如果你让 AI 代理去阅读这份手册,它会把读取到的内容发送给其模型提供商。
这个项目为什么存在?苹果对构建这一图谱的守护进程几乎没有任何文档说明,因此 iKnow 相当于一次对底层机制的探查,但并没有面向用户的说明,告诉你它存储了哪些内容。
这个图谱里都有些什么?你认识的人,以及 macOS 判断他们与你有何关联的方式;你给谁写信、写得多频繁;照片中反复出现的人脸;还有你接下来可能会去的地方。
它显示的细节可以信任吗?README 中说明,iKnow 完全由大语言模型生成,可能并非 100% 准确,因此在依赖重要细节之前,请先对照你自己的 Mac 进行核实。
作者
8rank
大小
0.8 MB
星标
666
更新
提交Nov 08
时长
2个月
提交 · 90 天