innernote 0.3.3 → 0.4.0

package/README.md

@@ -90,16 +90,20 @@ from it fails the suite, so what you read here is what the binary has.
 | `capture <text>` | save an idea to your inbox |
 | `write [topic]` | draft a post in your voice |
 | `shape <shape...>` | push a post shorter, punchier, warmer |
-| `ask <anything>` | talk to the post in your own words |
+| `ask [--post <id>] <anything>` | talk to the post in your own words; with `--post`, a saved post in one command. `--passage`, `--hook`, `--ending`, `--preset` and `--shape` edit one part of it, as the editor's selection, toolbar and format picker do |
+| `edit <id>` | put new text, a title, a first comment, a series or a ready state on a saved post |
+| `attach <id> <file...>` | put an image, images, a PDF or a video on a saved post |
 | `save` | keep the draft you are holding |
-| `show` | reprint the post you are holding |
+| `show [id]` | a post with everything the app knows about it, or the one you are holding |
 | `drop` | put down whatever you are holding |
 | `open <n or id>` | pull a post out of the last list and work on it |
 | `ideas [status]` | list what you have captured |
-| `drafts [status]` | list your posts, numbered |
+| `drafts [status] [--series <name>]` | list your posts, numbered, or one series in its order |
 | `week` | what is scheduled for the next seven days |
-| `queue <post-id>` | schedule a post into your next open slot |
+| `queue <post-id> [--at <time>]` | schedule a post into your next open slot, or at a time you pick |
 | `unqueue <post-id>` | pull it back out before it goes live |
+| `delete <id>` | move a post to the trash |
+| `restore <id>` | bring it back out of the trash |
 | `skill [--install]` | print the agent skill, or register it for Claude Code |
 
 ### write

package/dist/index.js

