KIKUmap

Product Introduction

1. Definition: KIKUmap is a native macOS menu-bar utility and desktop widget engineered to monitor, manage, and visually organize active, completed, or waiting AI conversation sessions from Claude (including Claude Code) and ChatGPT. Developed as a lightweight (5 MB), free, and open-source application written in Swift, it acts as a centralized workflow dashboard for AI-driven development and general productivity tasks.
2. Core Value Proposition: KIKUmap solves the friction of managing multiple concurrent, long-running AI threads by surfacing real-time status notifications via the macOS menu bar and transforming pinned chats into an interactive, color-coded mind map. By eliminating the need to constantly switch browser tabs or desktop applications to check if a response is finished or waiting for user confirmation, it optimizes AI workflow automation and drastically reduces cognitive overhead.

Main Features

1. Menu Bar Status Monitoring & Audio Alerts: Integrates directly into the native macOS status bar, utilizing dynamic indicator rings for running sessions, red notification badges for finished yet unread chats, and exclamation marks (!) to highlight states requiring user intervention (such as approval requests, prompts for input, or halted execution due to errors). Includes optional audio cues and text-to-speech announcements that vocally identify completed chats.
2. Mind Map Chat Organization: Aggregates pinned conversations from Claude, Claude Code sessions, and the ChatGPT desktop application into a structured left-hand column, allowing users to drag and drop chats onto custom mind map nodes grouped by projects, workflows, or categories. Features customizable branch colors, shapes, and theme palettes.
3. Desktop Usage Widgets & Statistical Analytics: Provides native macOS desktop widgets (compatible with macOS 14 and later across three distinct sizes) displaying active work duration over the past 24 hours and 7 days, alongside real-time Claude and ChatGPT token/plan usage metrics. Includes a comprehensive statistics module (accessible via shortcut ⌘Y) tracking time-per-chat across 7, 14, 30, or 90-day intervals, paired with daily local backups, PDF map exports, and file-based export/import functionality for individual Claude conversation artifacts.

Problems Solved

1. Pain Point: Context switching fatigue and "AI attendance management," where users waste significant time manually checking multiple browser tabs and desktop windows to see if a long-running code generation task, debugging session, or multi-prompt workflow has completed or stalled.
2. Target Audience: Power users, AI-assisted software engineers, developers utilizing Claude Code and ChatGPT, automation enthusiasts, and technical product managers managing heavy, concurrent AI workloads on macOS.
3. Use Cases: Monitoring background coding agents and automated refactoring tasks while writing code in an IDE; coordinating multiple simultaneous research queries across Claude and ChatGPT without losing track of pending approval prompts; organizing large-scale personal or professional side projects into spatial mind maps based on underlying LLM conversation histories.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):
   • Pros: Completely free and open-source (MIT license); extremely lightweight (~5 MB binary footprint); native Swift performance supporting both Apple Silicon and Intel architectures (macOS 13+); powerful multi-platform integration bridging Claude and ChatGPT native states; local-first data architecture ensuring total privacy.
   • Cons: Requires macOS Accessibility permissions to read application states, and because the build is unnotarized, users must bypass initial Gatekeeper prompts via a one-time "Open Anyway" system approval.
2. Key Alternatives & Differentiation: Unlike traditional manual bookmarking or basic browser tab management extensions (such as OneTab or native Safari/Chrome tab groups), KIKUmap actively tracks internal LLM processing states (running, finished, waiting for approval) rather than merely displaying static URLs. Compared to enterprise AI orchestration suites or heavy multi-agent runners, KIKUmap remains a zero-cost, local utility focused strictly on session visibility and spatial task organization without requiring API keys, server-side data routing, or paid subscriptions.

Frequently Asked Questions (FAQ)

1. Question? Is KIKUmap safe to use regarding my private AI chat data?
   • KIKUmap is a 100% free and open-source project that runs entirely locally on your macOS machine. All chat metadata, mind maps, and usage logs stay on your device without transmitting data to third-party servers, though it does require macOS Accessibility permissions to interact with local app windows.
2. Question? Which operating systems and AI platforms are supported by KIKUmap?
   • KIKUmap supports macOS 13 (Ventura) or later on both Apple Silicon (M-series) and Intel processors. It natively tracks chats from Claude (including Claude Code terminal sessions) and the ChatGPT desktop application.
3. Question? Why does macOS prompt me that the KIKUmap app cannot be opened because it is from an unidentified developer?
   • Because the open-source app is distributed directly via GitHub releases without completing Apple's paid notarization process, macOS Gatekeeper blocks it by default. You can bypass this securely by right-clicking the app, selecting "Open," and approving it in your system security settings.
4. Question? How does KIKUmap distinguish between a chat that is actively streaming and one that has finished?
   • KIKUmap monitors local application interfaces and window states using macOS Accessibility APIs to detect completion markers, error states, and prompts requiring user confirmation, updating the menu bar ring and notification badges in real-time.