mission-control-ai 1.0.0

package/bin/cli.mjs

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, mkdirSync, copyFileSync, existsSync, readdirSync, unlinkSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const HOOKS_SRC = join(__dirname, '..', 'hooks');
+const MC_DIR = join(homedir(), '.mission-control');
+const HOOKS_DEST = join(MC_DIR, 'hooks');
+const CLAUDE_SETTINGS = join(homedir(), '.claude', 'settings.json');
+
+const HOOK_FILES = [
+  'mc-claude-hook.py',
+  'mc-prompt-hook.py',
+  'mc-pretool-hook.py',
+  'mc-posttool-hook.py',
+];
+
+const HOOK_CONFIG = {
+  hooks: {
+    Stop: [
+      {
+        matcher: '',
+        hooks: [
+          {
+            type: 'command',
+            command: `python3 ${join(HOOKS_DEST, 'mc-claude-hook.py')}`,
+          },
+        ],
+      },
+    ],
+    UserPromptSubmit: [
+      {
+        matcher: '',
+        hooks: [
+          {
+            type: 'command',
+            command: `python3 ${join(HOOKS_DEST, 'mc-prompt-hook.py')}`,
+          },
+        ],
+      },
+    ],
+    PreToolUse: [
+      {
+        matcher: '',
+        hooks: [
+          {
+            type: 'command',
+            command: `python3 ${join(HOOKS_DEST, 'mc-pretool-hook.py')}`,
+          },
+        ],
+      },
+    ],
+    PostToolUse: [
+      {
+        matcher: '',
+        hooks: [
+          {
+            type: 'command',
+            command: `python3 ${join(HOOKS_DEST, 'mc-posttool-hook.py')}`,
+          },
+        ],
+      },
+    ],
+  },
+};
+
+function printHelp() {
+  console.log(`
+  Mission Control AI — monitor AI coding sessions in real time
+
+  Usage:
+    npx mission-control-ai setup      Install hooks for Claude Code
+    npx mission-control-ai uninstall   Remove hooks
+    npx mission-control-ai status      Show current session status
+    npx mission-control-ai help        Show this help
+  `);
+}
+
+function setup() {
+  console.log('\n  🚀 Mission Control AI — Setup\n');
+
+  // 1. Create directories
+  mkdirSync(HOOKS_DEST, { recursive: true });
+  mkdirSync(dirname(CLAUDE_SETTINGS), { recursive: true });
+  console.log('  ✓ Created ~/.mission-control/hooks/');
+
+  // 2. Copy hook scripts
+  for (const file of HOOK_FILES) {
+    const src = join(HOOKS_SRC, file);
+    const dest = join(HOOKS_DEST, file);
+    if (existsSync(src)) {
+      copyFileSync(src, dest);
+      console.log(`  ✓ Installed ${file}`);
+    } else {
+      console.log(`  ✗ Missing ${file} — skipped`);
+    }
+  }
+
+  // 3. Configure Claude Code settings
+  let settings = {};
+  if (existsSync(CLAUDE_SETTINGS)) {
+    try {
+      settings = JSON.parse(readFileSync(CLAUDE_SETTINGS, 'utf-8'));
+    } catch {
+      console.log('  ⚠ Could not parse existing settings.json — creating new one');
+    }
+  }
+
+  // Merge hooks without overwriting existing ones
+  if (!settings.hooks) settings.hooks = {};
+
+  for (const [hookName, hookEntries] of Object.entries(HOOK_CONFIG.hooks)) {
+    if (!settings.hooks[hookName]) {
+      settings.hooks[hookName] = hookEntries;
+    } else {
+      // Check if our hook is already there
+      const existing = settings.hooks[hookName];
+      for (const entry of hookEntries) {
+        const cmd = entry.hooks[0].command;
+        const alreadyExists = existing.some((e) =>
+          e.hooks?.some((h) => h.command === cmd)
+        );
+        if (!alreadyExists) {
+          existing.push(entry);
+        }
+      }
+    }
+  }
+
+  writeFileSync(CLAUDE_SETTINGS, JSON.stringify(settings, null, 2) + '\n');
+  console.log('  ✓ Updated ~/.claude/settings.json');
+
+  console.log('\n  ✅ Setup complete!');
+  console.log('  → Download the Mission Control app: https://github.com/alexko0421/MissionControl/releases');
+  console.log('  → Your Claude Code sessions will now appear in Mission Control.\n');
+}
+
+function uninstall() {
+  console.log('\n  🗑  Mission Control AI — Uninstall\n');
+
+  // 1. Remove hook files
+  if (existsSync(HOOKS_DEST)) {
+    for (const file of HOOK_FILES) {
+      const dest = join(HOOKS_DEST, file);
+      if (existsSync(dest)) {
+        unlinkSync(dest);
+        console.log(`  ✓ Removed ${file}`);
+      }
+    }
+  }
+
+  // 2. Remove hooks from Claude settings
+  if (existsSync(CLAUDE_SETTINGS)) {
+    try {
+      const settings = JSON.parse(readFileSync(CLAUDE_SETTINGS, 'utf-8'));
+      if (settings.hooks) {
+        for (const hookName of Object.keys(HOOK_CONFIG.hooks)) {
+          if (settings.hooks[hookName]) {
+            settings.hooks[hookName] = settings.hooks[hookName].filter(
+              (e) => !e.hooks?.some((h) => h.command?.includes('mission-control'))
+            );
+            if (settings.hooks[hookName].length === 0) {
+              delete settings.hooks[hookName];
+            }
+          }
+        }
+        if (Object.keys(settings.hooks).length === 0) {
+          delete settings.hooks;
+        }
+        writeFileSync(CLAUDE_SETTINGS, JSON.stringify(settings, null, 2) + '\n');
+        console.log('  ✓ Cleaned ~/.claude/settings.json');
+      }
+    } catch {
+      console.log('  ⚠ Could not parse settings.json');
+    }
+  }
+
+  console.log('\n  ✅ Uninstall complete.\n');
+}
+
+function status() {
+  const statusFile = join(MC_DIR, 'status.json');
+  if (!existsSync(statusFile)) {
+    console.log('\n  No active sessions. Start a Claude Code session first.\n');
+    return;
+  }
+
+  try {
+    const agents = JSON.parse(readFileSync(statusFile, 'utf-8'));
+    if (!agents.length) {
+      console.log('\n  No active sessions.\n');
+      return;
+    }
+
+    console.log('\n  Mission Control — Active Sessions\n');
+    const statusIcons = { running: '🟢', blocked: '🟠', done: '✅', idle: '💤' };
+    for (const a of agents) {
+      const icon = statusIcons[a.status] || '⚪';
+      console.log(`  ${icon} ${a.name} — ${a.status}`);
+      if (a.task) console.log(`     ${a.task}`);
+    }
+    console.log();
+  } catch {
+    console.log('\n  Could not read status file.\n');
+  }
+}
+
+// Main
+const command = process.argv[2] || 'help';
+
+switch (command) {
+  case 'setup':
+  case 'install':
+    setup();
+    break;
+  case 'uninstall':
+  case 'remove':
+    uninstall();
+    break;
+  case 'status':
+    status();
+    break;
+  default:
+    printHelp();
+}