@@ -83,6 +83,9 @@ class ApiError extends Error {
   get isRefusal() {
     return this.status === 402 || this.status === 429;
   }
+  get isNotConnected() {
+    return this.status === 401;
+  }
 }
 
 class NotLoggedIn extends Error {
@@ -497,13 +500,92 @@ function resolveRef(ref) {
   return /^[a-z0-9]{20,}$/.test(ref) ? { id: ref, title: ref } : null;
 }
 
-// src/commands/read.ts
-function parseFlags(args) {
+// src/posts.ts
+async function listPosts(status) {
+  const data = await request(`/api/posts${status ? `?status=${encodeURIComponent(status)}` : ""}`);
+  return data.posts;
+}
+async function fetchPost(id) {
+  return (await listPosts()).find((p) => p._id === id) ?? null;
+}
+async function listSeries() {
+  const data = await request("/api/campaigns");
+  return data.campaigns;
+}
+function matchSeries(all, name) {
+  const want = name.trim().toLowerCase().replace(/\s+/g, " ");
+  return all.find((s) => s.name.trim().toLowerCase().replace(/\s+/g, " ") === want) ?? null;
+}
+function linkedinUrl(post) {
+  return post.linkedinPostUrn ? `https://www.linkedin.com/feed/update/${post.linkedinPostUrn}/` : null;
+}
+function describeMedia(post) {
+  const m = post.media;
+  if (!m || m.kind === "text")
+    return null;
+  const title = typeof m.title === "string" && m.title ? `: ${m.title}` : "";
+  const assets = Array.isArray(m.assets) ? m.assets.length : 0;
+  switch (m.kind) {
+    case "image":
+      return "image";
+    case "multiImage":
+      return `${assets} images`;
+    case "video":
+      return `video${title}`;
+    case "document":
+      return `PDF${title}`;
+    case "poll":
+      return "poll";
+    case "link":
+      return "link";
+    default:
+      return m.kind;
+  }
+}
+function postForJson(post, series) {
+  const inSeries = post.campaignId ? series.find((s) => s._id === post.campaignId) : undefined;
   return {
-    json: args.includes("--json"),
-    rest: args.filter((a) => !a.startsWith("--"))
+    ...post,
+    seriesName: inSeries?.name ?? null,
+    linkedinUrl: linkedinUrl(post)
   };
 }
+
+// src/flags.ts
+function parseFlags(args, valueFlags = []) {
+  const values = new Map;
+  const present = new Set;
+  const rest = [];
+  for (let i = 0;i < args.length; i++) {
+    const arg = args[i];
+    if (!arg.startsWith("--")) {
+      rest.push(arg);
+      continue;
+    }
+    const eq = arg.indexOf("=");
+    const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);
+    present.add(name);
+    if (!valueFlags.includes(name))
+      continue;
+    if (eq !== -1) {
+      values.set(name, arg.slice(eq + 1));
+      continue;
+    }
+    const next = args[i + 1];
+    if (next !== undefined && !next.startsWith("--")) {
+      values.set(name, next);
+      i++;
+    }
+  }
+  return {
+    json: present.has("json"),
+    rest,
+    value: (name) => values.get(name),
+    has: (name) => present.has(name)
+  };
+}
+
+// src/commands/read.ts
 function powers(scopes) {
   if (!scopes || scopes.length === 0)
     return "full access";
@@ -569,29 +651,42 @@ ${data.ideas.length} ${data.ideas.length === 1 ? "idea" : "ideas"}`));
   return 0;
 }
 async function drafts(args) {
-  const { json, rest } = parseFlags(args);
+  const { json, rest, value } = parseFlags(args, ["series"]);
   const status = rest[0];
-  const data = await request(`/api/posts${status ? `?status=${encodeURIComponent(status)}` : ""}`);
+  const seriesName = value("series");
+  const [all, series] = await Promise.all([listPosts(status), listSeries()]);
+  let posts = all;
+  if (seriesName) {
+    const target = matchSeries(series, seriesName);
+    if (!target) {
+      note(`No series called "${seriesName}".`);
+      if (series.length)
+        note(dim2(`Yours: ${series.map((s) => s.name).join(", ")}`));
+      return 1;
+    }
+    posts = all.filter((p) => p.campaignId === target._id).sort((a, b) => (a.campaignOrder ?? "").localeCompare(b.campaignOrder ?? ""));
+  }
   if (json) {
-    out(JSON.stringify(data.posts, null, 2));
+    out(JSON.stringify(posts.map((p) => postForJson(p, series)), null, 2));
     return 0;
   }
-  if (data.posts.length === 0) {
-    note("No posts yet. Write one with: write");
+  if (posts.length === 0) {
+    note(seriesName ? "Nothing in that series yet." : "No posts yet. Write one with: write");
     return 0;
   }
-  const shown = data.posts.slice(0, 30);
+  const shown = posts.slice(0, 30);
   rememberList(shown.map((p) => ({ id: p._id, title: (p.title || p.content).replace(/\s+/g, " ") })));
   for (const [i, post] of shown.entries()) {
     const n = String(i + 1).padStart(2);
-    out(`${caramel(n)}  ${dim2(post.status.padEnd(9))} ${oneLine(post.title || post.content, 52)}`);
+    const likes = post.status === "published" && post.linkedinLikes !== undefined ? dim2(`  ${post.linkedinLikes} likes`) : "";
+    out(`${caramel(n)}  ${dim2(post.status.padEnd(9))} ${oneLine(post.title || post.content, 52)}${likes}`);
   }
-  if (data.posts.length > shown.length) {
+  if (posts.length > shown.length) {
     note(dim2(`
-...and ${data.posts.length - shown.length} more`));
+...and ${posts.length - shown.length} more`));
   }
   note(dim2(`
-open <number>   to work on one`));
+open <number>   to work on one   show <id>   for everything about one`));
   return 0;
 }
 async function week(args) {
@@ -619,22 +714,32 @@ async function week(args) {
 }
 async function context(args) {
   const { json } = parseFlags(args);
-  const [pillars, series] = await Promise.all([
+  const [pillars, series, notebook] = await Promise.all([
     request("/api/pillars"),
-    request("/api/campaigns")
+    request("/api/campaigns"),
+    request("/api/notebook/brief").catch(() => ({ brief: null }))
   ]);
   if (json) {
-    out(JSON.stringify({ pillars: pillars.pillars, series: series.campaigns }, null, 2));
+    out(JSON.stringify({ pillars: pillars.pillars, series: series.campaigns, brief: notebook.brief }, null, 2));
     return 0;
   }
   out();
+  if (notebook.brief) {
+    out(`  ${bold2("Who you are, as innernote knows it")}`);
+    for (const line of notebook.brief.split(`
+`)) {
+      if (line.trim())
+        out(`    ${dim2(line.replace(/^#+\s*/, ""))}`);
+    }
+    out();
+  }
   if (pillars.pillars.length) {
     out(`  ${bold2("What you post about")}`);
     for (const p of pillars.pillars) {
       out(`    ${caramel(p.name)}${typeof p.weight === "number" ? dim2(`   ${p.weight}%`) : ""}`);
     }
   } else {
-    out(`  ${dim2("No content pillars yet. Set them in Settings.")}`);
+    out(`  ${dim2("No topics yet. Set them in Settings.")}`);
   }
   out();
   if (series.campaigns.length) {
@@ -654,14 +759,6 @@ async function context(args) {
   return 0;
 }
 
-// src/commands/read.ts
-function parseFlags2(args) {
-  return {
-    json: args.includes("--json"),
-    rest: args.filter((a) => !a.startsWith("--"))
-  };
-}
-
 // src/progress.ts
 var DRAFTING = [
   { at: 0, text: "reading your voice..." },
@@ -830,10 +927,12 @@ async function whileThinking(phases, run) {
 }
 
 // src/commands/write.ts
+import { readFile as readFile2 } from "node:fs/promises";
 async function capture(args) {
-  const { json, rest } = parseFlags2(args);
-  const piped = await readStdin();
-  const content = (rest.join(" ").trim() || piped || "").trim();
+  const { json, rest } = parseFlags(args);
+  const typed = rest.join(" ").trim();
+  const piped = typed ? null : await readStdin();
+  const content = (typed || piped || "").trim();
   if (!content) {
     fail("Nothing to capture.");
     note(dim2('Try: innernote capture "the thing you just thought of"'));
@@ -852,22 +951,27 @@ async function capture(args) {
   note(dim2("`ideas` to see them, `write` to turn one into a post"));
   return 0;
 }
-async function write(args) {
-  const { json, rest } = parseFlags2(args);
-  const flagValue = (name) => {
-    const exact = args.indexOf(`--${name}`);
-    if (exact !== -1 && args[exact + 1] && !args[exact + 1].startsWith("--")) {
-      return args[exact + 1];
+async function saveNew(content, series, seriesSummary, title) {
+  return request("/api/posts", {
+    method: "POST",
+    body: {
+      content,
+      source: "cli",
+      ...title ? { title } : {},
+      ...series ? { series, seriesSummary: seriesSummary ?? undefined } : {}
     }
-    const inline = args.find((a) => a.startsWith(`--${name}=`));
-    return inline?.slice(name.length + 3);
-  };
-  const piped = await readStdin();
-  const thought = flagValue("thought") ?? (piped ?? undefined);
-  const topic = rest.filter((a) => a !== thought).join(" ").trim();
-  const format = flagValue("format");
-  const series = flagValue("series");
-  const save = args.includes("--save");
+  });
+}
+async function write(args) {
+  const { json, rest, value, has } = parseFlags(args, ["thought", "format", "series", "title"]);
+  const topic = rest.join(" ").trim();
+  const thoughtFlag = value("thought");
+  const piped = thoughtFlag || topic ? null : await readStdin();
+  const thought = thoughtFlag ?? (piped ?? undefined);
+  const format = value("format");
+  const series = value("series");
+  const title = value("title");
+  const save = has("save");
   const call = () => request("/api/content/generate", {
     method: "POST",
     body: {
@@ -885,8 +989,14 @@ async function write(args) {
     seriesSummary: post.seriesSummary ?? undefined,
     quality: post.qualityScore
   });
+  const saved = save ? await saveNew(post.content, series, post.seriesSummary, title) : null;
+  if (saved)
+    updateDraft({ id: saved.id });
+  if (saved && !title) {
+    await request(`/api/posts/${encodeURIComponent(saved.id)}/title`, { method: "POST", timeoutMs: 30000 }).catch(() => {});
+  }
   if (json) {
-    out(JSON.stringify(post, null, 2));
+    out(JSON.stringify(saved ? { ...post, id: saved.id } : post, null, 2));
     return 0;
   }
   out();
@@ -903,16 +1013,7 @@ async function write(args) {
   else if (post.similarity?.band === "adjacent")
     notes.push("close to something you already published");
   note(dim2(notes.join(", ")));
-  if (save) {
-    const saved = await request("/api/posts", {
-      method: "POST",
-      body: {
-        content: post.content,
-        source: "cli",
-        ...series ? { series, seriesSummary: post.seriesSummary } : {}
-      }
-    });
-    updateDraft({ id: saved.id });
+  if (saved) {
     ok(series ? `Saved into "${series}". ${dim2(saved.id)}` : `Saved as a draft. ${dim2(saved.id)}`);
   } else {
     note(dim2("Not saved yet. `save` to keep it, `shape shorter` to change it."));
@@ -934,11 +1035,11 @@ var SHAPES = [
   "jargon"
 ];
 async function shape(args) {
-  const { json, rest } = parseFlags2(args);
-  const piped = await readStdin();
+  const { json, rest } = parseFlags(args);
+  const held = getDraft();
+  const piped = held ? null : await readStdin();
   const chosen = rest.filter((a) => SHAPES.includes(a));
   const freeText = rest.filter((a) => !SHAPES.includes(a)).join(" ").trim();
-  const held = getDraft();
   const content = (piped ?? held?.content ?? "").trim();
   if (!content) {
     fail("Nothing to reshape.");
@@ -976,15 +1077,38 @@ async function shape(args) {
   note(dim2(held?.id ? "`save` to update it" : "`save` to keep it"));
   return 0;
 }
+function parseWhen(input) {
+  const local = input.trim().match(/^(\d{4})-(\d{2})-(\d{2})[ T](\d{1,2}):(\d{2})$/);
+  if (local) {
+    const [, y, mo, d, h, mi] = local.map(Number);
+    return new Date(y, mo - 1, d, h, mi).getTime();
+  }
+  const t = Date.parse(input);
+  return Number.isFinite(t) ? t : null;
+}
 async function queue(args) {
-  const { json, rest } = parseFlags2(args);
-  const id = rest[0];
-  if (!id) {
+  const { json, rest, value } = parseFlags(args, ["at"]);
+  const ref = rest[0] ? resolveRef(rest[0]) : null;
+  if (!ref) {
     fail("Which post?");
-    note(dim2(`${CMD} queue <post-id>   (ids come from \`${CMD} drafts --json\`)`));
+    note(dim2(`${CMD} drafts   then   ${CMD} queue 3`));
+    note(dim2(`Or pass the id: ${CMD} queue <post-id>`));
     return 1;
   }
-  const result = await request(`/api/posts/${encodeURIComponent(id)}/queue`, { method: "POST", timeoutMs: 60000 });
+  const at = value("at");
+  let result;
+  if (at !== undefined) {
+    const when2 = parseWhen(at);
+    if (when2 == null) {
+      fail(`"${at}" is not a time.`);
+      note(dim2(`${CMD} queue <post-id> --at "2026-10-12 12:31"`));
+      return 1;
+    }
+    await request(`/api/linkedin/schedule`, { method: "POST", body: { postId: ref.id, scheduledFor: when2 }, timeoutMs: 60000 });
+    result = { success: true, scheduledFor: when2 };
+  } else {
+    result = await request(`/api/posts/${encodeURIComponent(ref.id)}/queue`, { method: "POST", timeoutMs: 60000 });
+  }
   if (json) {
     out(JSON.stringify(result, null, 2));
     return 0;
@@ -999,7 +1123,7 @@ async function queue(args) {
   return 0;
 }
 async function save(args) {
-  const { json } = parseFlags2(args);
+  const { json } = parseFlags(args);
   const held = getDraft();
   if (!held?.content) {
     fail("Nothing to save.");
@@ -1026,7 +1150,7 @@ async function save(args) {
   return 0;
 }
 async function open(args) {
-  const { json, rest } = parseFlags2(args);
+  const { json, rest } = parseFlags(args);
   const ref = rest[0];
   if (!ref) {
     fail("Open which one?");
@@ -1058,9 +1182,19 @@ async function open(args) {
   return 0;
 }
 async function ask(args) {
-  const { json, rest } = parseFlags2(args);
+  const { json, rest, value, has } = parseFlags(args, ["post", "passage", "preset", "shape"]);
   const message = rest.join(" ").trim();
   const held = getDraft();
+  const postRef = value("post");
+  if (postRef) {
+    const target = {
+      passage: value("passage"),
+      preset: value("preset"),
+      shape: value("shape"),
+      region: has("hook") ? "hook" : has("ending") ? "ending" : undefined
+    };
+    return askAboutPost(postRef, message, target, json);
+  }
   if (!message) {
     fail("Say what you want changed.");
     note(dim2("ask cut the second half and land it harder"));
@@ -1086,7 +1220,7 @@ async function ask(args) {
     id = saved.id;
     updateDraft({ id });
   }
-  const call = () => request(`/api/posts/${encodeURIComponent(id)}/edit`, { method: "POST", body: { text: message, scope: "whole" }, timeoutMs: 150000 });
+  const call = () => request(`/api/posts/${encodeURIComponent(id)}/edit`, { method: "POST", body: { text: held.content, instruction: message, scope: "whole" }, timeoutMs: 150000 });
   const result = json ? await call() : await whileThinking([
     { at: 0, text: "reading the post..." },
     { at: 3, text: "working on it..." },
@@ -1112,7 +1246,9 @@ async function ask(args) {
   return 0;
 }
 async function show(args) {
-  const { json } = parseFlags2(args);
+  const { json, rest } = parseFlags(args);
+  if (rest[0])
+    return showPost(rest[0], json);
   const held = getDraft();
   if (!held?.content) {
     note("Nothing in hand.");
@@ -1150,7 +1286,7 @@ async function drop() {
   return 0;
 }
 async function unqueue(args) {
-  const { json, rest } = parseFlags2(args);
+  const { json, rest } = parseFlags(args);
   const ref = rest[0] ? resolveRef(rest[0]) : null;
   if (!ref) {
     fail("Which post?");
@@ -1166,6 +1302,267 @@ async function unqueue(args) {
   note(dim2("`drafts` to find it, `queue` to send it back"));
   return 0;
 }
+async function postFromRef(refArg, usage) {
+  const ref = resolveRef(refArg);
+  if (!ref) {
+    fail(`No post ${refArg}.`);
+    note(dim2(usage));
+    return null;
+  }
+  const post = await fetchPost(ref.id);
+  if (!post) {
+    fail("That post could not be found.");
+    note(dim2(`\`${CMD} drafts\` lists them with their ids`));
+    return null;
+  }
+  return post;
+}
+var PRESETS = {
+  selection: ["sharpen", "shorter", "punchier", "simpler", "example", "deslop", "concrete", "warmer", "list"],
+  whole: ["tighten_all", "as_list", "as_story", "fix_spacing"],
+  region: ["rewrite_hook", "rewrite_ending", "ending_question"]
+};
+var SHAPE_NAMES = [
+  "story",
+  "opinion",
+  "listicle",
+  "contrarian",
+  "experience",
+  "howto",
+  "lessons",
+  "casestudy",
+  "framework",
+  "question",
+  "announcement",
+  "prediction",
+  "beliefbreak"
+];
+function askBody(content, message, t) {
+  const preset = t.preset;
+  if (preset && ![...PRESETS.selection, ...PRESETS.whole, ...PRESETS.region].includes(preset)) {
+    return `There is no preset called "${preset}". Presets: ${[...PRESETS.selection, ...PRESETS.whole, ...PRESETS.region].join(", ")}`;
+  }
+  if (t.shape) {
+    if (!SHAPE_NAMES.includes(t.shape))
+      return `There is no shape called "${t.shape}". Shapes: ${SHAPE_NAMES.join(", ")}`;
+    return { text: content, format: t.shape };
+  }
+  if (t.passage !== undefined) {
+    const at = content.indexOf(t.passage);
+    if (!t.passage.trim() || at < 0)
+      return "That passage is not in the post. Copy it exactly, from `show`.";
+    if (preset && !PRESETS.selection.includes(preset)) {
+      return `"${preset}" works on the whole post or its hook or ending, not on a passage. On a passage: ${PRESETS.selection.join(", ")}`;
+    }
+    if (!preset && !message)
+      return "Say what to change in that passage, or name a preset.";
+    return {
+      text: content,
+      scope: "selection",
+      fragment: t.passage,
+      selStart: at,
+      selEnd: at + t.passage.length,
+      ...preset ? { preset } : { instruction: message }
+    };
+  }
+  if (t.region) {
+    if (preset)
+      return "Name a hook or ending preset on its own: --preset rewrite_hook, rewrite_ending or ending_question.";
+    if (!message)
+      return `Say what to change in the ${t.region}.`;
+    return { text: content, scope: "region", region: t.region, instruction: message };
+  }
+  if (preset) {
+    if (PRESETS.selection.includes(preset))
+      return `"${preset}" works on a passage: add --passage "the exact words".`;
+    return { text: content, preset };
+  }
+  if (!message)
+    return "Say what you want changed.";
+  return { text: content, instruction: message, scope: "whole" };
+}
+async function askAboutPost(refArg, message, target, json) {
+  const post = await postFromRef(refArg, `${CMD} ask --post <post-id> "what to change"`);
+  if (!post)
+    return 1;
+  if (post.status === "published") {
+    fail("That post is already live on LinkedIn, so it cannot be changed here.");
+    return 1;
+  }
+  const body = askBody(post.content, message, target);
+  if (typeof body === "string") {
+    fail(body);
+    return 1;
+  }
+  const call = () => request(`/api/posts/${encodeURIComponent(post._id)}/edit`, { method: "POST", body, timeoutMs: 150000 });
+  const result = json ? await call() : await whileThinking([
+    { at: 0, text: "reading the post..." },
+    { at: 3, text: "working on it..." },
+    { at: 14, text: "still going..." }
+  ], call);
+  let stored = post.content;
+  if (result.changed && result.post) {
+    const after = await fetchPost(post._id);
+    stored = after?.content ?? stored;
+    if (stored !== result.post) {
+      await request(`/api/posts/${encodeURIComponent(post._id)}/draft`, {
+        method: "POST",
+        body: { text: result.post, previous: stored, origin: "suggestion" }
+      });
+      stored = result.post;
+    }
+  }
+  if (json) {
+    out(JSON.stringify({ id: post._id, changed: !!result.changed, post: stored, passage: result.fragment ?? null, reply: result.reply ?? null }, null, 2));
+    return 0;
+  }
+  out();
+  out(stored);
+  out();
+  if (result.changed && result.fragment && target.passage !== undefined) {
+    note(dim2(`was:  ${target.passage}`));
+    note(dim2(`now:  ${result.fragment}`));
+  }
+  if (result.reply)
+    note(dim2(result.reply));
+  note(dim2(result.changed ? `Saved.  ${post._id}` : `No change.  ${post._id}`));
+  return 0;
+}
+async function showPost(refArg, json) {
+  const post = await postFromRef(refArg, `${CMD} show <post-id>`);
+  if (!post)
+    return 1;
+  const series = await listSeries();
+  if (json) {
+    out(JSON.stringify(postForJson(post, series), null, 2));
+    return 0;
+  }
+  const when = (ms) => new Date(ms).toLocaleString(undefined, { weekday: "short", day: "numeric", month: "short", hour: "numeric", minute: "2-digit" });
+  const seriesName = post.campaignId ? series.find((s) => s._id === post.campaignId)?.name : undefined;
+  const media = describeMedia(post);
+  const url = linkedinUrl(post);
+  out();
+  out(post.content);
+  out();
+  const facts = [
+    ["title", post.title || "untitled"],
+    ["status", post.status],
+    ["series", seriesName],
+    ["attached", media ?? undefined],
+    ["first comment", post.firstComment ? post.firstComment.replace(/\s+/g, " ").slice(0, 80) : undefined],
+    ["scheduled", post.scheduledFor && post.status !== "published" ? when(post.scheduledFor) : undefined],
+    ["published", post.publishedAt ? when(post.publishedAt) : undefined],
+    ["on linkedin", url ?? undefined],
+    [
+      "reactions",
+      post.linkedinLikes !== undefined || post.linkedinComments !== undefined ? `${post.linkedinLikes ?? 0} likes, ${post.linkedinComments ?? 0} comments` : undefined
+    ],
+    ["id", post._id]
+  ];
+  for (const [label, valueText] of facts) {
+    if (valueText)
+      note(`${dim2(label.padEnd(14))}${valueText}`);
+  }
+  return 0;
+}
+async function edit(args) {
+  const { json, rest, value } = parseFlags(args, ["text", "file", "title", "first-comment", "series", "status"]);
+  const refArg = rest[0];
+  if (!refArg) {
+    fail("Edit which post?");
+    note(dim2(`${CMD} edit <post-id> --file post.txt`));
+    note(dim2(`${CMD} edit <post-id> --title "A title"`));
+    return 1;
+  }
+  const title = value("title");
+  const firstComment = value("first-comment");
+  const seriesName = value("series");
+  const status = value("status");
+  const file = value("file");
+  let text = value("text");
+  if (file)
+    text = await readFile2(file, "utf8");
+  const fieldsGiven = title !== undefined || firstComment !== undefined || seriesName !== undefined || status !== undefined;
+  if (text === undefined && !fieldsGiven) {
+    text = await readStdin() ?? undefined;
+  }
+  if (text === undefined && !fieldsGiven) {
+    fail("Nothing to change.");
+    note(dim2("--file, --text or piped text for the post, --title, --first-comment, --series, --status"));
+    return 1;
+  }
+  if (status !== undefined && status !== "ready" && status !== "draft") {
+    fail("--status is ready or draft.");
+    note(dim2("Scheduling is `queue`, and taking it out of the queue is `unqueue`."));
+    return 1;
+  }
+  const post = await postFromRef(refArg, `${CMD} edit <post-id> --file post.txt`);
+  if (!post)
+    return 1;
+  const changed = [];
+  let content = post.content;
+  if (text !== undefined) {
+    const next = text.replace(/\s+$/, "");
+    if (!next.trim()) {
+      fail("That text is empty.");
+      return 1;
+    }
+    if (post.status === "published") {
+      fail("That post is already live on LinkedIn, so its text cannot be changed here.");
+      return 1;
+    }
+    if (next !== post.content) {
+      await request(`/api/posts/${encodeURIComponent(post._id)}/draft`, {
+        method: "POST",
+        body: { text: next, previous: post.content, origin: "stream" }
+      });
+      content = next;
+      changed.push("text");
+    }
+  }
+  if (title !== undefined || firstComment !== undefined) {
+    await request("/api/posts", {
+      method: "POST",
+      body: {
+        id: post._id,
+        content,
+        ...title !== undefined ? { title } : {},
+        ...firstComment !== undefined ? { firstComment } : {}
+      }
+    });
+    if (title !== undefined)
+      changed.push("title");
+    if (firstComment !== undefined)
+      changed.push("first comment");
+  }
+  if (seriesName !== undefined) {
+    let toCampaignId = null;
+    if (seriesName.trim().toLowerCase() !== "none" && seriesName.trim()) {
+      const all = await listSeries();
+      const target = matchSeries(all, seriesName);
+      if (!target) {
+        fail(`No series called "${seriesName}".`);
+        if (all.length)
+          note(dim2(`Yours: ${all.map((x) => x.name).join(", ")}`));
+        return 1;
+      }
+      toCampaignId = target._id;
+    }
+    await request("/api/campaigns/move", { method: "POST", body: { postId: post._id, toCampaignId } });
+    changed.push(toCampaignId ? "series" : "series (taken out)");
+  }
+  if (status !== undefined) {
+    await request(`/api/posts/${encodeURIComponent(post._id)}/ready`, { method: status === "ready" ? "POST" : "DELETE" });
+    changed.push(`status (${status})`);
+  }
+  if (json) {
+    out(JSON.stringify({ id: post._id, changed }, null, 2));
+    return 0;
+  }
+  ok(changed.length ? `Updated the ${changed.join(", ")}.  ${dim2(post._id)}` : `Nothing was different.  ${dim2(post._id)}`);
+  note(dim2(`\`${CMD} show ${post._id}\` to read it back`));
+  return 0;
+}
 
 // src/ui.ts
 var useColor2 = process.stdout.isTTY === true && !process.env.NO_COLOR && process.env.TERM !== "dumb";
@@ -1322,12 +1719,13 @@ var COMMANDS = {
   write: {
     summary: "draft a post in your voice",
     usage: "innernote write [topic] [options]",
-    detail: "Not a prompt box. innernote already holds your voice, your pillars and what you have published, so give it the subject and let it write. Run it bare and it picks the pillar you have covered least.",
+    detail: "Not a prompt box. innernote already holds your voice, your topics and what you have published, so give it the subject and let it write. Run it bare and it picks the topic you have covered least.",
     options: [
       ["--thought <text>", "turn a half-formed note into a post, keeping your phrasing"],
       ["--series <name>", "write into one of your series, so it follows on"],
       ["--format <name>", "story, listicle, contrarian, ..."],
-      ["--save", "keep it as a draft in the app"]
+      ["--save", "keep it as a draft in the app"],
+      ["--title <text>", "the title it is saved under (with --save); without it, one is written for you"]
     ],
     examples: [
       "innernote write",
@@ -1355,15 +1753,70 @@ var COMMANDS = {
     ]
   },
   ask: {
-    summary: "talk to the post in your own words",
-    usage: "innernote ask <what you want>",
-    detail: "The Writer, here. The app's composer is a conversation with the post in front of you, and this is the same assistant: it can change the post, answer a question about it, or say it would rather not. `shape` covers the moves that have names; this covers everything else.",
+    summary: "talk to the post in your own words, or edit one passage of it",
+    usage: "innernote ask [--post <id>] [--passage <text> | --hook | --ending] [--preset <name> | --shape <name>] [what you want]",
+    detail: "The Writer, here. The app's composer is a conversation with the post in front of you, and this is the same assistant: it can change the post, answer a question about it, or say it would rather not. In a session it works on the post in hand. With --post it works on a saved post in one command, and the change is kept in the post's history. --passage is the editor's selection: the exact words to change, and only those change. --hook and --ending are the opening and closing block. --preset is a toolbar edit by name, --shape the format picker.",
+    options: [
+      ["--post <id>", "a saved post, by id, instead of the one in hand"],
+      ["--passage <text>", "change only these exact words of the post"],
+      ["--hook, --ending", "change only the opening, or the closing"],
+      ["--preset <name>", "on a passage: sharpen shorter punchier simpler example deslop concrete warmer list. On the post: tighten_all as_list as_story fix_spacing rewrite_hook rewrite_ending ending_question"],
+      ["--shape <name>", "story opinion listicle contrarian experience howto lessons casestudy framework question announcement prediction beliefbreak"]
+    ],
     examples: [
       "ask cut the second half and land it harder",
       "ask this ending is soft, what would you do",
-      "ask say what happened instead of what I learned"
+      'innernote ask --post p17abc... "make the opening shorter"',
+      'innernote ask --post p17abc... --passage "we got lucky" "say what the luck actually was"',
+      'innernote ask --post p17abc... --passage "we got lucky" --preset concrete',
+      "innernote ask --post p17abc... --preset ending_question",
+      "innernote ask --post p17abc... --shape story"
     ]
   },
+  edit: {
+    summary: "change a saved post: its text, title, first comment, series or status",
+    usage: "innernote edit <id> [--file <path> | --text <text>] [--title <text>] [--first-comment <text>] [--series <name>] [--status ready|draft]",
+    detail: "Puts your own words into a saved post. New text comes from --file, --text or a pipe, and is saved the way the app saves a draft, so the old text is one Undo away in the post's history. A post already live on LinkedIn keeps its text. The id comes from `drafts --json` or `show`.",
+    options: [
+      ["--file <path>", "the new text of the post, from a file"],
+      ["--text <text>", "the new text of the post, inline"],
+      ["--title <text>", "the post's title in the app"],
+      ["--first-comment <text>", "the comment posted under it when it goes live"],
+      ["--series <name>", "file it into a series, or `none` to take it out"],
+      ["--status <ready|draft>", "mark it ready, or send it back to draft"]
+    ],
+    examples: [
+      "innernote edit p17abc... --file post.txt",
+      "pbpaste | innernote edit p17abc...",
+      'innernote edit p17abc... --title "The sales call" --first-comment "link: innernote.space"',
+      'innernote edit p17abc... --series "Build in Public" --status ready'
+    ]
+  },
+  attach: {
+    summary: "put an image, images, a PDF or a video on a saved post",
+    usage: "innernote attach <id> <file...> [--title <text>] | innernote attach <id> --remove",
+    detail: "Uploads straight to innernote's storage on a signed link, the way the app does, and attaches it to the post. Several images become a grid. A PDF shows on LinkedIn as a carousel people swipe through, under its title. A post carries one kind of attachment, so attaching replaces what was there.",
+    options: [
+      ["--title <text>", "the title of a PDF or a video (default: the file name)"],
+      ["--remove", "take the attachment off"]
+    ],
+    examples: [
+      "innernote attach p17abc... picture.png",
+      'innernote attach p17abc... slides.pdf --title "How we price"',
+      "innernote attach p17abc... --remove"
+    ]
+  },
+  delete: {
+    summary: "move a post to the trash",
+    usage: "innernote delete <id>",
+    detail: "The same as Delete in the Posts list: the post is kept, and `restore` brings it back. It does not take anything down from LinkedIn.",
+    examples: ["innernote delete p17abc...", "innernote restore p17abc..."]
+  },
+  restore: {
+    summary: "bring a post back out of the trash",
+    usage: "innernote restore <id>",
+    examples: ["innernote restore p17abc..."]
+  },
   save: {
     summary: "keep the draft you are looking at",
     usage: "innernote save",
@@ -1371,10 +1824,10 @@ var COMMANDS = {
     examples: ['write "hiring your first engineer"', "shape shorter", "save"]
   },
   show: {
-    summary: "see the post you are holding",
-    usage: "innernote show",
-    detail: "A session scrolls, and the post you are working on goes off the top while you look at your week. This brings it back, and says whether it is saved.",
-    examples: ["show"]
+    summary: "see a post, with everything the app knows about it",
+    usage: "innernote show [id]",
+    detail: "With an id: the post's text on stdout, and its title, status, series, attachment, first comment, schedule, LinkedIn link and reactions on stderr, all of it in --json. Without one, in a session: the post you are holding, and whether it is saved.",
+    examples: ["innernote show p17abc...", "innernote show p17abc... --json", "show"]
   },
   drop: {
     summary: "put down whatever you are holding",
@@ -1389,9 +1842,10 @@ var COMMANDS = {
   },
   drafts: {
     summary: "your posts, numbered",
-    usage: "innernote drafts [status]",
-    detail: "Numbered so you can pick one with `open 3` instead of copying a thirty-two character id. The numbers refer to the list you are looking at and are replaced by the next one.",
-    examples: ["drafts", "drafts ready", "drafts --json | jq -r '.[]._id'"]
+    usage: "innernote drafts [status] [--series <name>]",
+    detail: "Numbered so you can pick one with `open 3` instead of copying a thirty-two character id. The numbers refer to the list you are looking at and are replaced by the next one. --series lists one series in its own order. Each --json row also carries the series name and, once published, the LinkedIn link.",
+    options: [["--series <name>", "only the posts in this series, in its order"]],
+    examples: ["drafts", "drafts ready", 'drafts --series "Growing innernote"', "drafts --json | jq -r '.[]._id'"]
   },
   open: {
     summary: "pull a post out of the list and work on it",
@@ -1417,16 +1871,17 @@ var COMMANDS = {
     examples: ["innernote skill", "innernote skill --install"]
   },
   context: {
-    summary: "what you post about: your pillars and your series",
+    summary: "what you post about: your topics and your series",
     usage: "innernote context",
-    detail: "Your standing context: content pillars with their weights, and every running series with what it is about and what it is for. This is the thing to read before deciding what to write, and the thing an agent should read first for the same reason. --json prints the raw payload for scripts and models.",
+    detail: "Your standing context: your topics with their weights, and every running series with what it is about and what it is for. This is the thing to read before deciding what to write, and the thing an agent should read first for the same reason. --json prints the raw payload for scripts and models.",
     examples: ["innernote context", "innernote context --json"]
   },
   queue: {
     summary: "schedule a post into your next open slot",
-    usage: "innernote queue <post-id>",
-    detail: "A queued post GOES LIVE on LinkedIn on its own at your next cadence slot. Nobody presses anything again. Needs a connection you allowed to publish: tick that box in Settings when you generate the code.",
-    examples: ["innernote drafts", "innernote queue p17a1yk936ywnan10643efjtc58dhkah"]
+    usage: "innernote queue <post-id> [--at <time>]",
+    detail: "A queued post GOES LIVE on LinkedIn on its own at your next cadence slot. Nobody presses anything again. Needs a connection you allowed to publish: tick that box in Settings when you generate the code. Takes a number from the last list, or a full id. It never assumes the draft in hand: this is the one command that makes you say which post.",
+    options: [["--at <time>", `a time you pick, like "2026-10-12 12:31" (this machine's timezone), instead of the next open slot`]],
+    examples: ["innernote drafts", "innernote queue 3", "innernote queue p17a1yk936ywnan10643efjtc58dhkah"]
   }
 };
 function commandHelp(name) {
@@ -1539,8 +1994,29 @@ function suggest(state) {
 // package.json
 var package_default = {
   name: "innernote",
-  version: "0.3.3",
+  version: "0.4.0",
   description: "Write LinkedIn posts in your voice, from the terminal.",
+  keywords: [
+    "linkedin",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-agent",
+    "claude",
+    "claude-code",
+    "cursor",
+    "agent-skill",
+    "writing",
+    "content",
+    "personal-branding",
+    "ghostwriting",
+    "cli"
+  ],
+  homepage: "https://www.innernote.space/cli",
+  license: "UNLICENSED",
+  bugs: {
+    url: "https://www.innernote.space/cli"
+  },
   type: "module",
   bin: {
     innernote: "dist/index.js"
@@ -1623,7 +2099,7 @@ async function home(inSession = false) {
 }
 
 // src/commands/skill.ts
-import { chmod as chmod2, mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { chmod as chmod2, mkdir as mkdir2, readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
 import { dirname, join as join2 } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -1631,7 +2107,7 @@ async function readSkill() {
   const here = dirname(fileURLToPath(import.meta.url));
   for (const rel of ["../../skills/innernote-cli/SKILL.md", "../skills/innernote-cli/SKILL.md"]) {
     try {
-      return await readFile2(join2(here, rel), "utf8");
+      return await readFile3(join2(here, rel), "utf8");
     } catch {}
   }
   return null;
@@ -1658,6 +2134,158 @@ async function skill(args) {
   return 0;
 }
 
+// src/commands/post.ts
+import { readFile as readFile4, stat } from "node:fs/promises";
+import { basename, extname } from "node:path";
+var TYPES = {
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".pdf": "application/pdf",
+  ".mp4": "video/mp4",
+  ".mov": "video/quicktime"
+};
+function imageSize(buf) {
+  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+  if (buf.length > 24 && buf[0] === 137 && buf[1] === 80) {
+    return { width: view.getUint32(16), height: view.getUint32(20) };
+  }
+  if (buf.length > 10 && buf[0] === 71 && buf[1] === 73 && buf[2] === 70) {
+    return { width: view.getUint16(6, true), height: view.getUint16(8, true) };
+  }
+  if (buf.length > 30 && buf[8] === 87 && buf[9] === 69 && buf[10] === 66 && buf[11] === 80) {
+    const kind = String.fromCharCode(buf[12], buf[13], buf[14], buf[15]);
+    if (kind === "VP8X") {
+      return { width: 1 + (buf[24] | buf[25] << 8 | buf[26] << 16), height: 1 + (buf[27] | buf[28] << 8 | buf[29] << 16) };
+    }
+    if (kind === "VP8 ")
+      return { width: view.getUint16(26, true) & 16383, height: view.getUint16(28, true) & 16383 };
+    if (kind === "VP8L") {
+      const b = view.getUint32(21, true);
+      return { width: (b & 16383) + 1, height: (b >> 14 & 16383) + 1 };
+    }
+  }
+  if (buf.length > 4 && buf[0] === 255 && buf[1] === 216) {
+    let i = 2;
+    while (i + 9 < buf.length) {
+      if (buf[i] !== 255)
+        return;
+      const marker = buf[i + 1];
+      const len = view.getUint16(i + 2);
+      if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
+        return { width: view.getUint16(i + 7), height: view.getUint16(i + 5) };
+      }
+      i += 2 + len;
+    }
+  }
+  return;
+}
+async function upload(path) {
+  const contentType = TYPES[extname(path).toLowerCase()];
+  if (!contentType) {
+    throw new Error(`Can't attach ${basename(path)}. Images (jpg, png, gif, webp), a PDF, or a video (mp4, mov).`);
+  }
+  const size = (await stat(path)).size;
+  const bytes = await readFile4(path);
+  const signed = await request("/api/uploads/presign", {
+    method: "POST",
+    body: { filename: basename(path), contentType, size }
+  });
+  const put = await fetch(signed.uploadUrl, { method: "PUT", headers: { "Content-Type": contentType }, body: bytes });
+  if (!put.ok)
+    throw new Error(`The upload of ${basename(path)} failed (${put.status}).`);
+  const dims = contentType.startsWith("image/") ? imageSize(new Uint8Array(bytes)) : undefined;
+  return { asset: { url: signed.publicUrl, name: basename(path), ...dims ?? {} }, contentType };
+}
+async function attach(args) {
+  const { json, rest, value, has } = parseFlags(args, ["title"]);
+  const [refArg, ...files] = rest;
+  if (!refArg || !files.length && !has("remove")) {
+    fail("Attach what to which post?");
+    note(dim2(`${CMD} attach <post-id> picture.png`));
+    note(dim2(`${CMD} attach <post-id> slides.pdf --title "How we price"`));
+    return 1;
+  }
+  const ref = resolveRef(refArg);
+  const post = ref ? await fetchPost(ref.id) : null;
+  if (!post) {
+    fail("That post could not be found.");
+    note(dim2(`\`${CMD} drafts\` lists them with their ids`));
+    return 1;
+  }
+  if (post.status === "published") {
+    fail("That post is already live on LinkedIn, so its attachment cannot change here.");
+    return 1;
+  }
+  let media;
+  if (has("remove")) {
+    media = { kind: "text" };
+  } else {
+    const uploaded = [];
+    for (const f of files)
+      uploaded.push(await upload(f));
+    const kinds = new Set(uploaded.map((u) => u.contentType.split("/")[0]));
+    const title = value("title") ?? basename(files[0], extname(files[0]));
+    if (uploaded.every((u) => u.contentType.startsWith("image/"))) {
+      if (uploaded.length > 20) {
+        fail("A post takes at most 20 images.");
+        return 1;
+      }
+      media = uploaded.length === 1 ? { kind: "image", asset: uploaded[0].asset } : { kind: "multiImage", assets: uploaded.map((u) => u.asset) };
+    } else if (uploaded.length === 1 && uploaded[0].contentType === "application/pdf") {
+      media = { kind: "document", asset: uploaded[0].asset, title };
+    } else if (uploaded.length === 1 && kinds.has("video")) {
+      media = { kind: "video", asset: uploaded[0].asset, title };
+    } else {
+      fail("A post carries one kind of attachment: images, or one PDF, or one video.");
+      return 1;
+    }
+  }
+  await request("/api/posts", { method: "POST", body: { id: post._id, content: post.content, media } });
+  if (json) {
+    out(JSON.stringify({ id: post._id, media }, null, 2));
+    return 0;
+  }
+  ok(media.kind === "text" ? `Took the attachment off.  ${dim2(post._id)}` : `Attached.  ${dim2(post._id)}`);
+  note(dim2(`\`${CMD} show ${post._id}\` to check it`));
+  return 0;
+}
+async function deletePost(args) {
+  const { json, rest } = parseFlags(args);
+  const ref = rest[0] ? resolveRef(rest[0]) : null;
+  if (!ref) {
+    fail("Delete which post?");
+    note(dim2(`${CMD} delete <post-id>`));
+    return 1;
+  }
+  await request(`/api/posts/${encodeURIComponent(ref.id)}`, { method: "DELETE" });
+  if (json) {
+    out(JSON.stringify({ id: ref.id, deleted: true }, null, 2));
+    return 0;
+  }
+  ok(`Moved to the trash.  ${dim2(ref.id)}`);
+  note(dim2(`\`${CMD} restore ${ref.id}\` brings it back`));
+  return 0;
+}
+async function restorePost(args) {
+  const { json, rest } = parseFlags(args);
+  const ref = rest[0] ? resolveRef(rest[0]) : null;
+  if (!ref) {
+    fail("Restore which post?");
+    note(dim2(`${CMD} restore <post-id>`));
+    return 1;
+  }
+  await request(`/api/posts/${encodeURIComponent(ref.id)}/restore`, { method: "POST" });
+  if (json) {
+    out(JSON.stringify({ id: ref.id, restored: true }, null, 2));
+    return 0;
+  }
+  ok(`Restored. It is back in your posts.  ${dim2(ref.id)}`);
+  return 0;
+}
+
 // src/session.ts
 import { createInterface } from "node:readline";
 
@@ -1715,12 +2343,13 @@ var COMMANDS2 = {
   write: {
     summary: "draft a post in your voice",
     usage: "innernote write [topic] [options]",
-    detail: "Not a prompt box. innernote already holds your voice, your pillars and what you have published, so give it the subject and let it write. Run it bare and it picks the pillar you have covered least.",
+    detail: "Not a prompt box. innernote already holds your voice, your topics and what you have published, so give it the subject and let it write. Run it bare and it picks the topic you have covered least.",
     options: [
       ["--thought <text>", "turn a half-formed note into a post, keeping your phrasing"],
       ["--series <name>", "write into one of your series, so it follows on"],
       ["--format <name>", "story, listicle, contrarian, ..."],
-      ["--save", "keep it as a draft in the app"]
+      ["--save", "keep it as a draft in the app"],
+      ["--title <text>", "the title it is saved under (with --save); without it, one is written for you"]
     ],
     examples: [
       "innernote write",
@@ -1748,15 +2377,70 @@ var COMMANDS2 = {
     ]
   },
   ask: {
-    summary: "talk to the post in your own words",
-    usage: "innernote ask <what you want>",
-    detail: "The Writer, here. The app's composer is a conversation with the post in front of you, and this is the same assistant: it can change the post, answer a question about it, or say it would rather not. `shape` covers the moves that have names; this covers everything else.",
+    summary: "talk to the post in your own words, or edit one passage of it",
+    usage: "innernote ask [--post <id>] [--passage <text> | --hook | --ending] [--preset <name> | --shape <name>] [what you want]",
+    detail: "The Writer, here. The app's composer is a conversation with the post in front of you, and this is the same assistant: it can change the post, answer a question about it, or say it would rather not. In a session it works on the post in hand. With --post it works on a saved post in one command, and the change is kept in the post's history. --passage is the editor's selection: the exact words to change, and only those change. --hook and --ending are the opening and closing block. --preset is a toolbar edit by name, --shape the format picker.",
+    options: [
+      ["--post <id>", "a saved post, by id, instead of the one in hand"],
+      ["--passage <text>", "change only these exact words of the post"],
+      ["--hook, --ending", "change only the opening, or the closing"],
+      ["--preset <name>", "on a passage: sharpen shorter punchier simpler example deslop concrete warmer list. On the post: tighten_all as_list as_story fix_spacing rewrite_hook rewrite_ending ending_question"],
+      ["--shape <name>", "story opinion listicle contrarian experience howto lessons casestudy framework question announcement prediction beliefbreak"]
+    ],
     examples: [
       "ask cut the second half and land it harder",
       "ask this ending is soft, what would you do",
-      "ask say what happened instead of what I learned"
+      'innernote ask --post p17abc... "make the opening shorter"',
+      'innernote ask --post p17abc... --passage "we got lucky" "say what the luck actually was"',
+      'innernote ask --post p17abc... --passage "we got lucky" --preset concrete',
+      "innernote ask --post p17abc... --preset ending_question",
+      "innernote ask --post p17abc... --shape story"
+    ]
+  },
+  edit: {
+    summary: "change a saved post: its text, title, first comment, series or status",
+    usage: "innernote edit <id> [--file <path> | --text <text>] [--title <text>] [--first-comment <text>] [--series <name>] [--status ready|draft]",
+    detail: "Puts your own words into a saved post. New text comes from --file, --text or a pipe, and is saved the way the app saves a draft, so the old text is one Undo away in the post's history. A post already live on LinkedIn keeps its text. The id comes from `drafts --json` or `show`.",
+    options: [
+      ["--file <path>", "the new text of the post, from a file"],
+      ["--text <text>", "the new text of the post, inline"],
+      ["--title <text>", "the post's title in the app"],
+      ["--first-comment <text>", "the comment posted under it when it goes live"],
+      ["--series <name>", "file it into a series, or `none` to take it out"],
+      ["--status <ready|draft>", "mark it ready, or send it back to draft"]
+    ],
+    examples: [
+      "innernote edit p17abc... --file post.txt",
+      "pbpaste | innernote edit p17abc...",
+      'innernote edit p17abc... --title "The sales call" --first-comment "link: innernote.space"',
+      'innernote edit p17abc... --series "Build in Public" --status ready'
+    ]
+  },
+  attach: {
+    summary: "put an image, images, a PDF or a video on a saved post",
+    usage: "innernote attach <id> <file...> [--title <text>] | innernote attach <id> --remove",
+    detail: "Uploads straight to innernote's storage on a signed link, the way the app does, and attaches it to the post. Several images become a grid. A PDF shows on LinkedIn as a carousel people swipe through, under its title. A post carries one kind of attachment, so attaching replaces what was there.",
+    options: [
+      ["--title <text>", "the title of a PDF or a video (default: the file name)"],
+      ["--remove", "take the attachment off"]
+    ],
+    examples: [
+      "innernote attach p17abc... picture.png",
+      'innernote attach p17abc... slides.pdf --title "How we price"',
+      "innernote attach p17abc... --remove"
     ]
   },
+  delete: {
+    summary: "move a post to the trash",
+    usage: "innernote delete <id>",
+    detail: "The same as Delete in the Posts list: the post is kept, and `restore` brings it back. It does not take anything down from LinkedIn.",
+    examples: ["innernote delete p17abc...", "innernote restore p17abc..."]
+  },
+  restore: {
+    summary: "bring a post back out of the trash",
+    usage: "innernote restore <id>",
+    examples: ["innernote restore p17abc..."]
+  },
   save: {
     summary: "keep the draft you are looking at",
     usage: "innernote save",
@@ -1764,10 +2448,10 @@ var COMMANDS2 = {
     examples: ['write "hiring your first engineer"', "shape shorter", "save"]
   },
   show: {
-    summary: "see the post you are holding",
-    usage: "innernote show",
-    detail: "A session scrolls, and the post you are working on goes off the top while you look at your week. This brings it back, and says whether it is saved.",
-    examples: ["show"]
+    summary: "see a post, with everything the app knows about it",
+    usage: "innernote show [id]",
+    detail: "With an id: the post's text on stdout, and its title, status, series, attachment, first comment, schedule, LinkedIn link and reactions on stderr, all of it in --json. Without one, in a session: the post you are holding, and whether it is saved.",
+    examples: ["innernote show p17abc...", "innernote show p17abc... --json", "show"]
   },
   drop: {
     summary: "put down whatever you are holding",
@@ -1782,9 +2466,10 @@ var COMMANDS2 = {
   },
   drafts: {
     summary: "your posts, numbered",
-    usage: "innernote drafts [status]",
-    detail: "Numbered so you can pick one with `open 3` instead of copying a thirty-two character id. The numbers refer to the list you are looking at and are replaced by the next one.",
-    examples: ["drafts", "drafts ready", "drafts --json | jq -r '.[]._id'"]
+    usage: "innernote drafts [status] [--series <name>]",
+    detail: "Numbered so you can pick one with `open 3` instead of copying a thirty-two character id. The numbers refer to the list you are looking at and are replaced by the next one. --series lists one series in its own order. Each --json row also carries the series name and, once published, the LinkedIn link.",
+    options: [["--series <name>", "only the posts in this series, in its order"]],
+    examples: ["drafts", "drafts ready", 'drafts --series "Growing innernote"', "drafts --json | jq -r '.[]._id'"]
   },
   open: {
     summary: "pull a post out of the list and work on it",
@@ -1810,16 +2495,17 @@ var COMMANDS2 = {
     examples: ["innernote skill", "innernote skill --install"]
   },
   context: {
-    summary: "what you post about: your pillars and your series",
+    summary: "what you post about: your topics and your series",
     usage: "innernote context",
-    detail: "Your standing context: content pillars with their weights, and every running series with what it is about and what it is for. This is the thing to read before deciding what to write, and the thing an agent should read first for the same reason. --json prints the raw payload for scripts and models.",
+    detail: "Your standing context: your topics with their weights, and every running series with what it is about and what it is for. This is the thing to read before deciding what to write, and the thing an agent should read first for the same reason. --json prints the raw payload for scripts and models.",
     examples: ["innernote context", "innernote context --json"]
   },
   queue: {
     summary: "schedule a post into your next open slot",
-    usage: "innernote queue <post-id>",
-    detail: "A queued post GOES LIVE on LinkedIn on its own at your next cadence slot. Nobody presses anything again. Needs a connection you allowed to publish: tick that box in Settings when you generate the code.",
-    examples: ["innernote drafts", "innernote queue p17a1yk936ywnan10643efjtc58dhkah"]
+    usage: "innernote queue <post-id> [--at <time>]",
+    detail: "A queued post GOES LIVE on LinkedIn on its own at your next cadence slot. Nobody presses anything again. Needs a connection you allowed to publish: tick that box in Settings when you generate the code. Takes a number from the last list, or a full id. It never assumes the draft in hand: this is the one command that makes you say which post.",
+    options: [["--at <time>", `a time you pick, like "2026-10-12 12:31" (this machine's timezone), instead of the next open slot`]],
+    examples: ["innernote drafts", "innernote queue 3", "innernote queue p17a1yk936ywnan10643efjtc58dhkah"]
   }
 };
 function commandHelp2(name) {
@@ -1875,7 +2561,7 @@ function tokenize(line2) {
         quote = null;
       else
         cur += ch;
-    } else if (ch === '"' || ch === "'") {
+    } else if ((ch === '"' || ch === "'") && cur === "") {
       quote = ch;
     } else if (/\s/.test(ch)) {
       if (cur)
@@ -2104,9 +2790,10 @@ var VERSION2 = package_default.version;
 function commandList() {
   const groups = [
     ["Getting connected", ["login", "logout", "whoami", "skill"]],
-    ["Writing", ["write", "shape", "ask", "save", "capture"]],
+    ["Writing", ["write", "shape", "ask", "edit", "attach", "save", "capture"]],
     ["Looking", ["show", "ideas", "drafts", "open", "week", "context"]],
-    ["Shipping", ["queue", "unqueue"]]
+    ["Shipping", ["queue", "unqueue"]],
+    ["Tidying", ["delete", "restore"]]
   ];
   const lines = [];
   for (const [title, names] of groups) {
@@ -2140,6 +2827,10 @@ var COMMANDS3 = {
   write,
   shape,
   ask,
+  edit,
+  attach,
+  delete: deletePost,
+  restore: restorePost,
   save,
   show,
   drop,
@@ -2166,6 +2857,10 @@ async function main() {
         return d.id ? "saved" : "unsaved";
       },
       run: async (name, rest) => {
+        if (rest.includes("--help")) {
+          out2(commandHelp(name) ?? HELP());
+          return 0;
+        }
         const h = COMMANDS3[name];
         return h ? h(rest) : 1;
       }
@@ -2205,7 +2900,7 @@ main().then((code) => {
   }
   if (isApiError(err)) {
     fail2(err.message);
-    process.exitCode = err.isRefusal ? 3 : 1;
+    process.exitCode = err.isNotConnected ? 2 : err.isRefusal ? 3 : 1;
     return;
   }
   fail2(err instanceof Error ? err.message : String(err));

package/package.json

@@ -1,7 +1,28 @@
 {
   "name": "innernote",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Write LinkedIn posts in your voice, from the terminal.",
+  "keywords": [
+    "linkedin",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-agent",
+    "claude",
+    "claude-code",
+    "cursor",
+    "agent-skill",
+    "writing",
+    "content",
+    "personal-branding",
+    "ghostwriting",
+    "cli"
+  ],
+  "homepage": "https://www.innernote.space/cli",
+  "license": "UNLICENSED",
+  "bugs": {
+    "url": "https://www.innernote.space/cli"
+  },
   "type": "module",
   "bin": {
     "innernote": "dist/index.js"