@plaud-ai/mcp 0.1.58 → 0.2.0

package/dist/install-TU2Y3ARS.js

@@ -0,0 +1,370 @@
+import {
+  getClient
+} from "./chunk-7KGB7GSZ.js";
+import {
+  copyToClipboard,
+  getMcpEntry,
+  writeSkillsToClaudeCode
+} from "./chunk-UPEENHCG.js";
+import {
+  skillsCombined
+} from "./chunk-4QBEOJPX.js";
+import "./chunk-SNSGVRCU.js";
+
+// src/install.ts
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+import { createInterface } from "readline/promises";
+import { createServer } from "http";
+import { join, dirname } from "path";
+import { homedir, platform } from "os";
+import { spawnSync } from "child_process";
+import open from "open";
+function claudeDesktopConfigPath() {
+  if (platform() === "darwin") {
+    return join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
+  }
+  if (platform() === "win32") {
+    return join(process.env.APPDATA ?? "", "Claude", "claude_desktop_config.json");
+  }
+  return null;
+}
+function claudeCodeDir() {
+  return join(homedir(), ".claude");
+}
+function codexConfigPath() {
+  return join(homedir(), ".codex", "config.toml");
+}
+function detectClients() {
+  const list = [];
+  const cdPath = claudeDesktopConfigPath();
+  list.push({
+    id: "claude-desktop",
+    label: "Claude Desktop",
+    detected: cdPath !== null && (existsSync(cdPath) || existsSync(dirname(cdPath))),
+    configPath: cdPath ?? "(unsupported on this OS)"
+  });
+  const ccDir = claudeCodeDir();
+  list.push({
+    id: "claude-code",
+    label: "Claude Code",
+    detected: existsSync(ccDir),
+    configPath: ccDir
+  });
+  const codexPath = codexConfigPath();
+  list.push({
+    id: "codex",
+    label: "Codex Desktop",
+    detected: existsSync(codexPath) || existsSync(dirname(codexPath)),
+    configPath: codexPath
+  });
+  return list;
+}
+async function prompt(question, defaultYes = true) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const hint = defaultYes ? "Y/n" : "y/N";
+  const answer = (await rl.question(`${question} [${hint}] `)).trim().toLowerCase();
+  rl.close();
+  if (answer === "") return defaultYes;
+  return answer.startsWith("y");
+}
+async function installClaudeDesktop() {
+  const configPath = claudeDesktopConfigPath();
+  if (!configPath) return "skipped (OS not supported)";
+  let config = {};
+  try {
+    const raw = await readFile(configPath, "utf-8");
+    config = JSON.parse(raw);
+  } catch {
+  }
+  const mcpServers = config.mcpServers ?? {};
+  if (mcpServers.plaud) return "already configured";
+  config.mcpServers = { ...mcpServers, plaud: getMcpEntry() };
+  await mkdir(dirname(configPath), { recursive: true });
+  await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+  return "configured. Restart Claude Desktop to load the Plaud MCP.";
+}
+async function installClaudeCode() {
+  await writeSkillsToClaudeCode();
+  const { command, args } = getMcpEntry();
+  const manualCmd = `claude mcp add --scope user plaud ${command} ${args.join(" ")}`;
+  const cliCheck = spawnSync("which", ["claude"], { encoding: "utf-8" });
+  if (cliCheck.status !== 0) {
+    return `skills written to ~/.claude/CLAUDE.md. Claude Code CLI not on PATH \u2014 once installed, run:
+  ${manualCmd}`;
+  }
+  const existing = spawnSync("claude", ["mcp", "get", "plaud"], { encoding: "utf-8" });
+  if (existing.status === 0) {
+    return "skills written to ~/.claude/CLAUDE.md. MCP already registered (scope: user).";
+  }
+  const register = spawnSync(
+    "claude",
+    ["mcp", "add", "--scope", "user", "plaud", command, ...args],
+    { encoding: "utf-8" }
+  );
+  if (register.status !== 0) {
+    const err = (register.stderr || register.stdout || "").trim();
+    return `skills written to ~/.claude/CLAUDE.md. Failed to auto-register MCP (${err || "unknown"}). Run manually:
+  ${manualCmd}`;
+  }
+  return "skills written to ~/.claude/CLAUDE.md and MCP registered at user scope.";
+}
+async function installCodex() {
+  const configPath = codexConfigPath();
+  const { command, args } = getMcpEntry();
+  const argsStr = args.map((a) => `"${a}"`).join(", ");
+  const entry = `
+[mcp_servers.plaud]
+command = "${command}"
+args = [${argsStr}]
+`;
+  let content = "";
+  try {
+    content = await readFile(configPath, "utf-8");
+  } catch {
+  }
+  if (content.includes("[mcp_servers.plaud]")) return "already configured";
+  await mkdir(dirname(configPath), { recursive: true });
+  await writeFile(configPath, content + entry, "utf-8");
+  await writeSkillsToClaudeCode();
+  const combined = await skillsCombined();
+  const copied = copyToClipboard(combined);
+  return copied ? "configured. Skills copied to clipboard \u2014 paste into Codex custom instructions, then restart." : "configured. Paste the Plaud skills into Codex custom instructions manually (see docs).";
+}
+var CALLBACK_PORT = 8199;
+var LOGIN_TIMEOUT_MS = 12e4;
+function pickIdentity(user) {
+  for (const k of ["email", "username", "name", "id"]) {
+    const v = user[k];
+    if (typeof v === "string" && v.length > 0) return v;
+  }
+  return void 0;
+}
+async function runLogin() {
+  const client = getClient();
+  try {
+    const existing = await client.auth.getAccessToken();
+    if (existing) {
+      try {
+        const user = await client.getCurrentUser();
+        return { status: "already-authed", who: pickIdentity(user) };
+      } catch {
+        return { status: "already-authed" };
+      }
+    }
+  } catch {
+    await client.auth.logout().catch(() => void 0);
+  }
+  const { url, codeVerifier, state } = client.auth.createAuthorizationRequest();
+  return new Promise((resolve) => {
+    const httpServer = createServer(async (req, res) => {
+      const reqUrl = new URL(req.url, `http://localhost:${CALLBACK_PORT}`);
+      if (reqUrl.pathname !== "/auth/callback") {
+        res.writeHead(404);
+        res.end();
+        return;
+      }
+      const code = reqUrl.searchParams.get("code");
+      if (!code) {
+        res.writeHead(400);
+        res.end("Missing code");
+        cleanup();
+        resolve({ status: "failed", message: "missing authorization code in callback" });
+        return;
+      }
+      try {
+        await client.auth.exchangeCode(code, codeVerifier, state);
+        res.writeHead(200, { "Content-Type": "text/html" });
+        res.end("<h1>Authentication successful!</h1><p>You can close this tab.</p>");
+        cleanup();
+        let who;
+        try {
+          const user = await client.getCurrentUser();
+          who = pickIdentity(user);
+        } catch {
+        }
+        resolve({ status: "success", who });
+      } catch (err) {
+        res.writeHead(500, { "Content-Type": "text/html" });
+        res.end("<h1>Token exchange failed</h1>");
+        cleanup();
+        resolve({ status: "failed", message: err instanceof Error ? err.message : String(err) });
+      }
+    });
+    let timeoutId;
+    function cleanup() {
+      clearTimeout(timeoutId);
+      httpServer.closeAllConnections?.();
+      httpServer.close();
+    }
+    timeoutId = setTimeout(() => {
+      cleanup();
+      resolve({ status: "timeout" });
+    }, LOGIN_TIMEOUT_MS);
+    httpServer.listen(CALLBACK_PORT, () => {
+      open(url).catch(() => {
+        cleanup();
+        resolve({ status: "failed", message: `could not open browser. Visit manually: ${url}` });
+      });
+    });
+    httpServer.on("error", (err) => {
+      cleanup();
+      resolve({ status: "failed", message: `callback server error: ${err.message}` });
+    });
+  });
+}
+async function runInstall(opts = {}) {
+  console.log("Plaud MCP installer\n");
+  const clients = detectClients();
+  console.log("Detected AI clients:");
+  for (const c of clients) {
+    const mark = c.detected ? "\u2713" : "\xB7";
+    console.log(`  ${mark} ${c.label.padEnd(16)} ${c.detected ? c.configPath : "(not detected)"}`);
+  }
+  console.log();
+  const selected = [];
+  if (opts.yes) {
+    for (const c of clients) {
+      if (c.detected) selected.push(c);
+    }
+    if (selected.length > 0) {
+      console.log(`--yes: configuring ${selected.map((c) => c.label).join(", ")} without prompting.
+`);
+    }
+  } else {
+    for (const c of clients) {
+      if (!c.detected) continue;
+      const yes = await prompt(`Configure ${c.label}?`, true);
+      if (yes) selected.push(c);
+    }
+  }
+  if (selected.length === 0) {
+    console.log("\nNothing to configure. Exiting.");
+    process.exit(0);
+  }
+  console.log();
+  const succeeded = [];
+  for (const c of selected) {
+    process.stdout.write(`\u2192 ${c.label}... `);
+    try {
+      let result = "";
+      if (c.id === "claude-desktop") result = await installClaudeDesktop();
+      else if (c.id === "claude-code") result = await installClaudeCode();
+      else if (c.id === "codex") result = await installCodex();
+      console.log(result);
+      if (!/^(skipped|failed)/i.test(result)) succeeded.push(c);
+    } catch (err) {
+      console.log(`failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  const loginOutcome = opts.noLogin ? null : await doLoginStep(Boolean(opts.yes));
+  printNextSteps(succeeded, loginOutcome);
+  process.exit(0);
+}
+async function doLoginStep(nonInteractive) {
+  console.log();
+  console.log("\u2192 Authenticating with Plaud...");
+  const client = getClient();
+  try {
+    const existing = await client.auth.getAccessToken();
+    if (existing) {
+      try {
+        const user = await client.getCurrentUser();
+        const who = pickIdentity(user);
+        console.log(`  already signed in${who ? ` as ${who}` : ""} \u2014 skipping OAuth.`);
+        return { status: "already-authed", who };
+      } catch {
+        console.log("  token present but user lookup failed \u2014 will re-auth.");
+      }
+    }
+  } catch {
+  }
+  if (!nonInteractive) {
+    const yes = await prompt("Log in to Plaud now? (opens browser)", true);
+    if (!yes) {
+      console.log("  skipped \u2014 you'll be prompted on first tool call after restart.");
+      return null;
+    }
+  }
+  console.log("  opening browser \u2014 click Authorize to finish.");
+  const outcome = await runLogin();
+  switch (outcome.status) {
+    case "already-authed":
+      console.log(`  already signed in${outcome.who ? ` as ${outcome.who}` : ""}.`);
+      break;
+    case "success":
+      console.log(`  \u2713 authenticated${outcome.who ? ` as ${outcome.who}` : ""}.`);
+      break;
+    case "timeout":
+      console.log("  \u2717 timed out after 2 minutes \u2014 you can retry with `plaud-mcp install --yes` or run `login` from your AI client.");
+      break;
+    case "failed":
+      console.log(`  \u2717 failed: ${outcome.message}`);
+      break;
+  }
+  return outcome;
+}
+function restartLine(id) {
+  switch (id) {
+    case "claude-desktop":
+      return "Fully quit Claude Desktop (\u2318Q on macOS) and reopen it \u2014 closing the window is not enough.";
+    case "claude-code":
+      return "Exit any running Claude Code session and start a new `claude` session.";
+    case "codex":
+      return "Quit Codex Desktop and reopen it.";
+  }
+}
+function printNextSteps(clients, login) {
+  console.log();
+  if (clients.length === 0) {
+    console.log("No clients were configured. Nothing to do.");
+    return;
+  }
+  const authed = login?.status === "already-authed" || login?.status === "success";
+  const bar = "\u2500".repeat(60);
+  console.log(bar);
+  console.log(`\u2713 Plaud MCP installed for: ${clients.map((c) => c.label).join(", ")}`);
+  if (authed) {
+    console.log(`\u2713 Authenticated${login?.who ? ` as ${login.who}` : ""}`);
+  }
+  console.log(bar);
+  console.log();
+  if (authed) {
+    console.log("NEXT \u2014 one thing left:");
+    console.log();
+    if (clients.length === 1) {
+      console.log(`  ${restartLine(clients[0].id)}`);
+    } else {
+      console.log("  Restart each configured client:");
+      for (const c of clients) {
+        console.log(`    \u2022 ${c.label}: ${restartLine(c.id)}`);
+      }
+    }
+    console.log();
+    console.log("  After restart, Plaud tools are live \u2014 just ask your AI client");
+    console.log('  about your recordings (e.g. "list my recent Plaud recordings").');
+  } else {
+    console.log("NEXT \u2014 do these two things:");
+    console.log();
+    if (clients.length === 1) {
+      console.log(`  1. ${restartLine(clients[0].id)}`);
+    } else {
+      console.log("  1. Restart each configured client:");
+      for (const c of clients) {
+        console.log(`       \u2022 ${c.label}: ${restartLine(c.id)}`);
+      }
+    }
+    console.log();
+    console.log("  2. In any chat with your AI client, type:");
+    console.log();
+    console.log("       list my recent Plaud recordings");
+    console.log();
+    console.log("     This triggers OAuth in your browser (once). Tokens are then");
+    console.log("     stored in ~/.plaud/tokens.json and refreshed automatically.");
+  }
+  console.log();
+  console.log(bar);
+}
+export {
+  runInstall
+};

package/dist/{server-5L7BYLYR.js → server-3256GMAD.js}

@@ -1,8 +1,10 @@
 import {
-  PlaudClient,
   logger,
   registerTools
-} from "./chunk-YMQLKZLW.js";
+} from "./chunk-MPCF6HMK.js";
+import {
+  PlaudClient
+} from "./chunk-SNSGVRCU.js";
 
 // src/http/server.ts
 import express from "express";
@@ -184,7 +186,7 @@ var HTTP_PORT = Number(process.env.PLAUD_HTTP_PORT ?? 3e3);
 var HTTP_HOST = process.env.PLAUD_HTTP_HOST ?? "0.0.0.0";
 var CALLBACK_PORT = 8199;
 var CALLBACK_PATH = "/auth/callback";
-var CALLBACK_URL = process.env.PLAUD_CALLBACK_URL ?? `http://localhost:${CALLBACK_PORT}${CALLBACK_PATH}`;
+var CALLBACK_URL = `http://localhost:${CALLBACK_PORT}${CALLBACK_PATH}`;
 function startHttpServer() {
   const clientId = process.env.PLAUD_MCP_CLIENT_ID ?? process.env.PLAUD_CLIENT_ID ?? "client_9c501dad-8a0d-40b2-a7b0-d1cb8787f674";
   const clientSecret = process.env.PLAUD_CLIENT_SECRET ?? "";
@@ -203,18 +205,6 @@ function startHttpServer() {
   app.get("/health", (_req, res) => {
     res.json({ status: "ok", uptime_s: Math.floor(process.uptime()) });
   });
-  if (process.env.PLAUD_CALLBACK_URL) {
-    app.get(CALLBACK_PATH, (req, res) => {
-      const code = req.query["code"];
-      const state = req.query["state"];
-      if (!code || !state) {
-        logger.warn({ event: "oauth_callback_invalid", code: !!code, state: !!state });
-        res.status(400).send("Missing code or state");
-        return;
-      }
-      provider.handleCallback(code, state, res);
-    });
-  }
   app.use((req, res, next) => {
     const reqId = req.headers["x-request-id"] ?? randomUUID2();
     res.locals["reqId"] = reqId;

package/dist/{setup-KGUMS567.js → setup-7JTG3C2W.js}

@@ -1,58 +1,20 @@
 import {
-  SKILLS_COMBINED
-} from "./chunk-7PYQFJJW.js";
+  copyToClipboard,
+  getMcpEntry,
+  removeSkillsFromClaudeCode,
+  writeSkillsToClaudeCode
+} from "./chunk-UPEENHCG.js";
+import {
+  skillsCombined
+} from "./chunk-4QBEOJPX.js";
 
 // src/setup.ts
 import { readFile, writeFile, mkdir, rm } from "fs/promises";
 import { join, dirname } from "path";
-import { homedir, platform } from "os";
-import { fileURLToPath } from "url";
-import { spawnSync } from "child_process";
-var SKILLS_MARKER_START = "<!-- plaud-skills:start -->";
-var SKILLS_MARKER_END = "<!-- plaud-skills:end -->";
-var SKILLS_BLOCK = `${SKILLS_MARKER_START}
-${SKILLS_COMBINED}
-${SKILLS_MARKER_END}`;
-async function removeSkillsFromClaudeCode() {
-  const claudeMdPath = join(homedir(), ".claude", "CLAUDE.md");
-  let existing = "";
-  try {
-    existing = await readFile(claudeMdPath, "utf-8");
-  } catch {
-    return;
-  }
-  if (!existing.includes(SKILLS_MARKER_START)) {
-    return;
-  }
-  const updated = existing.replace(new RegExp(`\\n?${SKILLS_MARKER_START}[\\s\\S]*?${SKILLS_MARKER_END}\\n?`), "").trimEnd();
-  await writeFile(claudeMdPath, updated ? updated + "\n" : "", "utf-8");
-}
-async function writeSkillsToClaudeCode() {
-  const claudeMdPath = join(homedir(), ".claude", "CLAUDE.md");
-  let existing = "";
-  try {
-    existing = await readFile(claudeMdPath, "utf-8");
-  } catch {
-  }
-  if (existing.includes(SKILLS_MARKER_START)) {
-    const updated = existing.replace(
-      new RegExp(`${SKILLS_MARKER_START}[\\s\\S]*?${SKILLS_MARKER_END}`),
-      SKILLS_BLOCK
-    );
-    await mkdir(dirname(claudeMdPath), { recursive: true });
-    await writeFile(claudeMdPath, updated, "utf-8");
-  } else {
-    await mkdir(dirname(claudeMdPath), { recursive: true });
-    await writeFile(claudeMdPath, existing + (existing.endsWith("\n") ? "" : "\n") + SKILLS_BLOCK + "\n", "utf-8");
-  }
-}
-function copyToClipboard(content) {
-  const cmd = platform() === "win32" ? "clip" : "pbcopy";
-  const result = spawnSync(cmd, [], { input: content });
-  return result.status === 0;
-}
-function printSkillsPasteGuide() {
-  const copied = copyToClipboard(SKILLS_COMBINED);
+import { homedir } from "os";
+async function printSkillsPasteGuide() {
+  const combined = await skillsCombined();
+  const copied = copyToClipboard(combined);
   console.log("");
   if (copied) {
     console.log("Plaud Skills copied to clipboard.");
@@ -63,13 +25,6 @@ function printSkillsPasteGuide() {
   console.log("  Claude Desktop: Settings \u2192 Profile \u2192 Custom Instructions");
   console.log("  Codex Desktop:  refer to client documentation");
 }
-function getMcpEntry() {
-  const __dirname = dirname(fileURLToPath(import.meta.url));
-  return {
-    command: process.execPath,
-    args: [join(__dirname, "index.js")]
-  };
-}
 function getConfigPath() {
   if (process.platform === "darwin") {
     return join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
@@ -105,10 +60,11 @@ async function runCleanPlugin() {
 async function runSetupCodex() {
   const configPath = join(homedir(), ".codex", "config.toml");
   const { command, args } = getMcpEntry();
+  const argsStr = args.map((a) => `"${a}"`).join(", ");
   const entry = `
 [mcp_servers.plaud]
 command = "${command}"
-args = ["${args[0]}"]
+args = [${argsStr}]
 `;
   let content = "";
   try {
@@ -126,7 +82,7 @@ args = ["${args[0]}"]
   console.log("Please restart Codex Desktop to complete the setup.");
   await writeSkillsToClaudeCode();
   console.log("Plaud Skills have been added to ~/.claude/CLAUDE.md for Claude Code.");
-  printSkillsPasteGuide();
+  await printSkillsPasteGuide();
   process.exit(0);
 }
 async function runUnsetupCodex() {
@@ -142,7 +98,7 @@ async function runUnsetupCodex() {
     console.log("Plaud is not configured in Codex Desktop. Nothing to remove.");
     return;
   }
-  const cleaned = content.replace(/\n*\[mcp_servers\.plaud\]\n(?:(?!\[)[^\n]*\n)*/g, "");
+  const cleaned = content.replace(/\[mcp_servers\.plaud\]\n(?:(?!\[)[^\n]*\n)*/g, "").replace(/\n{3,}/g, "\n\n");
   await writeFile(configPath, cleaned, "utf-8");
   await removeSkillsFromClaudeCode();
   console.log("Plaud has been removed from Codex Desktop.");
@@ -201,7 +157,7 @@ async function runSetup() {
   console.log("Please restart Claude Desktop to complete the setup.");
   await writeSkillsToClaudeCode();
   console.log("Plaud Skills have been added to ~/.claude/CLAUDE.md for Claude Code.");
-  printSkillsPasteGuide();
+  await printSkillsPasteGuide();
   process.exit(0);
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plaud-ai/mcp",
-  "version": "0.1.58",
+  "version": "0.2.0",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -12,12 +12,9 @@
     ".mcp.json",
     "skills"
   ],
-  "scripts": {
-    "version:show": "node -p \"require('./package.json').version\"",
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "node -e \"const fs=require('fs'),v=require('./package.json').version,p=JSON.parse(fs.readFileSync('./plugin.json','utf8'));p.version=v;fs.writeFileSync('./plugin.json',JSON.stringify(p,null,2)+'\\n');\""
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
@@ -27,9 +24,16 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@plaud-ai/shared": "workspace:*",
     "@types/express": "^5.0.6",
     "@types/node": "^25.5.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "@plaud-ai/shared": "0.1.0"
+  },
+  "scripts": {
+    "version:show": "node -p \"require('./package.json').version\"",
+    "prebuild": "node ../../scripts/sync-skills.mjs",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist skills"
   }
-}
+}

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "plaud",
-  "version": "0.1.58",
+  "version": "0.2.0",
   "description": "Access your Plaud recordings in Claude",
   "author": {
     "name": "Plaud AI"

package/skills/plaud-browse/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: plaud-browse
+version: 1.0.0
+description: "Browse, list, or paginate through Plaud recordings. Use when the user says 'what recordings do I have', 'show my recent recordings', 'list my recordings', or asks to see the most recent uploads."
+metadata:
+  requires:
+    bins: []
+---
+
+# plaud-browse
+
+**Read [`plaud-shared`](../plaud-shared/SKILL.md) first** for auth and output conventions.
+
+## When to use
+
+- User wants to see what is in their library without a specific target in mind.
+- User explicitly asks for a page, or says "next page", "more results".
+- User asks "what's the most recent recording" — fetch page 1 and return the top item.
+
+## Steps
+
+1. Call `list_files` with `page=1` and `page_size=20` (default). No `query` / `date_from` / `date_to` unless the user said something that matches `plaud-find`.
+2. Present results in a compact table: **ID**, **NAME**, **DATE** (`YYYY-MM-DD`), **DURATION** (`5m23s` style).
+3. If the page looks like the whole library (fewer than `page_size` returned), tell the user there is no next page.
+4. If the user asks for more, increment `page` by 1 and call again.
+
+## Anti-patterns
+
+- Do **not** fetch every page eagerly; pagination is lazy.
+- Do **not** call `get_note` or `get_transcript` during a browse — that belongs to `plaud-read` and burns tokens.
+- Do **not** expose raw timestamps or durations in milliseconds.
+
+## Example
+
+User: "show me my recordings"
+
+Agent:
+- `list_files(page=1, page_size=20)`
+- Render table, mention "page 1, say 'next page' for more"

package/skills/plaud-digest/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: plaud-digest
+version: 1.0.0
+description: "Summarize multiple Plaud recordings into a digest. Use when the user says 'weekly report', 'digest of this month', 'what meetings did I have this week', 'recap of last quarter', or asks to roll up multiple recordings into one overview."
+metadata:
+  requires:
+    bins: []
+---
+
+# plaud-digest
+
+**Read [`plaud-shared`](../plaud-shared/SKILL.md) first.**
+
+## When to use
+
+- User asks for a roll-up across multiple recordings.
+- Time window is explicit ("this week") or implicit ("recap of recent meetings").
+- Scope is "what happened", not "find one specific meeting" (that's `plaud-find`).
+
+## Steps
+
+1. **Resolve the window.** Use the date interpretation table in `plaud-find` for relative phrases.
+2. **List the corpus.** `list_files` with `date_from` / `date_to`. Cap at 50 recordings — if the window returns more, ask the user to narrow it.
+3. **Fetch notes in batch.** For each recording, call `get_note`. Do **not** call `get_transcript` unless a specific recording merits a deeper pull.
+4. **Synthesize.** Produce a structured digest:
+   - **Headline** — one-line theme of the window.
+   - **By recording** — one bullet per recording: `• name (date, duration) — one-sentence takeaway`.
+   - **Recurring themes** — topics that appeared in ≥ 2 recordings.
+   - **Open action items** — aggregated across recordings, deduplicated.
+5. **Cite sources.** Every non-trivial claim must reference the recording it came from, using the file name (not the raw ID unless the user asked).
+
+## Budget
+
+- Hard cap: 50 `get_note` calls per digest. If the window has more recordings, compress or ask user to narrow.
+- Skip recordings where `note_list` is empty — mention them at the end under "unsummarized".
+
+## Anti-patterns
+
+- Do not load transcripts just to pad the digest.
+- Do not synthesize across windows the user didn't ask for ("while we're at it, here's last month too").
+- Do not invent action items that aren't in the notes — only aggregate what's there.