package/hooks/mc-claude-hook.py

@@ -0,0 +1,347 @@
+#!/usr/bin/env python3
+"""Claude Code Stop hook — reads Claude's last message from stdin and updates Mission Control.
+
+No Gemini needed. Claude knows what it's doing — just ask it.
+
+Usage in ~/.claude/settings.json:
+{
+  "hooks": {
+    "Stop": [{
+      "matcher": "",
+      "hooks": [{
+        "type": "command",
+        "command": "python3 ~/Library/Mobile\\ Documents/com~apple~CloudDocs/MissionControl/scripts/mc-claude-hook.py"
+      }]
+    }]
+  }
+}
+"""
+
+import json
+import os
+import sys
+import re
+import hashlib
+import subprocess
+from datetime import datetime, timezone
+from urllib.request import Request, urlopen
+
+STATUS_DIR = os.path.expanduser("~/.mission-control")
+STATUS_FILE = os.path.join(STATUS_DIR, "status.json")
+os.makedirs(STATUS_DIR, exist_ok=True)
+
+# Gemini API key for summarization
+API_KEY = os.environ.get("GEMINI_API_KEY", "")
+if not API_KEY:
+    key_file = os.path.join(STATUS_DIR, "gemini-key.txt")
+    if os.path.exists(key_file):
+        API_KEY = open(key_file).read().strip()
+
+def get_project_name(cwd):
+    """Get a readable project name from the working directory.
+    Tries git branch name first (more descriptive), falls back to directory name.
+    """
+    if not cwd:
+        return "Unknown"
+    # Try git branch name
+    try:
+        branch = subprocess.check_output(
+            ["git", "-C", cwd, "branch", "--show-current"],
+            stderr=subprocess.DEVNULL, timeout=3
+        ).decode().strip()
+        if branch:
+            # Clean up: remove username prefix like "alexko0421/"
+            if "/" in branch:
+                branch = branch.split("/", 1)[1]
+            # Convert kebab-case to readable: "fix-security-audit-v1" → "fix security audit v1"
+            return branch.replace("-", " ").replace("_", " ")
+    except:
+        pass
+    return os.path.basename(cwd)
+
+def detect_app():
+    """Detect which app this Claude session is running in."""
+    bundle_id = os.environ.get("__CFBundleIdentifier", "")
+    mapping = {
+        "com.apple.Terminal": "Terminal",
+        "com.google.antigravity": "Antigravity",
+    }
+    if bundle_id in mapping:
+        return mapping[bundle_id]
+    # Check parent process for conductor/codex
+    try:
+        ppid = os.getppid()
+        while ppid > 1:
+            cmd = subprocess.check_output(
+                ["ps", "-p", str(ppid), "-o", "comm="],
+                stderr=subprocess.DEVNULL, timeout=3
+            ).decode().strip()
+            cmd_lower = cmd.lower()
+            if "conductor" in cmd_lower:
+                return "Conductor"
+            if "codex" in cmd_lower:
+                return "Codex"
+            if "antigravity" in cmd_lower:
+                return "Antigravity"
+            # Get parent of parent
+            ppid_str = subprocess.check_output(
+                ["ps", "-p", str(ppid), "-o", "ppid="],
+                stderr=subprocess.DEVNULL, timeout=3
+            ).decode().strip()
+            ppid = int(ppid_str)
+    except:
+        pass
+    if bundle_id:
+        # Return bundle name as fallback
+        parts = bundle_id.split(".")
+        return parts[-1].capitalize() if parts else "Terminal"
+    return "Terminal"
+
+def detect_tmux():
+    """Detect if we're running inside tmux and return session/window/pane."""
+    if not os.environ.get("TMUX"):
+        return None, 0, 0
+    try:
+        session = subprocess.check_output(
+            ["tmux", "display-message", "-p", "#{session_name}"],
+            stderr=subprocess.DEVNULL, timeout=3
+        ).decode().strip()
+        window = subprocess.check_output(
+            ["tmux", "display-message", "-p", "#{window_index}"],
+            stderr=subprocess.DEVNULL, timeout=3
+        ).decode().strip()
+        pane = subprocess.check_output(
+            ["tmux", "display-message", "-p", "#{pane_index}"],
+            stderr=subprocess.DEVNULL, timeout=3
+        ).decode().strip()
+        return session or None, int(window or 0), int(pane or 0)
+    except:
+        return None, 0, 0
+
+def guess_status(message):
+    """Simple heuristic for agent status based on message content."""
+    msg = message.lower()
+    # Blocked signals: asking questions, waiting for input
+    blocked_signals = [
+        # English
+        "which option", "do you want", "should i", "please choose", "waiting for",
+        "need your", "what do you think", "let me know", "your choice", "pick one",
+        "would you like", "want me to", "prefer", "choose between",
+        "option a", "option b", "option 1", "option 2",
+        "approach a", "approach b", "approach 1", "approach 2",
+        "which do you", "which would you", "what would you",
+        "your decision", "your input", "your feedback",
+        "select one", "pick between", "decide between",
+        # Simplified Chinese
+        "你想", "你觉得", "要你决定", "需要你", "你的意见", "请选择",
+        "你选", "你希望", "你认为", "请确认", "你来决定", "你决定",
+        "方案a", "方案b", "方案1", "方案2", "选项a", "选项b",
+        "哪个", "哪种", "要哪", "选哪", "你要",
+        # Traditional Chinese
+        "你覺得", "你選", "你希望", "你認為", "請確認", "請選擇",
+        "你來決定", "邊個", "邊種",
+    ]
+    # Question mark at end of last few lines is a strong signal
+    lines = [l.strip() for l in message.strip().split("\n") if l.strip()]
+    for line in lines[-3:]:  # check last 3 lines
+        if line.endswith("?") or line.endswith("？") or line.endswith("吗") or line.endswith("嗎") or line.endswith("呢"):
+            return "blocked"
+    for signal in blocked_signals:
+        if signal in msg:
+            return "blocked"
+    return "running"
+
+def truncate(text, max_len):
+    """Truncate text to max_len, adding ... if needed."""
+    if len(text) <= max_len:
+        return text
+    return text[:max_len - 3] + "..."
+
+def get_app_language():
+    """Read app language setting from UserDefaults."""
+    try:
+        result = subprocess.check_output(
+            ["defaults", "read", "com.missioncontrol.app", "appLanguage"],
+            stderr=subprocess.DEVNULL, timeout=3
+        ).decode().strip()
+        return result if result in ("En", "Zh") else "Zh"
+    except:
+        return "Zh"
+
+def summarize_with_gemini(message, project_name):
+    """Use Gemini to distill Claude's raw output into a clean summary."""
+    if not API_KEY:
+        return None
+
+    lang = get_app_language()
+
+    # Truncate message to avoid huge API calls
+    msg = message[:3000] if len(message) > 3000 else message
+
+    if lang == "En":
+        prompt = (
+            "You are Mission Control's summary engine. Distill AI coding agent output into a clean summary.\n\n"
+            "Rules:\n"
+            "- Use concise English\n"
+            "- task: one sentence about current work (max 40 chars), e.g. 'Implement global hotkey toggle'\n"
+            "- summary: 2-3 sentences about what was done and progress (max 200 chars)\n"
+            "- nextAction: what to do next (max 100 chars)\n"
+            "- status rules (very important):\n"
+            "  - blocked: message ends with question mark, or asks user to choose/decide/confirm\n"
+            "  - done: explicitly says 'done'/'complete' with no follow-up questions\n"
+            "  - running: all other cases\n"
+            "- Do not repeat raw output, distill key points\n"
+            "- Describe features, not filenames\n\n"
+            f"Project: {project_name}\n"
+            f"AI Agent raw output:\n{msg}\n\n"
+            "Reply in JSON only, no markdown code block.\n"
+            'Format: {"status":"...","task":"...","summary":"...","nextAction":"..."}\n'
+        )
+    else:
+        prompt = (
+            "你是 Mission Control 的摘要引擎。你的工作是将 AI coding agent 的原始输出提炼成简洁的工作摘要。\n\n"
+            "规则：\n"
+            "- 用简体中文书面语\n"
+            "- task: 一句话讲当前在做什么（最多20字），例如「实现全局快捷键切换面板」\n"
+            "- summary: 2-3句讲做了什么、进度到哪（最多100字）\n"
+            "- nextAction: 下一步要做什么（最多50字）\n"
+            "- status 判断规则（非常重要）：\n"
+            "  - blocked: 消息结尾有问号、或要求用户做选择/决定/确认\n"
+            "  - done: 明确说「完成」「done」且没有后续问题\n"
+            "  - running: 其他所有情况（正在工作、刚做完但还有下一步）\n"
+            "- 不要重复原文，要提炼重点\n"
+            "- 不要提及文件名，讲功能\n\n"
+            f"Project: {project_name}\n"
+            f"AI Agent 原始输出：\n{msg}\n\n"
+            "用 JSON 回复，不要加 markdown code block。\n"
+            '格式：{"status":"...","task":"...","summary":"...","nextAction":"..."}\n'
+        )
+    body = json.dumps({
+        "contents": [{"parts": [{"text": prompt}]}],
+        "generationConfig": {"temperature": 0.1, "maxOutputTokens": 300}
+    }).encode()
+    url = f"https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key={API_KEY}"
+
+    try:
+        resp = urlopen(Request(url, data=body, headers={"Content-Type": "application/json"}), timeout=8)
+        data = json.loads(resp.read())
+        text = data["candidates"][0]["content"]["parts"][0]["text"]
+        text = re.sub(r"```json?\s*", "", text)
+        text = re.sub(r"```", "", text)
+        return json.loads(text.strip())
+    except:
+        return None
+
+def main():
+    # Read hook input from stdin
+    try:
+        raw = sys.stdin.read()
+        if not raw.strip():
+            return
+        hook_input = json.loads(raw)
+    except (json.JSONDecodeError, IOError):
+        return
+
+    message = hook_input.get("last_assistant_message", "")
+    cwd = hook_input.get("cwd", "")
+    session_id = hook_input.get("session_id", "")
+    stop_reason = hook_input.get("stop_reason", "")
+
+    # Debug: log raw hook input to see available fields
+    debug_file = os.path.join(STATUS_DIR, "hook-debug.json")
+    with open(debug_file, "w") as df:
+        json.dump({"keys": list(hook_input.keys()), "stop_reason": stop_reason, "raw_sample": {k: str(v)[:200] for k, v in hook_input.items()}}, df, indent=2)
+
+    if not message or not cwd:
+        return
+
+    project_name = get_project_name(cwd)
+    agent_id = hashlib.md5(cwd.encode()).hexdigest()[:8]
+    now = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    # If Claude stopped because it wants to use a tool → likely waiting for user approval
+    is_tool_use_stop = (stop_reason == "tool_use")
+
+    # Try Gemini summarization first, fall back to naive extraction
+    result = summarize_with_gemini(message, project_name)
+    if result:
+        status = result.get("status", "running")
+        task = truncate(result.get("task", "Working..."), 60)
+        summary = truncate(result.get("summary", ""), 300)
+        next_action = truncate(result.get("nextAction", ""), 200)
+    else:
+        status = guess_status(message)
+        lines = [l.strip() for l in message.split("\n") if l.strip() and len(l.strip()) > 5]
+        task = truncate(lines[0], 60) if lines else "Working..."
+        summary = truncate(" ".join(lines[:3]), 300) if lines else ""
+        next_action = truncate(lines[-1], 200) if lines else ""
+
+    # Override: tool_use stop means Claude is waiting for approval → blocked
+    if is_tool_use_stop and status != "done":
+        status = "blocked"
+
+    # Load existing agents
+    agents = []
+    if os.path.exists(STATUS_FILE):
+        try:
+            with open(STATUS_FILE) as f:
+                agents = json.load(f)
+        except (json.JSONDecodeError, IOError):
+            agents = []
+
+    # Update or add this agent
+    found = False
+    app_name = detect_app()
+    for i, a in enumerate(agents):
+        if a["id"] == agent_id:
+            tmux_s, tmux_w, tmux_p = detect_tmux()
+            agents[i].update({
+                "name": project_name,
+                "status": status,
+                "task": task,
+                "summary": summary,
+                "nextAction": next_action,
+                "updatedAt": now,
+                "app": app_name,
+                "tmuxSession": tmux_s,
+                "tmuxWindow": tmux_w,
+                "tmuxPane": tmux_p,
+            })
+            found = True
+            break
+
+    tmux_session, tmux_window, tmux_pane = detect_tmux()
+
+    if not found:
+        agents.append({
+            "id": agent_id,
+            "name": project_name,
+            "status": status,
+            "task": task,
+            "summary": summary,
+            "terminalLines": [],
+            "nextAction": next_action,
+            "updatedAt": now,
+            "worktree": cwd,
+            "app": app_name,
+            "tmuxSession": tmux_session,
+            "tmuxWindow": tmux_window,
+            "tmuxPane": tmux_pane,
+        })
+
+    # Cleanup stale/duplicate entries before writing
+    try:
+        import importlib.util
+        spec = importlib.util.spec_from_file_location("mc_cleanup",
+            os.path.join(os.path.dirname(os.path.abspath(__file__)), "mc-cleanup.py"))
+        mod = importlib.util.module_from_spec(spec)
+        spec.loader.exec_module(mod)
+        agents = mod.cleanup_agents(agents)
+    except:
+        pass
+
+    with open(STATUS_FILE, "w") as f:
+        json.dump(agents, f, ensure_ascii=False, indent=2)
+
+if __name__ == "__main__":
+    main()

