chirpie 1.0.30 → 1.0.32

package/README.md

@@ -0,0 +1,88 @@
+# chirpie
+
+**Post to X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook and Telegram from your terminal.** [Chirpie](https://chirpie.ai) handles the OAuth, the token refresh and the media upload, so every platform is the same command.
+
+## Install
+
+```bash
+npm install -g chirpie
+```
+
+Or run it without installing: `npx chirpie <command>`.
+
+## Authenticate
+
+```bash
+chirpie login          # opens a browser and saves a key to ~/.chirpie/config.json
+chirpie whoami         # check what you are signed in as
+```
+
+Or set a key from the [dashboard](https://chirpie.ai/dashboard/keys) in the environment:
+
+```bash
+export CHIRPIE_API_KEY=chirpie_sk_...
+```
+
+`CHIRPIE_API_KEY` takes precedence over the config file. `chirpie auth --key ...` stores one non-interactively, and `chirpie logout` removes it.
+
+## Commands
+
+| Command | What it does |
+|---------|--------------|
+| `chirpie login` / `logout` / `auth` / `whoami` | Manage credentials |
+| `chirpie post <text>` | Create a post. `-a` account, `-m` media URLs, `-s` schedule |
+| `chirpie thread <post> <post> ...` | Create a 2 to 25 post thread. `-f` takes a JSON payload file |
+| `chirpie posts` | List posts. `--status`, `--account`, `--limit` |
+| `chirpie posts get <id>` | Fetch one post |
+| `chirpie posts delete <id>` | Delete a post. Deleting any post of a scheduled thread cancels the thread |
+| `chirpie accounts` | List connected accounts, active and inactive |
+| `chirpie accounts activate <id>` / `deactivate <id>` | Choose which accounts publish. Deactivating cancels that account's scheduled posts |
+| `chirpie accounts connect-x` | Start the X OAuth flow and print the URL |
+| `chirpie accounts connect-bluesky` | Connect Bluesky with an app password |
+| `chirpie accounts connect-linkedin` / `connect-threads` / `connect-mastodon` / `connect-instagram` / `connect-facebook` | Start that platform's OAuth flow |
+| `chirpie accounts connect-telegram` | Connect a Telegram bot to a channel or group |
+| `chirpie accounts x-keys set` / `status` / `remove` | Use your own X developer app |
+| `chirpie analytics <post_id>` | Engagement metrics for a published post |
+| `chirpie keys` / `keys create` / `keys revoke <id>` | Manage API keys |
+
+Run `chirpie <command> --help` for the full option list. Pinterest, TikTok, YouTube and Google Business Profile are coming soon.
+
+## Examples
+
+```bash
+# Post now, picking the account interactively
+chirpie post "Shipped a new release."
+
+# Post with media to a specific account
+chirpie post "Look at this" -a 550e8400-e29b-41d4-a716-446655440000 -m https://example.com/a.png
+
+# Schedule. Any ISO 8601 timestamp that carries a timezone.
+chirpie post "Later" -s 2026-04-01T14:00:00Z
+
+# A thread
+chirpie thread "One" "Two" "Three" -a 550e8400-e29b-41d4-a716-446655440000
+
+# What is queued
+chirpie posts --status scheduled
+```
+
+## JSON output
+
+Every command accepts `--json` and prints the raw API response, which is what you want in a script:
+
+```bash
+chirpie accounts --json | jq -r '.[0].id'
+chirpie posts --status scheduled --json | jq length
+```
+
+Put `--json` on the command you are actually running. For a subcommand, both placements work: `chirpie accounts deactivate <id> --json` and `chirpie accounts --json deactivate <id>` are equivalent.
+
+## Documentation
+
+- [CLI reference](https://chirpie.ai/docs/cli)
+- [API reference](https://chirpie.ai/docs/api/posts)
+- [Errors](https://chirpie.ai/docs/errors)
+
+Also available: the [TypeScript SDK](https://www.npmjs.com/package/@chirpie/sdk) and the [MCP server](https://www.npmjs.com/package/@chirpie/mcp).
+
+MIT

package/dist/index.js

@@ -157,7 +157,7 @@ function getClient() {
 }
 
 // src/commands/post.ts
-var postCommand = new Command3("post").description("Create a post").argument("<text>", "Post text").option("-a, --account <id>", "Account ID").option("-m, --media <urls...>", "Media URLs. Per-platform caps: X/Bluesky/Mastodon 4, LinkedIn 4, Threads/Pinterest/YouTube/GBP 1, Instagram/Facebook/Telegram 10, TikTok up to 35 photos.").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("--json", "Output raw JSON").action(async (text, opts) => {
+var postCommand = new Command3("post").description("Create a post").argument("<text>", "Post text").option("-a, --account <id>", "Account ID").option("-m, --media <urls...>", "Media URLs. Per-platform caps: X, Bluesky, LinkedIn and Mastodon 4, Threads 1, Instagram, Facebook and Telegram 10.").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("--json", "Output raw JSON").action(async (text, opts) => {
   const client = getClient();
   let accountId = opts.account;
   if (!accountId) {
@@ -404,7 +404,7 @@ async function readSecretFromStdin(prompt) {
     stdin.on("data", onData);
   });
 }
-var accountsCommand = new Command6("accounts").description("List connected social accounts (X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook, Telegram, Pinterest, TikTok, YouTube, and Google Business Profile)").option("--json", "Output raw JSON").action(async (opts, cmd) => {
+var accountsCommand = new Command6("accounts").description("List connected social accounts (X, Bluesky, LinkedIn, Threads, Mastodon, Instagram, Facebook, and Telegram)").option("--json", "Output raw JSON").action(async (opts, cmd) => {
   const client = getClient();
   try {
     const list = await client.listAccountsWithLimits();
@@ -490,7 +490,10 @@ accountsCommand.command("connect-x").description("Connect a new X/Twitter accoun
     process.exit(1);
   }
 });
-accountsCommand.command("connect-bluesky").description("Connect a Bluesky account via app password").requiredOption("--handle <handle>", "Bluesky handle (e.g. user.bsky.social)").option("--app-password <password>", "App password (omit to enter securely via prompt)").option("--json", "Output raw JSON").action(async (opts, cmd) => {
+accountsCommand.command("connect-bluesky").description("Connect a Bluesky account via app password").requiredOption(
+  "--handle <handle>",
+  "Bluesky handle. The first part alone is enough (user), and user.bsky.social, a handle on your own domain, or the account email also work"
+).option("--app-password <password>", "App password (omit to enter securely via prompt)").option("--json", "Output raw JSON").action(async (opts, cmd) => {
   const client = getClient();
   try {
     let appPassword = opts.appPassword;
@@ -550,7 +553,10 @@ accountsCommand.command("connect-threads").description("Connect a Threads (Meta)
     process.exit(1);
   }
 });
-accountsCommand.command("connect-mastodon").description("Connect a Mastodon account via OAuth").requiredOption("--instance <url>", "Mastodon instance URL (e.g. https://mastodon.social)").option("--json", "Output raw JSON").action(async (opts, cmd) => {
+accountsCommand.command("connect-mastodon").description("Connect a Mastodon account via OAuth").requiredOption(
+  "--instance <instance>",
+  "Mastodon instance. A bare host is enough (mastodon.social), and https://mastodon.social or an @you@fosstodon.org address also work"
+).option("--json", "Output raw JSON").action(async (opts, cmd) => {
   const client = getClient();
   try {
     const result = await client.connectMastodonAccount({
@@ -609,7 +615,10 @@ accountsCommand.command("connect-facebook").description("Connect a Facebook Page
     process.exit(1);
   }
 });
-accountsCommand.command("connect-telegram").description("Connect a Telegram bot to a channel or group").option("--bot-token <token>", "Telegram bot token (omit to enter securely via prompt)").option("--chat-id <id>", "Telegram chat ID (omit to enter via prompt)").option("--json", "Output raw JSON").action(async (opts, cmd) => {
+accountsCommand.command("connect-telegram").description("Connect a Telegram bot to a channel or group").option("--bot-token <token>", "Telegram bot token (omit to enter securely via prompt)").option(
+  "--chat-id <id>",
+  "Telegram channel or group. A bare name is enough (channelname), and @channelname, a t.me link, or a numeric chat ID also work (omit to enter via prompt)"
+).option("--json", "Output raw JSON").action(async (opts, cmd) => {
   const client = getClient();
   try {
     let botToken = opts.botToken;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chirpie",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "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.27",
+    "@chirpie/sdk": "^1.0.29",
     "commander": "^13"
   },
   "devDependencies": {