innernote 0.3.2 → 0.3.4

package/README.md

@@ -100,6 +100,7 @@ from it fails the suite, so what you read here is what the binary has.
 | `week` | what is scheduled for the next seven days |
 | `queue <post-id>` | schedule a post into your next open slot |
 | `unqueue <post-id>` | pull it back out before it goes live |
+| `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,41 @@ function resolveRef(ref) {
   return /^[a-z0-9]{20,}$/.test(ref) ? { id: ref, title: ref } : null;
 }
 
-// src/commands/read.ts
-function parseFlags(args) {
+// 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: args.includes("--json"),
-    rest: args.filter((a) => !a.startsWith("--"))
+    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";
@@ -654,14 +685,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..." },
@@ -831,9 +854,10 @@ async function whileThinking(phases, run) {
 
 // src/commands/write.ts
 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"'));
@@ -853,21 +877,14 @@ async function capture(args) {
   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];
-    }
-    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");
+  const { json, rest, value, has } = parseFlags(args, ["thought", "format", "series"]);
+  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 save = has("save");
   const call = () => request("/api/content/generate", {
     method: "POST",
     body: {
@@ -934,11 +951,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.");
@@ -977,14 +994,15 @@ async function shape(args) {
   return 0;
 }
 async function queue(args) {
-  const { json, rest } = parseFlags2(args);
-  const id = rest[0];
-  if (!id) {
+  const { json, rest } = parseFlags(args);
+  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 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 +1017,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 +1044,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,7 +1076,7 @@ async function open(args) {
   return 0;
 }
 async function ask(args) {
-  const { json, rest } = parseFlags2(args);
+  const { json, rest } = parseFlags(args);
   const message = rest.join(" ").trim();
   const held = getDraft();
   if (!message) {
@@ -1112,7 +1130,7 @@ async function ask(args) {
   return 0;
 }
 async function show(args) {
-  const { json } = parseFlags2(args);
+  const { json } = parseFlags(args);
   const held = getDraft();
   if (!held?.content) {
     note("Nothing in hand.");
@@ -1150,7 +1168,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?");
@@ -1410,6 +1428,12 @@ var COMMANDS = {
     detail: "The undo for queue, while there is still time. The post returns to your drafts and nothing goes live. Once it has been published this refuses, because a live post cannot be unsent this way.",
     examples: ["innernote unqueue p17abc...", "innernote unqueue 3"]
   },
+  skill: {
+    summary: "print the agent skill, or install it for Claude Code",
+    usage: "innernote skill [--install]",
+    detail: "The playbook an agent should read before driving this CLI: the loop, the read-before-write rule, what the exit codes mean, and the one rule that protects real people. Prints to stdout so any agent can take it. --install also registers it in ~/.claude/skills so Claude Code knows it in every future session.",
+    examples: ["innernote skill", "innernote skill --install"]
+  },
   context: {
     summary: "what you post about: your pillars and your series",
     usage: "innernote context",
@@ -1419,8 +1443,8 @@ var COMMANDS = {
   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"]
+    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.",
+    examples: ["innernote drafts", "innernote queue 3", "innernote queue p17a1yk936ywnan10643efjtc58dhkah"]
   }
 };
 function commandHelp(name) {
@@ -1533,8 +1557,29 @@ function suggest(state) {
 // package.json
 var package_default = {
   name: "innernote",
-  version: "0.3.2",
+  version: "0.3.4",
   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"
@@ -1616,6 +1661,42 @@ async function home(inSession = false) {
   return 0;
 }
 
+// src/commands/skill.ts
+import { chmod as chmod2, mkdir as mkdir2, readFile as readFile2, 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";
+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");
+    } catch {}
+  }
+  return null;
+}
+async function skill(args) {
+  const install = args.includes("--install");
+  const text = await readSkill();
+  if (!text) {
+    fail("The skill file is missing from this install.");
+    note(dim2("Reinstall with `npm i -g innernote`, or read it on any machine with the package."));
+    return 1;
+  }
+  if (install) {
+    const dir = join2(homedir2(), ".claude", "skills", "innernote-cli");
+    await mkdir2(dir, { recursive: true });
+    const target = join2(dir, "SKILL.md");
+    await writeFile2(target, text);
+    await chmod2(target, 420);
+    ok(`Installed for Claude Code at ${target}`);
+    note(dim2("It loads in future sessions on its own. Here it is for this one:"));
+    note("");
+  }
+  out(text);
+  return 0;
+}
+
 // src/session.ts
 import { createInterface } from "node:readline";
 
@@ -1761,6 +1842,12 @@ var COMMANDS2 = {
     detail: "The undo for queue, while there is still time. The post returns to your drafts and nothing goes live. Once it has been published this refuses, because a live post cannot be unsent this way.",
     examples: ["innernote unqueue p17abc...", "innernote unqueue 3"]
   },
+  skill: {
+    summary: "print the agent skill, or install it for Claude Code",
+    usage: "innernote skill [--install]",
+    detail: "The playbook an agent should read before driving this CLI: the loop, the read-before-write rule, what the exit codes mean, and the one rule that protects real people. Prints to stdout so any agent can take it. --install also registers it in ~/.claude/skills so Claude Code knows it in every future session.",
+    examples: ["innernote skill", "innernote skill --install"]
+  },
   context: {
     summary: "what you post about: your pillars and your series",
     usage: "innernote context",
@@ -1770,8 +1857,8 @@ var COMMANDS2 = {
   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"]
+    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.",
+    examples: ["innernote drafts", "innernote queue 3", "innernote queue p17a1yk936ywnan10643efjtc58dhkah"]
   }
 };
 function commandHelp2(name) {
@@ -2029,7 +2116,7 @@ function whatThereIs() {
     ["Writing", ["write", "shape", "ask", "save", "capture"]],
     ["Looking", ["show", "ideas", "drafts", "open", "week", "context", "whoami"]],
     ["Shipping", ["queue", "unqueue"]],
-    ["Connection", ["login", "logout"]]
+    ["Connection", ["login", "logout", "skill"]]
   ];
   for (const [title, cmds] of groups) {
     lines.push(`  ${bold2(title)}`);
@@ -2055,7 +2142,7 @@ var VERSION2 = package_default.version;
 // src/index.ts
 function commandList() {
   const groups = [
-    ["Getting connected", ["login", "logout", "whoami"]],
+    ["Getting connected", ["login", "logout", "whoami", "skill"]],
     ["Writing", ["write", "shape", "ask", "save", "capture"]],
     ["Looking", ["show", "ideas", "drafts", "open", "week", "context"]],
     ["Shipping", ["queue", "unqueue"]]
@@ -2084,6 +2171,7 @@ var HELP = () => [
 `);
 var COMMANDS3 = {
   context,
+  skill,
   login,
   logout: () => logout(),
   whoami,
@@ -2156,7 +2244,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.2",
+  "version": "0.3.4",
   "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"