oh-my-adhd 0.2.0

package/dist/mcp/mcp/tools/wiki-structure.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { getPage } from "../../lib/brain.js";
+export function registerWikiStructure(server) {
+    server.tool("wiki_structure", "슬러그로 페이지의 날것 캡처 내용을 가져온다. Claude가 이 내용을 보고 ## 섹션으로 구조화한 뒤 wiki_save로 저장해야 한다.", {
+        slug: z.string().max(100).regex(/^[a-z0-9가-힣-]+$/).describe("구조화할 페이지 슬러그"),
+    }, async ({ slug }) => {
+        const page = await getPage(slug.toLowerCase());
+        if (!page) {
+            return { content: [{ type: "text", text: `페이지 없음: ${slug}` }], isError: true };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [
+                        `=== 페이지: [[${page.title}]] (slug: ${page.slug}) ===`,
+                        "",
+                        "아래 날것 내용을 ## 섹션으로 구조화해서 wiki_save 툴로 저장하세요.",
+                        "형식: # 제목\\n\\n## 섹션1\\n내용\\n\\n## 섹션2\\n내용",
+                        "",
+                        "=== 원본 내용 ===",
+                        page.content,
+                    ].join("\n"),
+                },
+            ],
+        };
+    });
+}

package/dist/mcp/mcp/tools/wiki-unstick.js

