chirpie 1.0.47 → 1.0.48

package/README.md

@@ -30,12 +30,13 @@ export CHIRPIE_API_KEY=chirpie_sk_...
 | Command | What it does |
 |---------|--------------|
 | `chirpie login` / `logout` / `auth` / `whoami` | Manage credentials |
-| `chirpie post <text>` | Create a post. `-a` account (repeat it for several accounts), `-m` media files or URLs, `--alt` descriptions, `--config` per-account overrides, `-s` schedule, `--draft` save without sending |
-| `chirpie thread <post> <post> ...` | Create a 2 to 25 post thread, or 1 to 25 with `--draft`. `-a` is repeatable, `--config` takes per-account posts, `-f` takes a JSON payload file |
+| `chirpie post <text>` | Create a post. `-a` account (repeat it for several accounts), `-m` media files or URLs, `--alt` descriptions, `--config` per-account overrides, `--first-comment` a comment published under the post as soon as it goes out, `-s` schedule, `--draft` save without sending |
+| `chirpie thread <post> <post> ...` | Create a 2 to 25 post thread, or 1 to 25 with `--draft`. `-a` is repeatable, `--config` takes per-account posts, `--first-comment` posts a comment under the last part, `-f` takes a JSON payload file |
 | `chirpie posts` | List posts. `--status`, `--account`, `--group`, `--limit`, `--include-hidden` |
 | `chirpie posts get <id>` | Fetch one post |
-| `chirpie posts update <id>` | Edit a post that has not published yet, or finish a draft. `--text`, `--media`, `--alt`, `--clear-media`, `--schedule-at`, `--keep-draft`. Leaving `--schedule-at` out keeps the time it already has |
+| `chirpie posts update <id>` | Edit a post that has not published yet, or finish a draft. `--text`, `--media`, `--alt`, `--clear-media`, `--first-comment` (`""` removes it), `--schedule-at`, `--keep-draft`. Leaving `--schedule-at` out keeps the time it already has |
 | `chirpie posts publish <id>` | Send a saved draft now. `-t` sets the final text first |
+| `chirpie posts first-comment <id>` | Post a first comment that failed, again. It re-sends the text the post already carries |
 | `chirpie posts delete <id>` | Take a post down from the platform. Chirpie keeps it, marked deleted. Deleting any post of a scheduled thread cancels the thread. Instagram and TikTok offer no delete API and refuse with `delete_unsupported` |
 | `chirpie posts hide <id>` / `unhide <id>` | Hide a post from your Chirpie listings, or show it again. Nothing reaches the platform |
 | `chirpie accounts` | List connected accounts, active and inactive |
@@ -70,6 +71,14 @@ chirpie thread "One" "Two" "Three" -a 550e8400-e29b-41d4-a716-446655440000
 
 # What is queued
 chirpie posts --status scheduled
