KIKUmap

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

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.

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 전문 보기 ↗