KIKUmap README

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

KIKUmap: a mind map for your Claude and ChatGPT chats

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français

A mind map for your Claude and ChatGPT chats, in the Mac menu bar.
See what's running, what's done and what needs you.

Download KIKUmap for macOS  Visit the KIKUmap website

KIKUmap - A mind map for your Claude and ChatGPT chats | Product Hunt

Latest release macOS 13 or later 9 languages Swift, no dependencies MIT license GitHub stars Support on Ko-fi

Website · Features · Install · Privacy · FAQ · Support ❤️

Dragging the Work topic across the map: the other topics slide apart to make room, and it lands where the gap was

Watch the KIKUmap tour

Features

The menu-bar icon counting running chats in a turning ring, then a red unread badge, then an exclamation mark when a chat is waiting for you

1. Status in the menu bar

A ring counts running chats. A red badge counts finished, unread ones, with ! when one is waiting for you (to approve or answer, or it stopped on an error). An optional sound or voice says which chat is done.

2. Chats as a map

Chats pinned in Claude and in the ChatGPT app, plus Claude Code sessions, line up in the left column. Drag them onto your own topics. Each chat is tagged Claude or GPT.

Selecting three chats and dragging them onto Side projects together
Clicking the In progress tag highlights the chats that have it; the tag is then dragged onto a chat

3. Colors, shapes and tags

Give a topic a color and a shape. Tag chats, and click a tag to highlight every chat that has it. Drag the top edge of the tags to make them taller or shorter, or tuck them away (⌃⌘G). In a short window zoomed in, they step aside until there's room: make the window taller or press ⌘-.

Settings → Colors has eight color sets for the whole window (Classic, KIKU flower, Bauhaus black, Retro, Deep sea, Neon, Sunset, Candy), or pick each color yourself.

4. Keyboard-first

⇥ subtopic · ⏎ sibling · ⌥↑↓ move · ⌘Z undo · ⌘F search · space opens a chat.

Tab adds a subtopic, Return adds a sibling, Option-Up moves it, Command-Z undoes
The timeline: past runs with their times, and scheduled tasks with countdowns

5. Timeline

When each chat ran, and the scheduled tasks coming up, with countdowns.

6. Export and import

Each Claude chat as files: a summary, prompts, the conversation and artifacts. Import them into another Claude account.

The export window and the folder of Markdown files and artifacts it writes
KIKUmap widgets in three sizes: time worked in the last 24 hours, usage, and in the large one the busiest chats and the last 7 days

7. Desktop widget

Time worked in the last 24 hours and the last 7 days, plus Claude and ChatGPT usage with plan names. Three sizes, macOS 14 or later.

8. Statistics

Time per chat and session over 7, 14, 30 or 90 days. ⌘Y.

Statistics: time per chat and session in bars over seven days
Finished chats light up
Finished chats light up on the map.
Search
Search topics, chats and tags.
Today in the menu
Today: which chats and sessions worked, and how long.
Usage in the menu
Usage for the session and the week.
The map as a PDF
PDF of the whole map.
Daily backups
Daily backups of the map.
Light or dark
Light or dark.
English and Chinese
9 languages: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français

Works with: the Claude desktop app · Claude Code (Terminal, VS Code, Cursor, the app's Code mode) · the ChatGPT desktop app · Codex in VS Code or the terminal.

Native and light: Swift and AppKit only. No Electron, no web view, no third-party code (line icons from Lucide, ISC).

Install

  1. Download Kikumap.dmg (macOS 13 or later, Apple silicon and Intel) and drag KIKUmap to Applications.
  2. On first launch, macOS can't check the app (it isn't notarized). Click Done, then System Settings → Privacy & Security → Open Anyway.
  3. Allow Accessibility when the intro asks. Everything else is optional.
  4. Pin chats in Claude or ChatGPT to follow them.
Build from source

Needs the Xcode Command Line Tools.

git clone https://github.com/tang1693/KIKUmap.git
cd KIKUmap
open Install.command