+
+# Put the link in the first comment. X, Threads, Instagram and Facebook only,
+# and it counts as one post against your monthly quota.
+chirpie post "We rebuilt scheduling this week." \
+  --first-comment "Full write-up: https://example.com/blog/scheduling"
+
+# A first comment never fails its post. Send one that did not go out again.
+chirpie posts first-comment "$POST_ID"
 ```
 
 ## Drafts

package/dist/index.js

@@ -274,9 +274,9 @@ var postCommand = new Command3("post").description("Create a post").argument("<t
   "-a, --account <id>",
   "Account ID. Repeat it to publish the same post to several accounts at once (up to 25)",
   collect
-).option("-m, --media <files...>", MEDIA_OPTION_HELP).option("--alt <text...>", ALT_OPTION_HELP).option(
+).option("-m, --media <files...>", MEDIA_OPTION_HELP).option("--first-comment <text>", "Post this as a comment under the post, as soon as it goes out. X, Threads, Instagram and Facebook only. It counts as one post against your monthly quota").option("--alt <text...>", ALT_OPTION_HELP).option(
   "--config <json-or-file>",
-  'Per-account overrides as JSON, or a path to a JSON file holding them: { "<account id>": { "text": "...", "media_urls": ["..."] } }. Every key must be an account named with --account'
+  'Per-account overrides as JSON, or a path to a JSON file holding them: { "<account id>": { "text": "...", "media_urls": ["..."], "first_comment": "..." } }. Every key must be an account named with --account, and "first_comment": "" publishes that account without the first comment the call is sending'
 ).option("-s, --schedule <datetime>", "Schedule for later. Any ISO 8601 timestamp with a timezone (2026-04-01T14:00:00Z or 2026-04-01T16:00:00+02:00). Posts publish within ~5 minutes of the scheduled time.").option(
   "--draft",
   "Save without publishing. Nothing is sent, nothing counts against your quota, and any problems are listed back"
@@ -296,6 +296,7 @@ var postCommand = new Command3("post").description("Create a post").argument("<t
         account_ids: accountIds,
         text,
         ...media ? { media } : {},
+        ...opts.firstComment ? { first_comment: opts.firstComment } : {},
         ...opts.config ? {
           account_configurations: parseAccountConfigurations(
             opts.config
@@ -329,6 +330,7 @@ var postCommand = new Command3("post").description("Create a post").argument("<t
       account_id: accountIds[0],
       text,
       ...media ? { media } : {},
+      ...opts.firstComment ? { first_comment: opts.firstComment } : {},
       schedule_at: opts.schedule,
       ...opts.draft ? { draft: true } : {}
     });
@@ -366,7 +368,7 @@ function parseAltSpec(spec) {
     alts: m[2].split(",").map((a) => a.trim())
   };
 }
-var threadCommand = new Command4("thread").description("Create a thread").argument("[posts...]", "Thread posts (each argument is one post). Omit when using --file.").option(
+var threadCommand = new Command4("thread").description("Create a thread").argument("[posts...]", "Thread posts (each argument is one post). Omit when using --file.").option("--first-comment <text>", "Post this as a comment under the thread's last post, as soon as it goes out. X, Threads, Instagram and Facebook only. It counts as one post against your monthly quota").option(
   "-a, --account <id>",
   "Account ID. Repeat it to publish the same thread to several accounts at once (up to 25)",
   collect
@@ -381,7 +383,7 @@ var threadCommand = new Command4("thread").description("Create a thread").argume
   "JSON file with a full thread payload: { posts: [{ text, media_urls? }, ...], schedule_at?: string }. It may also carry account_ids and account_configurations."
 ).option(
   "--config <json-or-file>",
-  `Per-account overrides as JSON, or a path to a JSON file holding them: { "<account id>": { "posts": [{ "text": "one" }, { "text": "two" }] } }. An account's posts replace the whole thread for that account`
+  `Per-account overrides as JSON, or a path to a JSON file holding them: { "<account id>": { "posts": [{ "text": "one" }, { "text": "two" }], "first_comment": "..." } }. An account's posts replace the whole thread for that account, and "first_comment": "" publishes that account without the first comment the call is sending`
 ).option("-s, --schedule <datetime>", "Schedule for later. Any ISO 8601 timestamp with a timezone (2026-04-01T14:00:00Z or 2026-04-01T16:00:00+02:00). Threads publish within ~5 minutes of the scheduled time.").option(
   "--draft",
   "Save without publishing. Nothing is sent, nothing counts against your quota, and any problems are listed back"
@@ -459,6 +461,7 @@ var threadCommand = new Command4("thread").description("Create a thread").argume
       const result = await client.createThread({
         account_ids: accountIds,
         posts: postPayload,
+        ...opts.firstComment ? { first_comment: opts.firstComment } : {},
         ...configurations ? { account_configurations: configurations } : {},
         schedule_at: scheduleAt,
         ...opts.draft ? { draft: true } : {}
@@ -487,6 +490,7 @@ var threadCommand = new Command4("thread").description("Create a thread").argume
     const thread = await client.createThread({
       account_id: accountIds[0],
       posts: postPayload,
+      ...opts.firstComment ? { first_comment: opts.firstComment } : {},
       schedule_at: scheduleAt,
       ...opts.draft ? { draft: true } : {}
     });
@@ -584,6 +588,9 @@ postsCommand.command("update <id>").description(
 ).option("--alt <text...>", ALT_OPTION_HELP).option("--clear-media", "Remove the media from the post").option(
   "-s, --schedule-at <datetime>",
   "New publish time. Any ISO 8601 timestamp with a timezone (2027-04-01T14:00:00Z or 2027-04-01T16:00:00+02:00). Omit it to keep the time the post already has. Rescheduling one part of a thread moves the whole thread. On a draft this queues it, unless you also pass --keep-draft."
+).option(
+  "--first-comment <text>",
+  'The comment to post under this one once it publishes. Pass "" to remove the one it has'
 ).option(
   "--keep-draft",
   "Keep a draft a draft, so --schedule-at only changes the time it remembers"
@@ -592,9 +599,9 @@ postsCommand.command("update <id>").description(
     error("Pass either --media or --clear-media, not both");
     process.exit(1);
   }
-  if (!opts.text && !opts.media && !opts.clearMedia && !opts.scheduleAt && !opts.keepDraft) {
+  if (!opts.text && !opts.media && !opts.clearMedia && opts.firstComment === void 0 && !opts.scheduleAt && !opts.keepDraft) {
     error(
-      "Nothing to change. Pass --text, --media, --clear-media, --schedule-at or --keep-draft"
+      "Nothing to change. Pass --text, --media, --clear-media, --first-comment, --schedule-at or --keep-draft"
     );
     process.exit(1);
   }
@@ -605,6 +612,7 @@ postsCommand.command("update <id>").description(
       ...opts.text !== void 0 ? { text: opts.text } : {},
       ...opts.clearMedia ? { media: [] } : {},
       ...media ? { media } : {},
+      ...opts.firstComment !== void 0 ? { first_comment: opts.firstComment } : {},
       ...opts.scheduleAt ? { schedule_at: opts.scheduleAt } : {},
       ...opts.keepDraft ? { draft: true } : {}
     });
@@ -664,6 +672,22 @@ postsCommand.command("delete <id>").description(
     process.exit(1);
   }
 });
+postsCommand.command("first-comment <id>").description(
+  "Post a first comment that failed, again. Re-sends the text the post already carries"
+).option("--json", "Output raw JSON").action(async (id, opts, cmd) => {
+  const client = getClient();
+  try {
+    const post = await client.retryFirstComment(id);
+    if (wantsJson(opts, cmd)) {
+      json(post);
+    } else {
+      success(`First comment posted on ${post.id}`);
+    }
+  } catch (err) {
+    apiError(err, "Failed to post the first comment");
+    process.exit(1);
+  }
+});
 postsCommand.command("hide <id>").description(
   "Hide a post from your Chirpie listings (nothing reaches the platform)"
 ).option("--json", "Output raw JSON").action(async (id, opts, cmd) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chirpie",
-  "version": "1.0.47",
+  "version": "1.0.48",
   "description": "Chirpie CLI: post to social media from the command line",
   "repository": {
     "type": "git",
@@ -44,7 +44,7 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@chirpie/sdk": "^1.0.44",
+    "@chirpie/sdk": "^1.0.45",
     "commander": "^13"
   },
   "devDependencies": {