Skip to content

Kikumap 1.0

Choose a tag to compare

@tang1693 tang1693 released this 30 Oct 03:37
· 3 commits to main since this release

Kikumap 1.0

Kikumap now shows only what it can confirm. When it can't see something (Claude's window is closed or on another desktop, a Codex task has gone quiet, a sync problem), it says so ("running?", "2?", "as of 12:29", "not synced") and tells you how to fix it, instead of guessing.

New

  • Claude's and ChatGPT's usage side by side in the window header, each row marked with its service; numbers from an earlier read say so.
  • Refresh and search at the top of the left column.
  • Statistics and the widget's chart use your map's branch colours (grey for chats without one).
  • Finder-style keys on the map: ⌥↑ / ⌥↓ move an item, ⌘↓ opens it, ⌘↑ goes up to its topic.
  • A first-run page showing what Kikumap can and can't see.
  • "Needs you" when Claude is waiting for your approval or an answer.
  • Time Kikumap couldn't see is estimated and marked ≈ (in the timeline, Today, Statistics and the widget), from your own typical run length.
  • Claude in any of its 11 interface languages: running, unread, waiting, export and import all work.

Better

  • The widget says "as of …" when its picture is old, and redraws sparingly so macOS doesn't freeze it.
  • Scripted runs (claude -p, codex exec) no longer ding or stay unread.
  • Export opens chats by their address, keeps each chat's files together when you refile it, skips a disk that isn't connected, and carries on later when you come back mid-run. Import attaches the summary as a file.
  • Daylight saving, time-zone changes and clock changes are handled; a file that can't be saved is retried; only one copy of Kikumap runs at a time.

Install

Download Kikumap.dmg, open it and drag Kikumap to Applications. The first time you open it (and once after each update), macOS warns that it can't check the app: click Done, then System Settings → Privacy & Security → Open Anyway.

Known limits

  • Kikumap reads Claude's chats from its window. While the window is closed (⌘W only hides it) or on another desktop, chats that were running show "running?" until it's back.
  • Claude sends no notification when an ordinary chat's reply finishes. With Full Disk Access, Kikumap still hears when Claude needs your approval or an answer, and when a Cowork task finishes.
  • From ChatGPT, only the Codex chats it keeps on your Mac show. Ordinary ChatGPT chats live online (planned for 1.1).
  • Claude Code or Codex running on another computer, a server or in the cloud can't be seen.
  • Alerts from Claude's notifications need them allowed for Claude in macOS (System Settings → Notifications).

Known issues (fixes planned for 1.0.1)

  • A chat waiting for your approval that you've already marked read (or looked at in Claude) still says "needs you" in the window, but loses the menu-bar "!" and its place in the menu and widget.
  • A Claude Code permission you answer in the terminal keeps showing "needs you" until the approved step finishes.
  • When an estimated stretch of one chat overlaps another chat's run, their shared time isn't marked ≈.
  • Export: a new chat with the same name as an archived chat that's no longer pinned is written into that chat's folder. Rename one of them to keep both.
  • Export: the scheduled summary run can apply an older Claude data export over a newer one if the newer zip was removed from Downloads.
  • Export window: unticking a sub-topic while its parent topic stays ticked doesn't leave it out.
  • Export: a chat that runs and finishes while you're looking at it in Claude may keep its older summary until it changes again.

Kikumap 1.0(中文)

Kikumap 现在只显示它能确认的东西。 看不到的时候(Claude 窗口关了或在别的桌面、Codex 任务没动静、同步有问题),它会直接说出来(「在跑?」「2?」「12:29 时的数据」「没同步」),并告诉你怎么恢复,不再猜。

新功能

  • 窗口顶部并排显示 Claude 和 ChatGPT 的用量,每行标明是哪家的;旧数据会注明。
  • 左栏顶部加了刷新和搜索。
  • 统计和小组件的图表沿用导图里分支的颜色(没设颜色的是灰色)。
  • 导图快捷键和访达一样:⌥↑ / ⌥↓ 调整顺序,⌘↓ 打开,⌘↑ 回到所在主题。
  • 首次启动多了一页,讲清楚 Kikumap 能看到什么、看不到什么。
  • Claude 等你批准或回答时显示「需要你操作」。
  • Kikumap 没看到的时长按你自己一次运行的常见时长估算,并标 ≈(时间线、今日回顾、统计和小组件里都有)。
  • Claude 的 11 种界面语言都支持:进行中、未读、等待、导出和导入都能用。

改进

  • 小组件的画面旧了会写「xx:xx 的数据」;请求重绘更省,macOS 不会把它卡住。
  • 脚本跑的任务(claude -p、codex exec)不再响提示音,也不会一直未读。
  • 导出按地址打开对话;对话换了主题,它的文件一起搬过去;外接盘没接上时跳过;你回来打断后,下次空闲接着做。导入时总结作为附件发进去。
  • 夏令时、换时区、改系统时间都处理好了;存不进去的文件会自动重试;同一时间只会运行一个 Kikumap。

安装

下载 Kikumap.dmg,打开后把 Kikumap 拖到「应用程序」。第一次打开(以及每次更新后一次)macOS 会提示无法检查:点「完成」,再到 系统设置 → 隐私与安全性 → 仍要打开。

已知限制

  • Kikumap 从 Claude 的窗口读对话。窗口关着(⌘W 只是藏起来)或在别的桌面时,在跑的对话显示「在跑?」,等窗口回来再更新。
  • 普通对话回复完,Claude 不发通知。开了「完全磁盘访问」,Claude 要你批准或回答、Cowork 任务做完时,Kikumap 照样知道。
  • ChatGPT 这边只显示它存在你 Mac 上的 Codex 对话;普通 ChatGPT 聊天存在云端(计划在 1.1 支持)。
  • 别的电脑、服务器或云端跑的 Claude Code / Codex 看不到。
  • 通知里的提醒,要在 macOS 里允许 Claude 发通知(系统设置 → 通知)。

已知问题(计划在 1.0.1 修好)

  • 等你批准的对话,如果你已经标为已读(或在 Claude 里看过),窗口里仍写「需要你操作」,但菜单栏的「!」和菜单、小组件里的那一条会消失。
  • 在终端里批准了 Claude Code 的权限请求后,要等批准的那一步做完,「需要你操作」才会消失。
  • 一个对话的估算时段和另一个对话的运行重叠时,平分的那段时间没有标 ≈。
  • 导出:新对话和一个已不再置顶的已存档对话同名时,会写进那个对话的文件夹。改个名就能两个都保留。
  • 导出:如果较新的导出包从「下载」里移走了,定时总结可能会用较旧的 Claude 导出包覆盖较新的内容。
  • 导出窗口:父主题勾着时,取消勾选它下面的子主题不会生效。
  • 导出:你在 Claude 里看着它跑完的对话,总结可能要等它下次有变化才更新。