package/hooks/mc-posttool-hook.py

@@ -0,0 +1,51 @@
+#!/usr/bin/env python3
+"""Claude Code PostToolUse hook — marks agent back to 'running' after tool executes.
+
+After the user approves a tool and it executes, set status back to 'running'.
+"""
+
+import json
+import os
+import sys
+import hashlib
+from datetime import datetime, timezone
+
+STATUS_DIR = os.path.expanduser("~/.mission-control")
+STATUS_FILE = os.path.join(STATUS_DIR, "status.json")
+os.makedirs(STATUS_DIR, exist_ok=True)
+
+def main():
+    try:
+        raw = sys.stdin.read()
+        if not raw.strip():
+            return
+        hook_input = json.loads(raw)
+    except (json.JSONDecodeError, IOError):
+        return
+
+    cwd = hook_input.get("cwd", "")
+    if not cwd:
+        return
+
+    agent_id = hashlib.md5(cwd.encode()).hexdigest()[:8]
+    now = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    agents = []
+    if os.path.exists(STATUS_FILE):
+        try:
+            with open(STATUS_FILE) as f:
+                agents = json.load(f)
+        except (json.JSONDecodeError, IOError):
+            agents = []
+
+    for i, a in enumerate(agents):
+        if a["id"] == agent_id:
+            agents[i]["status"] = "running"
+            agents[i]["updatedAt"] = now
+            break
+
+    with open(STATUS_FILE, "w") as f:
+        json.dump(agents, f, ensure_ascii=False, indent=2)
+
+if __name__ == "__main__":
+    main()

