pnote 0.1.1 → 0.2.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command6 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/lib/errors.ts
 import pc from "picocolors";
@@ -105,12 +105,12 @@ function loadCredentials() {
       created_at: (/* @__PURE__ */ new Date()).toISOString()
     };
   }
-  const path = getCredentialsPath();
-  if (!existsSync(path)) {
+  const path3 = getCredentialsPath();
+  if (!existsSync(path3)) {
     return null;
   }
   try {
-    const content = readFileSync(path, "utf-8");
+    const content = readFileSync(path3, "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -118,14 +118,14 @@ function loadCredentials() {
 }
 function saveCredentials(credentials) {
   const dir = ensureConfigDir();
-  const path = join(dir, CREDENTIALS_FILE);
-  writeFileSync(path, JSON.stringify(credentials, null, 2), "utf-8");
-  chmodSync(path, 384);
+  const path3 = join(dir, CREDENTIALS_FILE);
+  writeFileSync(path3, JSON.stringify(credentials, null, 2), "utf-8");
+  chmodSync(path3, 384);
 }
 function deleteCredentials() {
-  const path = getCredentialsPath();
-  if (existsSync(path)) {
-    unlinkSync(path);
+  const path3 = getCredentialsPath();
+  if (existsSync(path3)) {
+    unlinkSync(path3);
     return true;
   }
   return false;
@@ -142,12 +142,12 @@ function validateTokenFormat(token) {
 }
 var CONFIG_FILE = "config.json";
 function loadConfig() {
-  const path = join(getConfigDir(), CONFIG_FILE);
-  if (!existsSync(path)) {
+  const path3 = join(getConfigDir(), CONFIG_FILE);
+  if (!existsSync(path3)) {
     return {};
   }
   try {
-    const content = readFileSync(path, "utf-8");
+    const content = readFileSync(path3, "utf-8");
     return JSON.parse(content);
   } catch {
     return {};
@@ -178,7 +178,7 @@ async function loginAction() {
   console.log("  3. Generate a new token");
   console.log("  4. Run: " + pc2.cyan("pnote auth token <your-token>"));
   console.log("");
-  console.log(pc2.dim("Or set the PROMTIE_TOKEN environment variable."));
+  console.log(pc2.dim("Or set the PNOTE_TOKEN environment variable."));
 }
 
 // src/commands/auth/token.ts
@@ -189,7 +189,7 @@ function getRestApiBase() {
   const mcpEndpoint = getApiEndpoint();
   return mcpEndpoint.replace(/\/mcp$/, "/v1");
 }
-async function callRestApi(method, path, body, options = {}) {
+async function callRestApi(method, path3, body, options = {}) {
   const token = getToken();
   if (!token) {
     throw new AuthError(
@@ -198,7 +198,7 @@ async function callRestApi(method, path, body, options = {}) {
     );
   }
   const baseUrl = getRestApiBase();
-  const url = `${baseUrl}${path}`;
+  const url = `${baseUrl}${path3}`;
   const headers = {
     "Content-Type": "application/json",
     Authorization: `Bearer ${token}`
@@ -256,6 +256,7 @@ async function listNotes(params = {}, options = {}) {
   if (params.pinned !== void 0) query.set("pinned", String(params.pinned));
   if (params.deleted !== void 0) query.set("deleted", String(params.deleted));
   if (params.protected !== void 0) query.set("protected", String(params.protected));
+  if (params.note_type) query.set("note_type", params.note_type);
   if (params.search) query.set("search", params.search);
   if (params.limit) query.set("limit", String(params.limit));
   if (params.offset) query.set("offset", String(params.offset));
@@ -284,6 +285,9 @@ async function listSnippets(params, options = {}) {
 async function createSnippet(data, options = {}) {
   return callRestApi("POST", "/snippets", data, options);
 }
+async function updateSnippet(id, data, options = {}) {
+  return callRestApi("PATCH", `/snippets/${id}`, data, options);
+}
 async function toggleFavorite(id, options = {}) {
   return callRestApi("POST", `/snippets/${id}/favorite`, {}, options);
 }
@@ -307,93 +311,20 @@ async function search(params, options = {}) {
   if (params.limit) query.set("limit", String(params.limit));
   return callRestApi("GET", `/search?${query.toString()}`, void 0, options);
 }
-var requestId = 0;
-function getNextId() {
-  return ++requestId;
+async function listSharedTags(options = {}) {
+  return callRestApi("GET", "/share/tags", void 0, options);
 }
-async function callMCP(toolName, args = {}) {
-  const token = getToken();
-  if (!token) {
-    throw new AuthError(
-      "Not logged in",
-      "Run 'pnote auth login' or 'pnote auth token <token>' to authenticate"
-    );
-  }
-  const endpoint = getApiEndpoint();
-  const request = {
-    jsonrpc: "2.0",
-    id: getNextId(),
-    method: "tools/call",
-    params: {
-      name: toolName,
-      arguments: args
-    }
-  };
-  let response;
-  try {
-    response = await fetch(endpoint, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `Bearer ${token}`
-      },
-      body: JSON.stringify(request),
-      signal: AbortSignal.timeout(3e4)
-    });
-  } catch (error) {
-    if (error instanceof Error) {
-      if (error.name === "TimeoutError" || error.name === "AbortError") {
-        throw new NetworkError("Request timed out. Please try again.");
-      }
-      if (error.message.includes("fetch")) {
-        throw new NetworkError("Unable to connect to PromptNote API. Check your internet connection.");
-      }
-    }
-    throw new NetworkError();
-  }
-  if (!response.ok) {
-    const body = await response.text();
-    if (response.status === 401) {
-      throw new AuthError(
-        "Invalid or expired token",
-        "Run 'pnote auth login' to re-authenticate"
-      );
-    }
-    if (response.status === 403) {
-      throw new CLIError("Permission denied", ExitCode.AUTH_ERROR);
-    }
-    throw new CLIError(`API error (${response.status}): ${body}`);
-  }
-  const mcpResponse = await response.json();
-  if (mcpResponse.error) {
-    throw new CLIError(`MCP error: ${mcpResponse.error.message}`);
-  }
-  if (!mcpResponse.result) {
-    throw new CLIError("Invalid response from API");
-  }
-  const content = mcpResponse.result.content;
-  if (!content || content.length === 0) {
-    throw new CLIError("Empty response from API");
-  }
-  if (mcpResponse.result.isError) {
-    const errorText = content[0]?.text || "Unknown error";
-    if (errorText.includes("not found") || errorText.includes("PGRST116")) {
-      throw new CLIError("Resource not found", ExitCode.NOT_FOUND);
-    }
-    if (errorText.includes("Unauthorized")) {
-      throw new AuthError(errorText);
-    }
-    throw new CLIError(errorText);
-  }
-  const textContent = content[0]?.text;
-  if (!textContent) {
-    throw new CLIError("No content in response");
-  }
-  try {
-    return JSON.parse(textContent);
-  } catch {
-    return textContent;
-  }
+async function getSharedTagNotes(id, params = {}, options = {}) {
+  const query = new URLSearchParams();
+  if (params.limit) query.set("limit", String(params.limit));
+  const queryString = query.toString();
+  return callRestApi("GET", `/share/tags/${id}/notes${queryString ? `?${queryString}` : ""}`, void 0, options);
+}
+async function listSharedNotes(params = {}, options = {}) {
+  const query = new URLSearchParams();
+  if (params.include_revoked !== void 0) query.set("include_revoked", String(params.include_revoked));
+  const queryString = query.toString();
+  return callRestApi("GET", `/share/notes${queryString ? `?${queryString}` : ""}`, void 0, options);
 }
 async function verifyToken(token) {
   const baseUrl = getApiEndpoint().replace(/\/mcp$/, "/v1");
@@ -464,12 +395,12 @@ async function logoutAction() {
   } else {
     console.log(pc4.dim("No credentials to remove."));
   }
-  if (process.env.PROMTIE_TOKEN) {
+  if (process.env.PNOTE_TOKEN) {
     console.log("");
     console.log(
-      pc4.yellow("Note:") + " PROMTIE_TOKEN environment variable is still set."
+      pc4.yellow("Note:") + " PNOTE_TOKEN environment variable is still set."
     );
-    console.log(pc4.dim("Unset it with: unset PROMTIE_TOKEN"));
+    console.log(pc4.dim("Unset it with: unset PNOTE_TOKEN"));
   }
 }
 
@@ -487,9 +418,7 @@ async function whoamiAction() {
     throw new AuthError("No credentials found");
   }
   try {
-    const result = await callMCP("promptnote_list_notes", {
-      limit: 1
-    });
+    const result = await listNotes({ limit: 1 });
     console.log(pc5.green("\u2713") + " Authenticated");
     console.log("");
     if (creds.email) {
@@ -497,8 +426,8 @@ async function whoamiAction() {
     }
     console.log(pc5.dim("Token: ") + creds.token.slice(0, 7) + "..." + creds.token.slice(-4));
     console.log(pc5.dim("Stored: ") + getCredentialsPath());
-    if (process.env.PROMTIE_TOKEN) {
-      console.log(pc5.dim("Source: ") + "PROMTIE_TOKEN environment variable");
+    if (process.env.PNOTE_TOKEN) {
+      console.log(pc5.dim("Source: ") + "PNOTE_TOKEN environment variable");
     } else {
       console.log(pc5.dim("Source: ") + "credentials file");
     }
@@ -779,6 +708,103 @@ function outputSearchResults(query, notes, snippets, ctx) {
     }
   }
 }
+function outputSharedTags(data, ctx) {
+  if (ctx.json) {
+    outputJson(data);
+    return;
+  }
+  const c = getColors(ctx);
+  const totalCount = data.owned.count + data.shared_with_me.count;
+  if (totalCount === 0) {
+    console.log(c.dim("No shared tags."));
+    return;
+  }
+  if (isHumanOutput(ctx)) {
+    if (data.owned.count > 0) {
+      console.log(c.bold(`Owned (${data.owned.count})`));
+      console.log("");
+      for (const tag of data.owned.tags) {
+        console.log(
+          "  " + c.cyan(tag.id.slice(0, 8)) + "  " + pad(tag.tag_path, 24) + "  " + c.dim(formatRelativeTime(tag.created_at))
+        );
+      }
+      console.log("");
+    }
+    if (data.shared_with_me.count > 0) {
+      console.log(c.bold(`Shared with me (${data.shared_with_me.count})`));
+      console.log("");
+      for (const tag of data.shared_with_me.tags) {
+        console.log(
+          "  " + c.cyan(tag.id.slice(0, 8)) + "  " + pad(tag.tag_path, 24) + "  " + c.dim("joined " + formatRelativeTime(tag.joined_at))
+        );
+      }
+    }
+  } else {
+    for (const tag of data.owned.tags) {
+      console.log(["owned", tag.id, tag.tag_path, tag.created_at].join("	"));
+    }
+    for (const tag of data.shared_with_me.tags) {
+      console.log(["shared", tag.id, tag.tag_path, tag.joined_at].join("	"));
+    }
+  }
+}
+function outputSharedTagNotes(data, ctx) {
+  if (ctx.json) {
+    outputJson(data);
+    return;
+  }
+  const c = getColors(ctx);
+  if (isHumanOutput(ctx)) {
+    const role = data.shared_tag.is_owner ? "owner" : "member";
+    console.log(c.bold(data.shared_tag.tag_path) + c.dim(` (${role}, ${data.members_count} members)`));
+    console.log("");
+    if (data.notes.length === 0) {
+      console.log(c.dim("  No notes in this shared tag."));
+      return;
+    }
+    console.log(
+      "  " + c.dim(pad("ID", 10)) + "  " + c.dim(pad("TITLE", 24)) + "  " + c.dim(pad("AUTHOR", 20)) + "  " + c.dim("UPDATED")
+    );
+    for (const note of data.notes) {
+      const author = note.is_own ? "you" : note.author.email || "unknown";
+      console.log(
+        "  " + pad(note.id.slice(0, 8), 10) + "  " + pad(truncate(note.title, 24), 24) + "  " + pad(truncate(author, 20), 20) + "  " + formatRelativeTime(note.updated_at)
+      );
+    }
+  } else {
+    for (const note of data.notes) {
+      const author = note.is_own ? "you" : note.author.email || "unknown";
+      console.log([note.id, note.title, author, note.updated_at].join("	"));
+    }
+  }
+}
+function outputSharedNotes(data, ctx) {
+  if (ctx.json) {
+    outputJson(data);
+    return;
+  }
+  const c = getColors(ctx);
+  if (data.count === 0) {
+    console.log(c.dim("No shared notes."));
+    return;
+  }
+  if (isHumanOutput(ctx)) {
+    console.log(c.bold(`Shared Notes (${data.count})`));
+    console.log("");
+    for (const share of data.shares) {
+      const revoked = share.is_revoked ? c.red(" [R]") : "";
+      console.log(
+        "  " + truncate(share.note_title, 20) + "  " + c.cyan(share.share_url) + "  " + c.dim(`${share.view_count} views`) + "  " + c.dim(formatRelativeTime(share.created_at)) + revoked
+      );
+    }
+  } else {
+    for (const share of data.shares) {
+      console.log(
+        [share.note_title, share.share_url, share.view_count, share.is_revoked, share.created_at].join("	")
+      );
+    }
+  }
+}
 function outputMessage(message, ctx) {
   if (ctx.json) {
     outputJson({ message });
@@ -851,7 +877,7 @@ async function createNoteAction(title, options, ctx) {
     const result = await createNote(
       {
         title,
-        tags: options.tag && options.tag.length > 0 ? options.tag : void 0,
+        tags: options.tags && options.tags.length > 0 ? options.tags : void 0,
         content
       },
       { pin: ctx.pin }
@@ -911,17 +937,14 @@ async function pinNoteAction(id, ctx) {
 import pc7 from "picocolors";
 import { createInterface } from "readline";
 async function confirm(message) {
-  if (!process.stdin.isTTY) {
-    return false;
-  }
   const rl = createInterface({
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     rl.question(message + " [y/N] ", (answer) => {
       rl.close();
-      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve2(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
@@ -929,6 +952,13 @@ async function deleteNoteAction(id, options, ctx) {
   try {
     const note = await getNote(id, { pin: ctx.pin });
     if (!options.force && !ctx.json) {
+      if (!process.stdin.isTTY) {
+        throw new CLIError(
+          "Cannot confirm deletion in non-interactive mode",
+          ExitCode.GENERAL_ERROR,
+          "Use --force for non-interactive deletion"
+        );
+      }
       console.log(`About to delete: ${pc7.bold(note.title)}`);
       const confirmed = await confirm("Are you sure?");
       if (!confirmed) {
@@ -947,6 +977,30 @@ async function deleteNoteAction(id, options, ctx) {
   }
 }
 
+// src/commands/notes/update.ts
+async function updateNoteAction(id, options, ctx) {
+  try {
+    if (!options.title && !options.tags) {
+      throw new CLIError(
+        "No changes provided",
+        1,
+        "Use --title or --tags to specify what to update"
+      );
+    }
+    const data = {};
+    if (options.title) data.title = options.title;
+    if (options.tags) data.tags = options.tags;
+    const result = await updateNote(id, data, { pin: ctx.pin });
+    if (ctx.json) {
+      outputJson(result);
+    } else {
+      outputMessage(`Updated note: ${result.note.title}`, ctx);
+    }
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
 // src/lib/pin.ts
 import { createInterface as createInterface2 } from "readline";
 import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync as unlinkSync2, statSync } from "fs";
@@ -1027,7 +1081,7 @@ async function promptForPin(noteTitle, hint, maxAttempts = PIN_MAX_ATTEMPTS) {
   return null;
 }
 async function readPinHidden(prompt) {
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const rl = createInterface2({
       input: process.stdin,
       output: process.stderr,
@@ -1043,7 +1097,7 @@ async function readPinHidden(prompt) {
       if (char === "\r" || char === "\n") {
         process.stderr.write("\n");
         cleanup();
-        resolve(pin);
+        resolve2(pin);
       } else if (char === "") {
         process.stderr.write("\n");
         cleanup();
@@ -1129,6 +1183,7 @@ Examples:
   $ pnote notes --pinned           Show only pinned notes
   $ pnote notes get abc123         Get note details
   $ pnote notes create "My Note"   Create a new note
+  $ pnote notes update abc123 --title "New Title"
 `
 );
 notesCommand.command("get").description("Get a note with its latest snippet").argument("<id>", "Note ID").action(async (id, _options, cmd) => {
@@ -1136,7 +1191,7 @@ notesCommand.command("get").description("Get a note with its latest snippet").ar
   const ctx = await buildContext(globalOpts);
   await getNoteAction(id, ctx);
 });
-notesCommand.command("create").description("Create a new note").argument("<title>", "Note title").option("--tag <tags...>", "Tags for the note").option("--content <content>", "Initial snippet content").action(async (title, options, cmd) => {
+notesCommand.command("create").description("Create a new note").argument("<title>", "Note title").option("--tags <tags...>", "Tags for the note").option("--content <content>", "Initial snippet content").action(async (title, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
   const ctx = await buildContext(globalOpts);
   await createNoteAction(title, options, ctx);
@@ -1151,6 +1206,11 @@ notesCommand.command("pin").description("Pin or unpin a note").argument("<id>",
   const ctx = await buildContext(globalOpts);
   await pinNoteAction(id, ctx);
 });
+notesCommand.command("update").description("Update a note title or tags").argument("<id>", "Note ID").option("--title <title>", "New title").option("--tags <tags...>", "New tags (replaces existing)").action(async (id, options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.opts() || {};
+  const ctx = await buildContext(globalOpts);
+  await updateNoteAction(id, options, ctx);
+});
 notesCommand.command("delete").description("Delete a note (soft delete)").argument("<id>", "Note ID").option("--force", "Skip confirmation").action(async (id, options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
   const ctx = await buildContext(globalOpts);
@@ -1287,6 +1347,48 @@ async function addSnippetAction(noteId, options, ctx) {
   }
 }
 
+// src/commands/snippet/update.ts
+async function updateSnippetAction(snippetId, options, ctx) {
+  try {
+    let content;
+    if (!process.stdin.isTTY) {
+      const chunks = [];
+      for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+      }
+      content = Buffer.concat(chunks).toString("utf-8");
+      if (content.endsWith("\n")) {
+        content = content.slice(0, -1);
+      }
+      if (!content) {
+        content = void 0;
+      }
+    }
+    if (!content && !options.title) {
+      throw new CLIError(
+        "No content or title provided",
+        1,
+        "Pipe content to this command: echo 'content' | pnote snippet update <snippet-id>"
+      );
+    }
+    const data = {};
+    if (content) data.content = content;
+    if (options.title) data.title = options.title;
+    const result = await updateSnippet(
+      snippetId,
+      data,
+      { pin: ctx.pin }
+    );
+    if (ctx.json) {
+      outputJson(result);
+    } else {
+      outputMessage("Updated snippet", ctx);
+    }
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
 // src/commands/snippet/favorite.ts
 async function favoriteSnippetAction(snippetId, ctx) {
   try {
@@ -1344,6 +1446,11 @@ snippetCommand.command("add").description("Add a new snippet version (from stdin
   const ctx = await buildContext2(globalOpts);
   await addSnippetAction(noteId, options, ctx);
 });
+snippetCommand.command("update").description("Update an existing snippet (from stdin)").argument("<snippet-id>", "Snippet ID").option("--title <title>", "New snippet title").action(async (snippetId, options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.opts() || {};
+  const ctx = await buildContext2(globalOpts);
+  await updateSnippetAction(snippetId, options, ctx);
+});
 snippetCommand.command("favorite").description("Toggle favorite status on a snippet").argument("<snippet-id>", "Snippet ID").action(async (snippetId, _options, cmd) => {
   const globalOpts = cmd.parent?.parent?.opts() || {};
   const ctx = await buildContext2(globalOpts);
@@ -1480,11 +1587,16 @@ async function searchAction(query, options, ctx) {
 }
 var searchCommand = new Command5("search").description("Search notes and snippets").argument("<query>", "Search query").option("--notes-only", "Only search note titles and tags").option("--snippets-only", "Only search snippet content").option("--limit <n>", "Limit results", "20").action(async (query, options, cmd) => {
   const globalOpts = cmd.parent?.opts() || {};
+  const pin = await resolvePin({
+    pinArg: globalOpts.pin,
+    pinFromStdin: globalOpts.pinStdin,
+    skipPrompt: true
+  });
   const ctx = {
     json: globalOpts.json ?? false,
     noColor: globalOpts.noColor ?? false,
     plain: globalOpts.plain ?? false,
-    pin: globalOpts.pin
+    pin: pin ?? void 0
   };
   await searchAction(query, options, ctx);
 }).addHelpText(
@@ -1497,8 +1609,326 @@ Examples:
 `
 );
 
+// src/commands/share/index.ts
+import { Command as Command6 } from "commander";
+
+// src/commands/share/tags.ts
+async function listSharedTagsAction(ctx) {
+  try {
+    const result = await listSharedTags({ pin: ctx.pin });
+    outputSharedTags(result, ctx);
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+async function getSharedTagNotesAction(id, options, ctx) {
+  try {
+    const result = await getSharedTagNotes(
+      id,
+      { limit: options.limit ? parseInt(options.limit, 10) : void 0 },
+      { pin: ctx.pin }
+    );
+    outputSharedTagNotes(result, ctx);
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
+// src/commands/share/notes.ts
+async function listSharedNotesAction(options, ctx) {
+  try {
+    const result = await listSharedNotes(
+      { include_revoked: options.includeRevoked },
+      { pin: ctx.pin }
+    );
+    outputSharedNotes(result, ctx);
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
+// src/commands/share/index.ts
+async function buildContext4(globalOpts) {
+  const pin = await resolvePin({
+    pinArg: globalOpts.pin,
+    pinFromStdin: globalOpts.pinStdin,
+    skipPrompt: true
+  });
+  return {
+    json: globalOpts.json ?? false,
+    noColor: globalOpts.noColor ?? false,
+    plain: globalOpts.plain ?? false,
+    pin: pin ?? void 0
+  };
+}
+var shareCommand = new Command6("share").description("View shared tags and shared note links").addHelpText(
+  "after",
+  `
+Examples:
+  $ pnote share tags                List shared tags
+  $ pnote share tags abc123         View notes in shared tag
+  $ pnote share notes               List public share links
+  $ pnote share notes --include-revoked
+`
+);
+shareCommand.command("tags").description("List shared tags or view notes in a shared tag").argument("[id]", "Shared tag ID to view notes").option("--limit <n>", "Limit notes returned").action(async (id, options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.opts() || {};
+  const ctx = await buildContext4(globalOpts);
+  if (id) {
+    await getSharedTagNotesAction(id, options, ctx);
+  } else {
+    await listSharedTagsAction(ctx);
+  }
+});
+shareCommand.command("notes").description("List public share links for your notes").option("--include-revoked", "Include revoked share links").action(async (options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.opts() || {};
+  const ctx = await buildContext4(globalOpts);
+  await listSharedNotesAction(options, ctx);
+});
+
+// src/commands/skills/index.ts
+import { Command as Command7 } from "commander";
+
+// src/commands/skills/list.ts
+import pc10 from "picocolors";
+async function listSkillsAction(ctx) {
+  try {
+    const result = await listNotes(
+      { note_type: "skill", limit: 200 },
+      { pin: ctx.pin }
+    );
+    const skills = result.notes;
+    if (ctx.json) {
+      const grouped2 = {};
+      for (const note of skills) {
+        const slashIdx = note.title.indexOf("/");
+        const skillName = slashIdx > 0 ? note.title.slice(0, slashIdx) : note.title;
+        if (!grouped2[skillName]) grouped2[skillName] = [];
+        grouped2[skillName].push(note);
+      }
+      outputJson(grouped2);
+      return;
+    }
+    if (skills.length === 0) {
+      console.log(pc10.dim("No skills found. Create one with:"));
+      console.log(pc10.dim("  pnote skills push ./my-skill"));
+      return;
+    }
+    const grouped = /* @__PURE__ */ new Map();
+    for (const note of skills) {
+      const slashIdx = note.title.indexOf("/");
+      const skillName = slashIdx > 0 ? note.title.slice(0, slashIdx) : note.title;
+      if (!grouped.has(skillName)) grouped.set(skillName, []);
+      grouped.get(skillName).push(note);
+    }
+    console.log(pc10.bold(`Skills (${grouped.size})`));
+    console.log("");
+    for (const [name, files] of grouped) {
+      const fileNames = files.map((f) => {
+        const slashIdx = f.title.indexOf("/");
+        return slashIdx > 0 ? f.title.slice(slashIdx + 1) : f.title;
+      });
+      console.log(
+        "  " + pc10.cyan(name) + pc10.dim(` (${files.length} file${files.length !== 1 ? "s" : ""})`) + "  " + pc10.dim(fileNames.join(", "))
+      );
+    }
+    console.log("");
+    console.log(pc10.dim("Pull to local: pnote skills pull"));
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
+// src/commands/skills/pull.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import pc11 from "picocolors";
+async function pullSkillsAction(skillName, options, ctx) {
+  try {
+    const baseDir = options.dir || path.join(os.homedir(), ".claude", "skills");
+    const result = await listNotes(
+      { note_type: "skill", limit: 200 },
+      { pin: ctx.pin }
+    );
+    let skills = result.notes;
+    if (skillName) {
+      skills = skills.filter((n) => {
+        const prefix = n.title.split("/")[0];
+        return prefix === skillName;
+      });
+      if (skills.length === 0) {
+        console.error(pc11.red(`No skill found with name "${skillName}"`));
+        process.exit(1);
+      }
+    }
+    if (skills.length === 0) {
+      console.log(pc11.dim("No skills to pull."));
+      return;
+    }
+    let pulled = 0;
+    let skipped = 0;
+    for (const note of skills) {
+      const slashIdx = note.title.indexOf("/");
+      if (slashIdx <= 0) {
+        logStatus(`Skipping "${note.title}" (invalid title format, expected "name/file")`);
+        skipped++;
+        continue;
+      }
+      const skillDir = note.title.slice(0, slashIdx);
+      const fileName = note.title.slice(slashIdx + 1);
+      const filePath = path.join(baseDir, skillDir, fileName);
+      const noteData = await getNote(note.id, { pin: ctx.pin });
+      const content = noteData.latest_snippet?.content;
+      if (!content) {
+        logStatus(`Skipping "${note.title}" (no snippet content)`);
+        skipped++;
+        continue;
+      }
+      if (options.dryRun) {
+        console.log(`${pc11.dim("would write")} ${filePath} ${pc11.dim(`(${content.length} chars)`)}`);
+        pulled++;
+        continue;
+      }
+      const dir = path.dirname(filePath);
+      fs.mkdirSync(dir, { recursive: true });
+      fs.writeFileSync(filePath, content, "utf-8");
+      console.log(`${pc11.green("\u2713")} ${filePath}`);
+      pulled++;
+    }
+    console.log("");
+    if (options.dryRun) {
+      console.log(pc11.dim(`Dry run: ${pulled} file(s) would be written, ${skipped} skipped`));
+    } else {
+      console.log(`Pulled ${pulled} file(s) to ${baseDir}` + (skipped > 0 ? `, ${skipped} skipped` : ""));
+    }
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+
+// src/commands/skills/push.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import pc12 from "picocolors";
+async function pushSkillsAction(dir, options, ctx) {
+  try {
+    const resolvedDir = path2.resolve(dir);
+    if (!fs2.existsSync(resolvedDir) || !fs2.statSync(resolvedDir).isDirectory()) {
+      console.error(pc12.red(`Not a directory: ${resolvedDir}`));
+      process.exit(1);
+    }
+    const skillMdPath = path2.join(resolvedDir, "SKILL.md");
+    if (!fs2.existsSync(skillMdPath)) {
+      console.error(pc12.red(`No SKILL.md found in ${resolvedDir}`));
+      console.error(pc12.dim("A valid skill directory must contain a SKILL.md file."));
+      process.exit(1);
+    }
+    const skillName = options.name || path2.basename(resolvedDir);
+    const files = collectFiles(resolvedDir, resolvedDir);
+    if (files.length === 0) {
+      console.log(pc12.dim("No files to push."));
+      return;
+    }
+    const existing = await listNotes(
+      { note_type: "skill", limit: 200 },
+      { pin: ctx.pin }
+    );
+    const existingMap = /* @__PURE__ */ new Map();
+    for (const note of existing.notes) {
+      existingMap.set(note.title, note.id);
+    }
+    let created = 0;
+    let updated = 0;
+    for (const relPath of files) {
+      const noteTitle = `${skillName}/${relPath}`;
+      const filePath = path2.join(resolvedDir, relPath);
+      const content = fs2.readFileSync(filePath, "utf-8");
+      const existingId = existingMap.get(noteTitle);
+      if (existingId) {
+        await createSnippet(
+          { note_id: existingId, content },
+          { pin: ctx.pin }
+        );
+        console.log(`${pc12.yellow("\u21BB")} ${noteTitle} ${pc12.dim("(new version)")}`);
+        updated++;
+      } else {
+        await createNote(
+          { title: noteTitle, content, note_type: "skill" },
+          { pin: ctx.pin }
+        );
+        console.log(`${pc12.green("+")} ${noteTitle}`);
+        created++;
+      }
+    }
+    console.log("");
+    console.log(
+      `Pushed ${pc12.bold(skillName)}: ` + (created > 0 ? `${created} created` : "") + (created > 0 && updated > 0 ? ", " : "") + (updated > 0 ? `${updated} updated` : "")
+    );
+  } catch (error) {
+    handleError(error, ctx.noColor);
+  }
+}
+function collectFiles(baseDir, currentDir) {
+  const files = [];
+  const entries = fs2.readdirSync(currentDir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+    const fullPath = path2.join(currentDir, entry.name);
+    const relPath = path2.relative(baseDir, fullPath);
+    if (entry.isFile()) {
+      files.push(relPath);
+    } else if (entry.isDirectory()) {
+      files.push(...collectFiles(baseDir, fullPath));
+    }
+  }
+  return files;
+}
+
+// src/commands/skills/index.ts
+async function buildContext5(globalOpts) {
+  const pin = await resolvePin({
+    pinArg: globalOpts.pin,
+    pinFromStdin: globalOpts.pinStdin,
+    skipPrompt: true
+  });
+  return {
+    json: globalOpts.json ?? false,
+    noColor: globalOpts.noColor ?? false,
+    plain: globalOpts.plain ?? false,
+    pin: pin ?? void 0
+  };
+}
+var skillsCommand = new Command7("skills").description("Manage agent skills (sync between cloud and local)").action(async (_options, cmd) => {
+  const globalOpts = cmd.parent?.opts() || {};
+  const ctx = await buildContext5(globalOpts);
+  await listSkillsAction(ctx);
+}).addHelpText(
+  "after",
+  `
+Examples:
+  $ pnote skills                     List all skills in cloud
+  $ pnote skills pull                Download all skills to ~/.claude/skills/
+  $ pnote skills pull myskill        Download a specific skill
+  $ pnote skills push ./my-skill     Upload a local skill directory
+
+Skills are notes with type "skill" and title format "skill-name/filename.md".
+They sync to ~/.claude/skills/<skill-name>/<filename> for use with Claude Code.
+`
+);
+skillsCommand.command("pull").description("Download skills from cloud to local (~/.claude/skills/)").argument("[skill-name]", "Specific skill to pull (pulls all if omitted)").option("--dir <path>", "Custom output directory (default: ~/.claude/skills)").option("--dry-run", "Show what would be downloaded without writing files").action(async (skillName, options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.opts() || {};
+  const ctx = await buildContext5(globalOpts);
+  await pullSkillsAction(skillName, options, ctx);
+});
+skillsCommand.command("push").description("Upload a local skill directory to cloud").argument("<dir>", "Path to skill directory (must contain SKILL.md)").option("--name <name>", "Override skill name (default: directory name)").action(async (dir, options, cmd) => {
+  const globalOpts = cmd.parent?.parent?.opts() || {};
+  const ctx = await buildContext5(globalOpts);
+  await pushSkillsAction(dir, options, ctx);
+});
+
 // src/index.ts
-var program = new Command6();
+var program = new Command8();
 program.name("pnote").description("pnote - The PromptNote CLI").version("0.1.0", "-V, --version", "Show version number").option("--json", "Output as JSON (for scripting)").option("--no-color", "Disable colored output").option("--plain", "Force plain text output (no formatting)").option("-p, --pin <pin>", "PIN for accessing protected notes").option("--pin-stdin", "Read PIN from stdin (first line only)").configureHelp({
   sortSubcommands: true,
   sortOptions: true
@@ -1528,6 +1958,8 @@ program.addCommand(notesCommand);
 program.addCommand(snippetCommand);
 program.addCommand(tagsCommand);
 program.addCommand(searchCommand);
+program.addCommand(shareCommand);
+program.addCommand(skillsCommand);
 process.on("SIGINT", () => {
   console.error("\nInterrupted");
   process.exit(130);