@@ -0,0 +1,110 @@
+import { z } from "zod";
+import { getThreads, getThread, OPEN_SIGNAL, extractFieldBrain } from "../../lib/brain.js";
+export function registerWikiUnstick(server) {
+    server.tool("wiki_unstick", "막혀서 무력감 느낄 때 호출. 이미 시도해서 안 된 것은 제외하고, 에너지 레벨에 맞는 가장 작은 한 발자국만 알려준다. low=2분, medium=5분, high=15분.", {
+        task: z.string().max(2000).optional().describe("막힌 태스크 직접 설명 (없으면 최근 미완료 스레드 자동 감지)"),
+        energy: z.enum(["low", "medium", "high"]).optional().default("medium").describe("현재 집중력/에너지 수준 (low=2분짜리, medium=5분짜리, high=15분짜리)"),
+    }, async ({ task, energy }) => {
+        try {
+            let targetTitle = "";
+            let targetContext = task ?? "";
+            const deadEnds = [];
+            let nextStep = "";
+            const blockers = [];
+            const crossThreadBlockers = [];
+            if (!targetContext) {
+                const threads = await getThreads();
+                const candidates = threads.slice(0, 5);
+                const contents = await Promise.all(candidates.map((t) => getThread(t.id)));
+                // open thread 우선 선택, 없으면 첫 번째 — 한 스레드에서만 필드 수집
+                let chosenIdx = candidates.findIndex((_, i) => {
+                    const c = contents[i];
+                    if (!c)
+                        return false;
+                    const lastCapture = c.split(/\n---\n/).slice(1).at(-1) ?? "";
+                    return OPEN_SIGNAL.test(lastCapture);
+                });
+                if (chosenIdx < 0)
+                    chosenIdx = 0;
+                const content = contents[chosenIdx];
+                const chosenThread = candidates[chosenIdx];
+                if (content) {
+                    const titleMatch = content.match(/^#\s+(.+)$/m);
+                    targetTitle = (titleMatch?.[1] ?? chosenThread.id).trim();
+                    const captures = content.split(/\n---\n/).slice(1).filter((p) => p.trim());
+                    const recentCaptures = captures.slice(-3);
+                    for (const cap of recentCaptures) {
+                        const de = extractFieldBrain(cap, "막힌것");
+                        if (de && !deadEnds.includes(de))
+                            deadEnds.push(de);
+                        const ns = extractFieldBrain(cap, "다음할것");
+                        if (ns)
+                            nextStep = ns;
+                        const bl = extractFieldBrain(cap, "블로커");
+                        if (bl && !blockers.includes(bl))
+                            blockers.push(bl);
+                    }
+                    targetContext = recentCaptures
+                        .map((c) => c.replace(/^(?:_[^_\n]+_|\*\*[^*\n]+\*\*)\s*/m, "").replace(/\n+/g, " ").trim())
+                        .filter(Boolean)
+                        .join("\n");
+                }
+                // Collect dead-ends from all open threads (not just the chosen one)
+                const allOpenThreads = threads.filter(t => t.is_open && t.id !== chosenThread.id);
+                for (const ot of allOpenThreads.slice(0, 10)) {
+                    const otContent = await getThread(ot.id);
+                    if (!otContent)
+                        continue;
+                    const otCaptures = otContent.split(/\n---\n/).slice(1).filter(p => p.trim());
+                    const otLast = otCaptures.at(-1) ?? "";
+                    const otText = otLast.replace(/^(?:_[^_\n]+_|\*\*[^*\n]+\*\*)\s*/m, "").trim();
+                    const otBlocker = extractFieldBrain(otText, "막힌것");
+                    const otBlockerKey = otBlocker.toLowerCase().replace(/\s+/g, " ").slice(0, 60);
+                    if (otBlocker && !deadEnds.some(d => d.toLowerCase().replace(/\s+/g, " ").includes(otBlockerKey))) {
+                        crossThreadBlockers.push(`[${ot.title?.slice(0, 20) ?? "다른 스레드"}] ${otBlocker}`);
+                    }
+                }
+            }
+            if (!task && !targetTitle && !targetContext) {
+                return { content: [{ type: "text", text: "막힌 대상을 찾지 못했어. 둘 중 하나로 다시 호출해줘:\n" +
+                                "1. `task` 인자에 막힌 상황 한 줄로 직접 적기\n" +
+                                "2. 먼저 `wiki_dump`로 지금 머릿속 상태를 던진 뒤 다시 `wiki_unstick` 호출\n" +
+                                "(저장된 스레드가 없거나 모두 완료 상태)"
+                        }] };
+            }
+            const taskSize = energy === "low" ? "2분" : energy === "high" ? "15분" : "5분";
+            const taskDetail = energy === "low"
+                ? "뇌를 거의 쓰지 않아도 되는 것 (파일 열기, 탭 찾기, 줄 읽기 수준)"
+                : energy === "high"
+                    ? "집중이 필요하지만 명확한 완결이 있는 것"
+                    : "결정 없이 바로 시작할 수 있는 것";
+            const lines = [
+                targetTitle ? `## 현재 작업: ${targetTitle}` : "## 현재 작업",
+                `> 에너지 레벨: ${energy} → ${taskSize}짜리 스텝`,
+                "",
+                "### 컨텍스트",
+                targetContext || task || "(컨텍스트 없음)",
+            ];
+            if (nextStep) {
+                lines.push("", `### 마지막으로 계획한 다음 스텝`, nextStep);
+            }
+            if (deadEnds.length > 0 || crossThreadBlockers.length > 0) {
+                lines.push("", "### ⛔ 이미 시도해서 안 된 것 (제안하지 말 것)");
+                deadEnds.forEach((d) => lines.push(`- ${d}`));
+                if (crossThreadBlockers.length > 0) {
+                    lines.push("", "⛔ 다른 스레드에서도 막혔던 것:");
+                    crossThreadBlockers.forEach((b) => lines.push(`  - ${b}`));
+                }
+            }
+            if (blockers.length > 0) {
+                lines.push("", "### 블로커");
+                blockers.forEach((b) => lines.push(`- ${b}`));
+            }
+            lines.push("", "---", "", `위 내용을 보고 **지금 당장 할 수 있는 ${taskSize}짜리 스텝 하나**만 알려줘.`, `조건: 행동 동사로 시작 / ${taskDetail} / ⛔ 목록에 있는 것 절대 제안 금지 / 한 줄`);
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `오류: ${e.message ?? String(e)}` }], isError: true };
+        }
+    });
+}

package/dist/mcp/mcp/utils.js