package/hooks/mc-pretool-hook.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+"""Claude Code PreToolUse hook — marks agent as 'blocked' when a tool needs approval.
+
+When Claude wants to use a tool (Edit, Write, Bash, etc.), the CLI may show
+an approval prompt. This hook sets the agent status to 'blocked' so Mission
+Control shows '需要你'.
+"""
+
+import json
+import os
+import sys
+import hashlib
+from datetime import datetime, timezone
+
+STATUS_DIR = os.path.expanduser("~/.mission-control")
+STATUS_FILE = os.path.join(STATUS_DIR, "status.json")
+os.makedirs(STATUS_DIR, exist_ok=True)
+
+def main():
+    try:
+        raw = sys.stdin.read()
+        if not raw.strip():
+            return
+        hook_input = json.loads(raw)
+    except (json.JSONDecodeError, IOError):
+        return
+
+    cwd = hook_input.get("cwd", "")
+    if not cwd:
+        return
+
+    agent_id = hashlib.md5(cwd.encode()).hexdigest()[:8]
+    now = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    agents = []
+    if os.path.exists(STATUS_FILE):
+        try:
+            with open(STATUS_FILE) as f:
+                agents = json.load(f)
+        except (json.JSONDecodeError, IOError):
+            agents = []
+
+    for i, a in enumerate(agents):
+        if a["id"] == agent_id:
+            agents[i]["status"] = "blocked"
+            agents[i]["updatedAt"] = now
+            break
+
+    with open(STATUS_FILE, "w") as f:
+        json.dump(agents, f, ensure_ascii=False, indent=2)
+
+if __name__ == "__main__":
+    main()

