Features
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.
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.
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.
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.
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
- Download Kikumap.dmg (macOS 13 or later, Apple silicon and Intel) and drag KIKUmap to Applications.
- On first launch, macOS can't check the app (it isn't notarized). Click Done, then System Settings → Privacy & Security → Open Anyway.
- Allow Accessibility when the intro asks. Everything else is optional.
- Pin chats in Claude or ChatGPT to follow them.
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
- Everything stays on the Mac, in
~/Library/Application Support/ClaudeConsole/.
- One permission is required: Accessibility, to read the chat lists in the Claude and ChatGPT windows. Every permission is explained before macOS asks.
- No network requests, except the optional usage lookups (off by default) to Anthropic and OpenAI. Those read the sign-ins Claude Code and Codex already keep on the Mac, and never save them. Neither company has said apps may do this, so these lookups could be blocked.
- Export (with summaries) and Import paste through the clipboard. What KIKUmap pastes is marked for clipboard history apps to skip and kept off your other devices. Each summary comes through Claude's own Copy button, which a clipboard history app may keep. Your clipboard is put back after each step.
| 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.
| |
|---|
| ⇥ / ⌥⇥ | 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 |
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