Install.command builds with swiftc, installs to ~/Applications and signs with a local certificate, so permissions survive rebuilds. scripts/build-release.sh builds the disk image.

Privacy

What each source and permission is for
Shows Comes from Permission
Running, unread, pinned Claude chats The Claude app's sidebar Accessibility
Claude waiting for you (to approve or answer) and finished Cowork tasks, also with Claude's window closed (optional) Claude's notifications in Notification Center Full Disk Access
Claude Code sessions Claude Code hooks in ~/.claude/settings.json (backed up first) none
ChatGPT chats The ChatGPT app's files in ~/.codex (read-only) none
Running, done and unread for ordinary ChatGPT chats (not Codex) The sidebar in ChatGPT's window, while part of the window can be seen Accessibility
A finished session you're looking at counts as read The window titles of its editor or terminal, while that app is in front Accessibility
Desktop widget One file KIKUmap writes for it (widget.json) none
Claude usage and scheduled tasks (optional) Anthropic's usage API, with Claude Code's sign-in Keychain
ChatGPT usage (optional, experimental) OpenAI's usage interface, with Codex's sign-in none

ChatGPT: Codex chats are supported best (read from the app's files, right even with its window closed). Ordinary chats are supported less well: they're read off ChatGPT's window, only while part of it shows.

Not shown: unpinned chats, and anything running on another computer, a server or in the cloud.

All keyboard shortcuts
⇥ / ⌥⇥ new child / new parent topic
⏎ / ⌥⏎ / ⇧⏎ new sibling below / above / new main topic
⌘⏎, double-click rename
⌫ / ⌥⌫ delete (pinned chats stay in the left column) / delete just the topic, keeping its items (also with several selected)
⌥. fold / unfold
↑ ↓ ← → select the nearest item that way
⌥↑ ⌥↓ / ⌥← ⌥→ move up or down / move a level
⌘↓, tap space open the chat in its app
⌘↑ up to the topic it's in
drag on empty space, ⇧/⌘-click select several
hold space, two-finger swipe move around the map
⌃⌘S / ⌃⌘G / ⌃⌘T left column / tags / timeline
↑ ↓ in the left column pick the row above or below (the map selects its chat too)
⏎, space in the left column open the chat in its app
⌘Y statistics
⌘R refresh
⌘Z / ⇧⌘Z undo / redo
⌘F search
⌘E / ⇧⌘E map as PDF / export chats
⇧⌘U mark unread / read
⌘+ / ⌘- / pinch / ⌘0 bigger / smaller / zoom / fit
⌃⌥C (changeable, but not to KIKUmap's own ⌃⌘S / ⌃⌘G / ⌃⌘T / ⌥⌘H) show or hide the map from anywhere

FAQ

Is this made by Anthropic or OpenAI?

No. KIKUmap is an independent, open-source project. The Claude app has no public API, so KIKUmap reads its window through Accessibility; an update to Claude or ChatGPT can break parts of it until KIKUmap catches up.

Why "Open Anyway"?

Notarizing needs a paid Apple developer account, and KIKUmap is free. Building from source works too: plain Swift, no dependencies.

Claude's window is closed. What happens?

⌘W only hides it. KIKUmap reads Claude's chats from the window, so it can't see them until the window is back on the current desktop; meanwhile running chats show "running?". Once it's back, one found done says "done after 14:00" (when it was last seen running), since when it finished isn't known. Claude Code and Codex chats aren't affected. ChatGPT's ordinary chats are read from ChatGPT's window the same way, while part of it can be seen.

A session finished while I watched it. Why is it still unread?

KIKUmap marks a finished session read by itself only when the window in front can only be that session's: for Claude Code, its folder's window in VS Code or Cursor, or a terminal window whose title shows both its folder and claude; for Codex, its folder's window in VS Code. If another window or tab could be showing it too, such as another editor window on its folder or a folder above it, it stays unread. Codex sessions in a terminal stay unread too (KIKUmap can't tell which terminal runs them). Open it from KIKUmap, or select it and press ⇧⌘U, to mark it read.

Something isn't showing
  • ▸ To-do in the top bar lists what's missing, with a button for each.
  • Claude chats: pin them, and keep Claude's sidebar open on Chat with Pinned unfolded.
  • Claude Code: Settings → Access → Claude Code → Connect, then start a new session.
  • Widget: macOS 14 or later, with KIKUmap in Applications. Right-click the desktop → Edit Widgets.
  • Still stuck: Settings → Access → Diagnostic report (no chat titles or messages in it) and open an issue.
Why the name?

Kiku (菊) is Japanese for chrysanthemum: the little flower in the menu bar.

Contributing

Issues and pull requests are welcome, especially when a Claude or ChatGPT update breaks something. See the contributing guide and the code of conduct; security problems go through the security policy.

Support

KIKUmap is free. If it helps, a coffee keeps it going ❤️

Buy me a coffee on Ko-fi

License

MIT. Claude is a trademark of Anthropic and ChatGPT a trademark of OpenAI; this project is independent and not endorsed by either.

KIKUmap (tang1693/KIKUmap)

正在搜索数据库…

1.1K ·GitHub
这是什么?一款 macOS 菜单栏应用,用来显示你置顶的 Claude 和 ChatGPT 对话中哪些正在运行、哪些在等你处理,并把它们排列成一张可以自由整理的思维导图。
它是应用、插件还是库?一款原生 macOS 应用,仅使用 Swift 和 AppKit 编写,没有 Electron、网页视图或辅助进程。另外还附带桌面小组件和统计窗口。
我该如何安装和启动?打开 Kikumap.dmg,把 Kikumap 拖到“应用程序”文件夹。由于该应用没有使用付费的 Apple 开发者 ID 签名,macOS 会在首次启动时阻止运行:点击“完成”,然后前往“隐私与安全性”,点击“仍要打开”。之后,置顶你想关注的对话即可。
安装前需要准备什么?macOS 13 或更高版本;如果要使用桌面小组件,需要 macOS 14 或更高版本。应用会请求“辅助功能”权限,以便读取 Claude 侧边栏。ChatGPT 不需要额外设置,也不需要 API 密钥。
它看不到或做不到什么?Claude 没有公开 API,所以 Kikumap 通过 macOS 辅助功能读取其窗口;普通的 ChatGPT 对话无法显示,因为它们存放在线上。两款应用任一更新后,部分功能可能失效,需要等 Kikumap 更新。
它能在 Windows 或 Linux 上运行吗?不能,它只支持 macOS,同时支持 Apple 芯片和 Intel 芯片的 Mac。
菜单栏图标显示什么?有置顶对话正在运行时,图标显示为带橙色弧线的圆环;已完成但你还没查看的对话会显示红色角标;当有对话需要你批准时,显示一个“!”。没有任何对话运行时,图标是一朵小小的橙色花。
它也能追踪 Claude Code 和 Codex 吗?可以。终端、VS Code 或 Claude 应用的“代码”模式中的 Claude Code 会话都会显示出来,此外还包括在 ChatGPT 应用中置顶的 Codex 对话,以及 VS Code 或终端中的 Codex 会话。
除了观察对话,我还能在地图上做什么?可以把对话拖到你自己的主题下、为对话添加标签,并把某个对话的摘要、提示词、对话内容和附件导出到一个文件夹。之后,你可以把该文件夹导入新的 Claude 账户,接着上次的进度继续。
它是开源的吗?需要 API 密钥吗?它采用 MIT 许可证,可以用 Xcode Command Line Tools 从源代码构建。不需要 API 密钥;用量显示是可选功能,默认关闭,它使用 Claude Code 已经保存在你 Mac 上的登录信息。
作者
tang1693
大小
216.6 MB
星标
1.1K
时长
21天
提交 · 90 天