package/hooks/mc-prompt-hook.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""Claude Code UserPromptSubmit hook — immediately marks agent as 'running' when user sends a message.
+
+This makes Mission Control update in real-time: the moment you hit Enter,
+the status changes from blocked/done to running.
+"""
+
+import json
+import os
+import sys
+import hashlib
+import subprocess
+from datetime import datetime, timezone
+
+STATUS_DIR = os.path.expanduser("~/.mission-control")
+STATUS_FILE = os.path.join(STATUS_DIR, "status.json")
+os.makedirs(STATUS_DIR, exist_ok=True)
+
+def _get_name(cwd):
+    try:
+        branch = subprocess.check_output(
+            ["git", "-C", cwd, "branch", "--show-current"],
+            stderr=subprocess.DEVNULL, timeout=3
+        ).decode().strip()
+        if branch:
+            if "/" in branch:
+                branch = branch.split("/", 1)[1]
+            return branch.replace("-", " ").replace("_", " ")
+    except:
+        pass
+    return os.path.basename(cwd)
+
+def main():
+    try:
+        raw = sys.stdin.read()
+        if not raw.strip():
+            return
+        hook_input = json.loads(raw)
+    except (json.JSONDecodeError, IOError):
+        return
+
+    cwd = hook_input.get("cwd", "")
+    if not cwd:
+        return
+
+    agent_id = hashlib.md5(cwd.encode()).hexdigest()[:8]
+    now = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    # Load existing agents
+    agents = []
+    if os.path.exists(STATUS_FILE):
+        try:
+            with open(STATUS_FILE) as f:
+                agents = json.load(f)
+        except (json.JSONDecodeError, IOError):
+            agents = []
+
+    # Find and update this agent to running
+    for i, a in enumerate(agents):
+        if a["id"] == agent_id:
+            agents[i]["status"] = "running"
+            agents[i]["updatedAt"] = now
+            break
+    else:
+        # Agent not found yet — create a minimal entry
+        agents.append({
+            "id": agent_id,
+            "name": _get_name(cwd),
+            "status": "running",
+            "task": "處理中...",
+            "summary": "",
+            "terminalLines": [],
+            "nextAction": "",
+            "updatedAt": now,
+            "worktree": cwd,
+            "tmuxSession": None,
+            "tmuxWindow": 0,
+            "tmuxPane": 0,
+        })
+
+    with open(STATUS_FILE, "w") as f:
+        json.dump(agents, f, ensure_ascii=False, indent=2)
+
+if __name__ == "__main__":
+    main()

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "mission-control-ai",
+  "version": "1.0.0",
+  "description": "A macOS floating dashboard that monitors multiple AI coding sessions in real time",
+  "bin": {
+    "mission-control-ai": "bin/cli.mjs"
+  },
+  "type": "module",
+  "license": "MIT",
+  "author": "Ko Chunlong",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alexko0421/MissionControl.git"
+  },
+  "keywords": [
+    "mission-control",
+    "ai",
+    "claude-code",
+    "claude",
+    "codex",
+    "antigravity",
+    "conductor",
+    "dashboard",
+    "macos",
+    "developer-tools"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "hooks/"
+  ]
+}