@@ -0,0 +1,31 @@
+import { execFile as execFileCb } from "child_process";
+import { promisify } from "util";
+const execFile = promisify(execFileCb);
+const GIT_OPTS = { maxBuffer: 1024 * 1024, timeout: 3000 };
+export async function git(...args) {
+    try {
+        const { stdout } = await execFile("git", args, GIT_OPTS);
+        return stdout.trim();
+    }
+    catch {
+        return "";
+    }
+}
+export async function captureGitContext() {
+    try {
+        const [branch, head, statusOut] = await Promise.all([
+            git("branch", "--show-current"),
+            git("rev-parse", "--short", "HEAD"),
+            git("status", "--porcelain=v1"),
+        ]);
+        const dirty = statusOut
+            ? statusOut.split("\n").filter(Boolean).map(l => l.slice(3).trim())
+            : [];
+        if (!branch && !head)
+            return "";
+        return `\n[git: ${branch}@${head}${dirty.length ? ` | dirty: ${dirty.slice(0, 3).join(", ")}` : ""}]`;
+    }
+    catch {
+        return "";
+    }
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "oh-my-adhd",
+  "version": "0.2.0",
+  "description": "ADHD second brain — zero-friction capture, auto context restore, unstick. MCP-native Claude Code plugin.",
+  "author": "Yeachan Heo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Yeachan-Heo/oh-my-adhd.git"
+  },
+  "homepage": "https://github.com/Yeachan-Heo/oh-my-adhd#readme",
+  "bugs": {
+    "url": "https://github.com/Yeachan-Heo/oh-my-adhd/issues"
+  },
+  "keywords": [
+    "claude",
+    "mcp",
+    "adhd",
+    "second-brain",
+    "claude-code",
+    "productivity"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "oh-my-adhd": "bin/oh-my-adhd.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "scripts"
+  ],
+  "scripts": {
+    "mcp": "tsx src/mcp/server.ts",
+    "build": "tsc -p tsconfig.mcp.json",
+    "mcp:build": "tsc -p tsconfig.mcp.json",
+    "prepublishOnly": "npm run build",
+    "start": "tsx src/mcp/server.ts",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "minisearch": "^7.2.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "tsx": "^4.22.3",
+    "typescript": "^5",
+    "vitest": "^2.0.0"
+  }
+}

package/scripts/capture.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# oh-my-adhd capture popup
+# Usage: bash capture.sh [threadId]
+# Bind ⌥+ADH to this script in your hotkey manager (Raycast, Hammerspoon, etc.)
+
+PORT=${OH_MY_ADHD_PORT:-3000}
+THREAD_ARG=""
+if [ -n "$1" ]; then
+  THREAD_ARG="?threadId=$1"
+fi
+
+URL="http://localhost:${PORT}/capture${THREAD_ARG}"
+
+# Open as a small popup window in the default browser
+osascript <<EOF
+tell application "Google Chrome"
+  activate
+  set w to make new window with properties {bounds:{200, 100, 760, 480}}
+  set URL of active tab of w to "${URL}"
+end tell
+EOF
+
+# Fallback: Safari
+if [ $? -ne 0 ]; then
+  osascript <<EOF2
+tell application "Safari"
+  activate
+  make new document with properties {URL:"${URL}"}
+end tell
+EOF2
+fi

package/scripts/com.oh-my-adhd.server.plist

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.oh-my-adhd.server</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/local/bin/npm</string>
+    <string>start</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>REPLACE_WITH_PROJECT_PATH</string>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>/tmp/oh-my-adhd.log</string>
+  <key>StandardErrorPath</key>
+  <string>/tmp/oh-my-adhd.err</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin</string>
+  </dict>
+</dict>
+</plist>

package/scripts/demo.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# oh-my-adhd demo script
+# Record with: asciinema rec demo.cast -c "bash scripts/demo.sh"
+set -e
+
+echo "# oh-my-adhd demo"
+echo ""
+sleep 1
+
+echo "$ npx oh-my-adhd init"
+sleep 0.5
+echo "  ✓ Brain    ~/.oh-my-adhd"
+echo "  ✓ MCP      oh-my-adhd 등록됨"
+echo "  ✓ Hooks    SessionStart + Stop"
+echo ""
+echo "지금 작업 중인 게 뭐야? (한 줄, 엔터로 건너뛰기)"
+echo "> React 폼 validation 리팩터링"
+sleep 0.5
+echo ""
+echo "✓ 첫 기억 심었어."
+echo "  Claude Code 재시작하면, Claude가 먼저"
+echo "  \"React 폼 validation 리팩터링\" 기억하고 이어서 갈지 물어볼 거야."
+echo ""
+echo "  까먹어도 괜찮아. 그게 이 도구의 일이야."
+sleep 2
+
+echo ""
+echo "# --- 다음 세션 (Claude Code 재시작 후) ---"
+sleep 1
+echo ""
+echo "[oh-my-adhd] 어제 어디까지 했더라..."
+sleep 1
+echo ""
+echo "## 어제 멈춘 곳"
+echo ""
+echo "> 🔴 React 폼 validation 리팩터링 — 15시간 전"
+echo "> → 다음: useFormState 마이그레이션 + 에러 메시지 i18n"
+echo "> ⛔ 막힌것: zod refine() 비동기 검증이 submit 중복 발생"
+echo ">"
+echo "> 이어서 갈까? (thread: abc123...)"
+sleep 2
+echo ""
+echo "# 이게 매 세션 자동으로 일어나."

package/scripts/install-launchagent.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Installs oh-my-adhd as a macOS LaunchAgent (auto-start on login)
+set -e
+
+PROJECT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+PLIST_SRC="$PROJECT_DIR/scripts/com.oh-my-adhd.server.plist"
+PLIST_DEST="$HOME/Library/LaunchAgents/com.oh-my-adhd.server.plist"
+
+NPM_BIN="$(which npm)"
+if [ -z "$NPM_BIN" ]; then
+  echo "npm not found. Please install Node.js first."
+  exit 1
+fi
+
+# Build production bundle
+echo "Building oh-my-adhd..."
+cd "$PROJECT_DIR"
+npm run build
+
+# Write plist with actual paths
+sed \
+  -e "s|REPLACE_WITH_PROJECT_PATH|$PROJECT_DIR|g" \
+  -e "s|/usr/local/bin/npm|$NPM_BIN|g" \
+  "$PLIST_SRC" > "$PLIST_DEST"
+
+# Load the agent
+launchctl unload "$PLIST_DEST" 2>/dev/null || true
+launchctl load "$PLIST_DEST"
+
+echo ""
+echo "✓ oh-my-adhd will start automatically on login."
+echo "  Logs: /tmp/oh-my-adhd.log"
+echo ""
+echo "Next: bind ⌥+ADH to:  bash $PROJECT_DIR/scripts/capture.sh"
+echo "      (use Raycast, Hammerspoon, or Karabiner)"

package/scripts/stop-hook.mjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+// oh-my-adhd Stop hook — blocks session end if no wiki_dump happened this session
+import { readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+
+const BRAIN_DIR = process.env.OH_MY_ADHD_DIR ?? join(homedir(), ".oh-my-adhd");
+const MANIFEST = join(BRAIN_DIR, "threads", ".manifest.json");
+const SESSION_START_FILE = join(BRAIN_DIR, ".session-start");
+
+try {
+  const sessionStartMs = parseInt(readFileSync(SESSION_START_FILE, "utf-8").trim(), 10);
+  if (isNaN(sessionStartMs)) process.exit(0); // no marker — don't block
+
+  let manifest;
+  try {
+    manifest = JSON.parse(readFileSync(MANIFEST, "utf-8"));
+  } catch {
+    process.exit(0); // no manifest — nothing to protect
+  }
+
+  // Allow stop if any dump happened after session start
+  const latestDump = manifest.reduce((max, t) => {
+    const ts = new Date(t.updatedAt).getTime();
+    return ts > max ? ts : max;
+  }, 0);
+  if (latestDump > sessionStartMs) process.exit(0);
+
+  // Block only if there are open threads worth saving
+  const openThreads = manifest.filter(t => t.is_open);
+  if (openThreads.length > 0) {
+    const top = openThreads[0];
+    const title = (top.title ?? "진행중인 작업").slice(0, 40);
+    const nextHint = top.next_action ? `\n→ 다음할것: ${top.next_action.slice(0, 60)}` : "";
+    process.stdout.write(JSON.stringify({
+      decision: "block",
+      reason: `저장 없이 끝내려고? "${title}" 스레드가 열려있어.${nextHint}\nwiki_dump로 결정/막힌것/다음할것 저장하고 끝내자.`,
+    }));
+  }
+} catch {
+  // Graceful degradation — never block due to script error
+}