superx-cli 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,9 +1,13 @@
 # Changelog
 
-## Unreleased (joins 0.1.0)
+## 0.2.0 (2026-08-01)
 
+- Advanced post settings: `scheduled:create`/`scheduled:update` gain `--auto-retweet <h>` / `--auto-retweet-remove <h>` (1-12), `--auto-delete <h>` / `--auto-delete-threshold <views>`, `--auto-plug <templateId>` / `--auto-plug-threshold <likes>`, `--super-followers`, plus `--no-*` disable forms; new `plug-templates:list` command. BEHAVIOR CHANGE: posts created via the API now inherit the account's Default Post Settings (auto retweet, auto delete, auto plug, auto DM, Super Followers only) when the matching flags are omitted, exactly like posts composed in the app; previously API posts got no advanced settings at all. Auto DM stays inherit-only (no flag) and surfaces `auto_dm_skipped: true` when a plan limit strips it
 - Media: `media:upload <file>` uploads a local image (JPG/PNG/WEBP 5MB, GIF 15MB) and prints its `object_key`; `scheduled:create`/`scheduled:update` gain `--media` (comma list of keys), `--alt-text` (single key), and `--parts-json` for threads with per-part media. Text replacement on update is a full replace, media included
 - Signal agent writes: `signals:create-agent` (--name, --icp, repeatable --keyword, --precision, --list-id, --idempotency-key with replay detection), `signals:pause-agent <id>`, `signals:resume-agent <id>`, `signals:delete-agent <id>`
+- Context settings: `context:get` (the account's AI writing background: profile description, interests, SuperX rules, reply settings, favorite creators, style guide, products), `context:set` (present flags only change; `""` clears a string; `--interests`/`--favorite-creators` comma lists fully replace; boolean flags support `--no-*`), `context:products`, `context:products:set` (upsert by `--url` or edit by `--id`), `context:products:delete <id>`
+- Queue settings: `queue:get` (the account's posting schedule: predefined time slots and their timezone) and `queue:set` (`--slots-json` full replace, max 50, 0 = Sunday, `'[]'` clears; `--timezone` IANA name). Changing the slots also re-flows queued posts onto them the way the app does, reported as `reflow: { moved, skipped, bailed }`; a timezone-only change never moves posts
+- Shared accounts: `accounts` now lists accounts shared with you (manual and team shares) alongside your own, each with `shared` and `permission`. `--account` accepts them everywhere, and `context:*` / `queue:set` can write to them. A share with Editor permission can change queue settings but gets 403 `editor_restricted` on context writes
 
 ## 0.1.0 (2026-07-06)
 

package/PLAYBOOK.md

@@ -34,7 +34,7 @@ A good post can go from a handful of follower likes to thousands of stranger vie
 - Reply early under larger accounts in the niche with something additive (a fact, a sharp take, a smart follow-up). Never "great post" filler.
 - Time the first window: schedule the best post of the day for when the audience is active, then protect the first 30 to 60 minutes by replying to every response fast. Early engagement compounds.
 
-Actions: `superx scheduled:create --at` for peak-time scheduling; `superx replies:list` to confirm the account is actually participating in conversations, not just broadcasting.
+Actions: `superx scheduled:create --at` for peak-time scheduling; `superx queue:get` to see the account's standing posting slots and `superx queue:set --slots-json ...` to move that cadence onto the hours the audience is actually awake (queued posts follow the slots automatically); `superx replies:list` to confirm the account is actually participating in conversations, not just broadcasting.
 
 ## 4. The engagement loop (3-3-3)
 
@@ -61,10 +61,11 @@ Data: `superx posts:list --sort likes --since <60d ago>` and `--sort impressions
 
 A sustainable weekly loop an agent can run:
 
-1. Confirm the 1-2 topic clusters for the week; every post should fit one.
+1. Confirm the 1-2 topic clusters for the week; every post should fit one. `superx context:get` shows the account's stated interests, hard rules, profile description, and products: drafts must respect the rules and fit the interests. If the user's focus has shifted, update it (`superx context:set --interests ...`) so every AI surface in the app follows, and get confirmation first: these settings shape ALL future AI output for the account.
 2. Pull last week's winners (`posts:list --sort likes --since ...`) and note why each worked.
 3. Plan roughly 7 posts for the week; draft them (`scheduled:create` without `--at`, with a `--title` naming the angle and a `--tag` for the week's cluster so the human can scan the batch), review, then promote the best 3 to peak times (`scheduled:update <id> --at ... --status scheduled`).
 4. Include one format experiment per week (a thread via `--part`, a longer post, or a long-form X Article via `articles:create` when a topic deserves depth: draft it, add a cover with `articles:cover`, and let the human review before `articles:publish`) so format reach is never left untested.
+   For the week's strongest post, consider the advanced settings: `--auto-retweet 6` gives it a second push into a different timezone window, and `--auto-plug <template-id> --auto-plug-threshold 50` (ids from `plug-templates:list`) turns a winner into a lead-in for the account's offer. Posts inherit the account's Default Post Settings automatically when the flags are omitted; use `--no-auto-retweet`/`--no-auto-plug` on posts where the defaults do not fit (see SKILL.md for the full flag set).
 5. Refresh the 3-3-3 circle (`contacts:list`) and do the daily reply blocks.
 6. End of week: `posts:analytics` for the trend, top 3 posts by meaningful actions, one failure mode to fix with a rule (for example "no link-drop posts", "never ghost early replies").
 7. Repurpose one winner into two new assets for next week (tighter version, thread expansion, follow-up take).

package/README.md

@@ -6,7 +6,7 @@ npx skills add superx-so/superx-agent
 
 # SuperX CLI
 
-**Twitter/X growth CLI for developers and AI agents.** Read your posts and their metrics, pull account analytics, find the people who engage with you most, create draft or scheduled posts and threads (with image attachments), and write, schedule, and publish long-form X Articles (with AI cover generation) through the [SuperX API](https://docs.superx.so).
+**Twitter/X growth CLI for developers and AI agents.** Read your posts and their metrics, pull account analytics, find the people who engage with you most, create draft or scheduled posts and threads (with image attachments), write, schedule, and publish long-form X Articles (with AI cover generation), and read or update the Context settings that steer SuperX's AI writing through the [SuperX API](https://docs.superx.so).
 
 Two things ship in this repo:
 
@@ -27,7 +27,7 @@ Requires Node.js 18 or newer.
 
 ## Authentication
 
-Create an API key in the SuperX app: [app.superx.so/account?tab=developers](https://app.superx.so/account?tab=developers)
+Create an API key in the SuperX app: [app.superx.so/account?tab=api](https://app.superx.so/account?tab=api)
 
 ### Option 1: Guided login (local use)
 
@@ -80,7 +80,7 @@ superx me         # Key owner, plan tier, key name and scopes
 superx accounts   # X accounts this key can read (main account first)
 ```
 
-Read commands accept `--account <id>` (an id from `superx accounts`) to select a linked account. Omitting it means the main account.
+Read commands accept `--account <id>` (an id from `superx accounts`) to select a linked or shared account. Omitting it means the main account.
 
 ### Posts
 
@@ -220,6 +220,22 @@ A new `--at` time alone never schedules a draft; pass `--status scheduled` expli
 
 Write constraints in the current API version: main account only; images via `media:upload` (no video); one of `--text`, `--part`, or `--parts-json`. Idempotent replays add `"replayed": true` to the output. Note that drafts have no scheduled time, so `--from/--to` filters exclude them.
 
+### Advanced settings
+
+Auto retweet, auto delete, auto plug, and Super Followers only are available as flags on `scheduled:create` and `scheduled:update`.
+
+```bash
+superx scheduled:create --text "Post" --at "2026-08-01T15:00:00Z" --auto-retweet 6 --auto-retweet-remove 4
+superx scheduled:create --text "Post" --at "2026-08-01T15:00:00Z" --auto-delete 8 --auto-delete-threshold 500
+superx plug-templates:list                                   # template ids for --auto-plug
+superx scheduled:create --text "Post" --at "2026-08-01T15:00:00Z" --auto-plug <template-id> --auto-plug-threshold 50
+superx scheduled:create --text "Post" --at "2026-08-01T15:00:00Z" --no-auto-retweet --no-auto-plug
+superx scheduled:update <post-id> --auto-retweet 2           # override on an existing post
+superx scheduled:update <post-id> --no-auto-delete           # remove from an existing post
+```
+
+On create, flags you omit inherit your Default Post Settings from the SuperX app (exactly five settings inherit: auto retweet, auto delete, auto plug, auto DM, Super Followers only; other composer defaults like Bluesky cross-posting never apply to API posts); the `--no-*` forms turn a setting off for that post. On update there is no inheritance: passed flags override, omitted flags keep the post's current settings, `--no-*` removes them. Hours are 1-12; `--auto-plug` needs `--auto-plug-threshold` (likes). Auto DM has no flag and always follows your app defaults; if a plan limit strips it at create time the response carries `"auto_dm_skipped": true`. `scheduled:list` shows the applied settings per post.
+
 ### Tags
 
 ```bash
@@ -231,6 +247,46 @@ superx tags:delete <tag-id>                      # also removes it from every po
 
 Tag names are unique (409 `duplicate_name` on collision) and capped at 40 characters.
 
+### Context settings (AI writing background)
+
+The Context settings are the background SuperX's AI uses when writing for the account: profile description, interests, hard rules, reply settings, favorite creators, style-guide overrides, and products. Editing them changes every AI writing surface in the app.
+
+```bash
+superx context:get                                  # the whole context document
+
+# Only the flags you pass change; "" clears a string; lists fully replace
+superx context:set --rules "Never use hashtags. Keep posts under 200 chars."
+superx context:set --profile-description "Indie hacker building SuperX" --profile-description-enabled
+superx context:set --interests "indie hacking,SaaS,AI agents"       # replaces the list
+superx context:set --favorite-creators "levelsio,marc_louvion"      # max 3, replaces the list
+superx context:set --reply-rules "Be helpful, never salesy" --no-reply-author-name
+superx context:set --style-audience "Bootstrapped SaaS founders"    # outranks the generated guide
+superx context:set --style-audience ""                              # revert to the generated guide
+
+# Products (max 5): mentioned naturally in generated content
+superx context:products
+superx context:products:set --url "https://superx.so" --name "SuperX" --description "X growth platform"
+superx context:products:set --id 3 --updates "Shipped the public API"
+superx context:products:delete <product-id>
+```
+
+Caps: profile description, rules, and reply rules 500 characters; style audience 600; style vocabulary 1000; 30 interests of 50 characters each; 3 favorite creators; 5 products. `context:get` also returns the read-only generated style guide (`style_guide.generated`). `context:products:set --url` creates the product when it does not exist; removing a product is reversible by re-adding the same url. Writes need a key with the write scope, work on any linked or shared account via `--account`, and return 403 `editor_restricted` on a share with Editor permission.
+
+### Queue settings (posting schedule)
+
+The posting schedule is the set of predefined time slots the queue fills, plus the timezone they run in: the Edit Queue modal in the app.
+
+```bash
+superx queue:get                                     # slots, timezone, and the is_default flags
+
+# Slots are JSON so weekday sets stay unambiguous; 0 = Sunday
+superx queue:set --slots-json '[{"time":"09:00","days":[1,2,3,4,5]},{"time":"17:30","days":[1,3,5]}]'
+superx queue:set --timezone "Europe/London"          # never moves queued posts
+superx queue:set --slots-json '[]'                   # clear every predefined slot
+```
+
+Slots are a full replace, max 50, one entry per unique time. Changing them also re-flows the queue the way the app does: a queued post sitting exactly on an old slot moves to the matching new slot, so gaps are preserved and hand-picked custom times stay put. The response carries `reflow: { moved, skipped, bailed }`; `bailed: true` means the settings were saved but the queue was left untouched on purpose, and rerunning the same command is safe. Changing the timezone and the slots in one call usually moves nothing, because the existing posts were placed under the old timezone; to re-flow them, change the timezone first, then send the slots in a second call. Writes need a key with the write scope and work on any linked or shared account via `--account`, Editor-permission shares included.
+
 ### Articles (long-form X posts)
 
 Article bodies are **markdown in both directions**: headings (h1-h3), bullet and numbered lists (one nesting level), blockquotes, bold/italic/strikethrough, links, images by URL, and bare X post URLs as embeds. Code blocks and horizontal rules are not supported by the X Articles format and degrade to plain text (the response lists any degradations in `warnings`).
@@ -342,6 +398,12 @@ The CLI talks to these SuperX API endpoints (base `https://api.superx.so/v1`):
 | `/articles/:id/schedule` | POST | `articles:schedule <id>` |
 | `/articles/:id/unschedule` | POST | `articles:unschedule <id>` |
 | `/articles/:id/cover` | POST | `articles:cover <id>` |
+| `/context` | GET | `context:get`, `context:products` |
+| `/context` | PATCH | `context:set` |
+| `/context/products/:id` | PATCH | `context:products:set` |
+| `/context/products/:id` | DELETE | `context:products:delete <id>` |
+| `/queue-settings` | GET | `queue:get` |
+| `/queue-settings` | PATCH | `queue:set` |
 | `/docs` | GET | `docs` (no auth) |
 
 Full API reference: [docs.superx.so](https://docs.superx.so)
@@ -367,7 +429,8 @@ Exit code `0` = success, `1` = error. Error codes come straight from the API:
 |------|---------|
 | `invalid_api_key` (401) | Bad or revoked key; run `superx login` again |
 | `insufficient_scope` (403) | Read-only key used for a write |
-| `writes_main_account_only` (403) | `scheduled:create` with a linked account |
+| `writes_main_account_only` (403) | `scheduled:create` with a linked or shared account |
+| `editor_restricted` (403) | `context:set` or `context:products:*` on a share with Editor permission |
 | `subscription_required` (403) | SuperX subscription lapsed |
 | `account_not_found` (404) | `--account` id is not one of your accounts |
 | `list_not_found` (404) | List id is not one of your contact lists |
@@ -416,6 +479,8 @@ src/
     ├── media.ts      # media:upload
     ├── scheduled.ts  # scheduled:list / scheduled:create / scheduled:update / scheduled:delete
     ├── tags.ts       # tags:list / tags:create / tags:update / tags:delete
+    ├── context.ts    # context:get / context:set / context:products / context:products:set / context:products:delete
+    ├── queue.ts      # queue:get / queue:set
     ├── articles.ts   # articles:list/get/create/update/delete/publish/schedule/unschedule/cover
     └── docs.ts       # docs
 ```
@@ -478,6 +543,19 @@ superx tags:create "Launch week" --color amber
 superx tags:update <id> --name "Launch"
 superx tags:delete <id>
 
+# Context settings (AI writing background)
+superx context:get
+superx context:set --rules "Never use hashtags."
+superx context:set --interests "indie hacking,SaaS"   # replaces the list
+superx context:products
+superx context:products:set --url "https://superx.so" --name "SuperX"
+superx context:products:delete <id>
+
+# Queue settings (posting schedule; 0 = Sunday)
+superx queue:get
+superx queue:set --slots-json '[{"time":"09:00","days":[1,3,5]}]'   # replaces the slots
+superx queue:set --timezone "Europe/London"                          # never moves posts
+
 # Articles (markdown bodies; publish needs X Premium)
 superx articles:create --title "My article" --file draft.md
 superx articles:list --status draft

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: superx
-description: SuperX is a Twitter/X growth tool. Use it to read an account's published posts with engagement metrics, pull account analytics (impressions, likes, replies, follower change), find the people who engage with the account most, review reply history in both directions (sent and received), manage contact lists, create and manage signal agents (automated lead finders) and review the leads they discover, search a library of 50M+ high-performing posts for inspiration, create, edit, tag, or schedule draft posts and threads (with image attachments), and write, schedule, publish, and generate AI covers for long-form X Articles through the SuperX API.
+description: SuperX is a Twitter/X growth tool. Use it to read an account's published posts with engagement metrics, pull account analytics (impressions, likes, replies, follower change), find the people who engage with the account most, review reply history in both directions (sent and received), manage contact lists, create and manage signal agents (automated lead finders) and review the leads they discover, search a library of 50M+ high-performing posts for inspiration, create, edit, tag, or schedule draft posts and threads (with image attachments), write, schedule, publish, and generate AI covers for long-form X Articles, and read or update the account's Context settings (profile description, interests, SuperX rules, reply settings, favorite creators, style guide, products) that steer SuperX's AI writing, all through the SuperX API.
 homepage: https://docs.superx.so
 metadata: {"openclaw":{"emoji":"🚀","requires":{"bins":["superx"],"env":[]}}}
 ---
@@ -21,14 +21,14 @@ official website: https://superx.so
 | Property | Value |
 |----------|-------|
 | **name** | superx |
-| **description** | Twitter/X growth CLI: posts, analytics, contacts, contact lists, audience replies, signal agents and their leads, inspiration, tags, scheduling (with images), and long-form Articles via the SuperX API |
+| **description** | Twitter/X growth CLI: posts, analytics, contacts, contact lists, audience replies, signal agents and their leads, inspiration, tags, scheduling (with images), long-form Articles, and Context settings (AI writing background) via the SuperX API |
 | **allowed-tools** | Bash(superx:*) |
 
 ---
 
 ## Three Hard Rules (Read First)
 
-**Rule 1: Run `superx status` before anything else.** Every other command fails without valid credentials. If the `superx` binary is missing, install it with `npm install -g superx-cli`. If not authenticated, either run `superx login` (interactive) or set `export SUPERX_API_KEY=sxk_...` (CI and non-interactive sessions). Keys are created at https://app.superx.so/account?tab=developers.
+**Rule 1: Run `superx status` before anything else.** Every other command fails without valid credentials. If the `superx` binary is missing, install it with `npm install -g superx-cli`. If not authenticated, either run `superx login` (interactive) or set `export SUPERX_API_KEY=sxk_...` (CI and non-interactive sessions). Keys are created at https://app.superx.so/account?tab=api.
 
 **Rule 2: Read PLAYBOOK.md before creating any content.** This repo ships a growth strategy guide (`PLAYBOOK.md`, also inside the installed npm package). It tells you WHAT to post, WHEN, and WHY: the action hierarchy, out-of-network discovery, the engagement loop, and the failure modes that kill reach. The CLI gives you data and actions; the playbook gives you judgment. Do not schedule content without it.
 
@@ -103,7 +103,7 @@ superx me         # Key owner, plan tier, key name and scopes
 superx accounts   # X accounts this key can read; use ids with --account
 ```
 
-Reads accept `--account <id>` to select a linked account. Omitting it means the main account.
+Reads accept `--account <id>` to select a linked or shared account. Omitting it means the main account.
 
 ### Posts and analytics
 
@@ -244,6 +244,37 @@ superx scheduled:update <post-id> --clear-tags --clear-title --clear-scratchpad
 - A new `--at` alone never schedules a draft. Promotion is always explicit via `--status scheduled` (which needs a future time, provided or already set).
 - CAUTION: replacement text is a FULL replace, media included. `--text` without `--media` REMOVES any images the post carried; re-list the current `object_key`s (visible in `scheduled:list`) to keep them. Title, scratchpad, tag, and time edits never touch media.
 
+### Advanced settings (auto retweet, auto delete, auto plug, super followers)
+
+```bash
+# Explicit values on create
+superx scheduled:create --text "Post" --at "2026-08-01T15:00:00Z" \
+  --auto-retweet 6 --auto-retweet-remove 4
+
+# Auto plug: reply with a template once the post hits a likes threshold
+superx plug-templates:list                        # id, text, has_media
+superx scheduled:create --text "Post" --at "2026-08-01T15:00:00Z" \
+  --auto-plug <template-id> --auto-plug-threshold 50
+
+# Auto delete underperformers (delete after 8h if under 500 views)
+superx scheduled:create --text "Post" --at "2026-08-01T15:00:00Z" \
+  --auto-delete 8 --auto-delete-threshold 500
+
+# Turn the user's defaults OFF for one post
+superx scheduled:create --text "Post" --at "2026-08-01T15:00:00Z" \
+  --no-auto-retweet --no-auto-plug
+
+# Edit or remove on an existing post (no inheritance on update)
+superx scheduled:update <post-id> --auto-retweet 2
+superx scheduled:update <post-id> --no-auto-delete
+```
+
+- On `scheduled:create`, flags you OMIT inherit the user's Default Post Settings from the SuperX app; that is the expected behavior, not a bug. Exactly five settings inherit (auto retweet, auto delete, auto plug, auto DM, Super Followers only); other composer defaults like Bluesky cross-posting never apply to API posts. Use the `--no-*` forms to turn a default off for one post.
+- On `scheduled:update` there is no inheritance: passed flags override, omitted flags keep the post's current settings, `--no-*` removes them.
+- Hours are 1-12. `--auto-plug` needs `--auto-plug-threshold` (likes); template ids come from `plug-templates:list`, unknown ids fail with `unknown_plug_template`. `--super-followers` / `--no-super-followers` toggle Super Followers only.
+- Auto DM has no flag: it always follows the user's app defaults. If a plan limit strips it at create time, the response carries `"auto_dm_skipped": true`; relay that to the user instead of ignoring it.
+- `scheduled:list` shows the applied settings per post (`auto_retweet`, `auto_delete`, `auto_plug`, `auto_dm`, `super_followers_only`), so you can verify what a post will actually do.
+
 ### Tags
 
 ```bash
@@ -255,6 +286,56 @@ superx tags:delete <tag-id>                      # also removes it from every po
 
 Tag names are unique per workspace (409 `duplicate_name`) and capped at 40 characters. Assign tags with `scheduled:create --tag` or `scheduled:update --tag`.
 
+### Context settings (AI writing background)
+
+The Context settings are the background SuperX's AI uses when writing for the account: who the user is, what they post about, hard rules, whose style they admire, and what products they sell. Editing them changes every AI writing surface in the app.
+
+```bash
+superx context:get                        # The whole context document
+superx context:get | jq '.data.rules'     # One section
+
+# Only the flags you pass change; "" clears a string; lists fully replace
+superx context:set --rules "Never use hashtags. Keep posts under 200 chars."
+superx context:set --profile-description "Indie hacker building SuperX" --profile-description-enabled
+superx context:set --interests "indie hacking,SaaS,AI agents"          # replaces the list
+superx context:set --favorite-creators "levelsio,marc_louvion"         # max 3, replaces the list
+superx context:set --reply-rules "Be helpful, never salesy" --no-reply-author-name
+superx context:set --style-audience "Bootstrapped SaaS founders"       # outranks the generated guide
+superx context:set --style-audience ""                                 # revert to the generated guide
+
+# Products (max 5): mentioned naturally in generated content
+superx context:products
+superx context:products:set --url "https://superx.so" --name "SuperX" --description "X growth platform"
+superx context:products:set --id 3 --updates "Shipped the public API"
+superx context:products:delete <product-id>
+```
+
+- What each setting affects: `--profile-description` grounds the AI's voice and personalizes the daily content mix and search; `--rules` are mandatory instructions on EVERY AI surface; `--reply-rules` and `--reply-author-name` steer generated replies; `--favorite-creators` (X usernames, max 3) inspire the writing style; `--interests` are the highest-priority topics for content suggestions; `--style-audience`/`--style-vocabulary` outrank the app's generated style guide until cleared.
+- `context:get` also returns the read-only generated style guide (`style_guide.generated`) so you can see what a cleared override falls back to.
+- Caps: profile description 500, rules 500, reply rules 500, style audience 600, style vocabulary 1000 characters; 30 interests of 50 characters each; 3 favorite creators; 5 products.
+- `context:products:set --url` creates the product when it does not exist. Removing a product is reversible: re-adding the same url restores its scraped details.
+- Writes need a key with the write scope. Unlike scheduling, context writes work on ANY linked or shared account via `--account` (they are per-account settings). On a share with Editor permission they return 403 `editor_restricted`: only the account owner can change these. These settings shape ALL future AI output for the account; confirm with the user before changing rules or the profile description.
+
+### Queue settings (posting schedule)
+
+The posting schedule is the set of predefined time slots the queue fills, plus the timezone they run in.
+
+```bash
+superx queue:get                                       # slots, timezone, is_default flags
+
+# Slots are JSON so weekday sets stay unambiguous; 0 = Sunday
+superx queue:set --slots-json '[{"time":"09:00","days":[1,2,3,4,5]},{"time":"17:30","days":[1,3,5]}]'
+superx queue:set --timezone "Europe/London"            # never moves queued posts
+superx queue:set --slots-json '[]'                     # clear every predefined slot
+```
+
+- `--slots-json` is a FULL REPLACE: max 50 entries, one per unique time, each with at least one weekday. Send the complete set the user should end up with.
+- Changing the slots also re-flows the queue the way the app does: a queued post sitting exactly on an old slot moves to the matching new slot (Nth old occurrence to Nth new occurrence), so gaps are preserved and hand-picked custom times stay put. Read `reflow.moved` in the response to see how many posts moved.
+- `reflow.bailed: true` means the settings were saved but the queue was deliberately left alone (a post had nowhere to land, or the move set was too large). Rerunning the same command is safe.
+- A timezone-only change never moves posts. Changing the timezone and the slots in one call usually moves nothing, because the existing posts were placed under the old timezone; to re-flow them, change the timezone first, then send the slots in a second call.
+- `slots_are_default` / `timezone_is_default` mark values the account has never set; SuperX is using its own default.
+- Writes need a key with the write scope and work on any linked or shared account via `--account`, Editor-permission shares included (running the queue is exactly what a delegate is there for).
+
 ### Articles (long-form X posts)
 
 Article bodies are markdown in BOTH directions: headings (h1-h3), bullet and numbered lists (one nesting level), blockquotes, bold/italic/strikethrough, links, images by URL, and bare X post URLs alone on a line as embeds. Code blocks and `---` rules degrade to plain text; the response lists degradations in `warnings`.
@@ -365,7 +446,7 @@ superx scheduled:list --status scheduled
 1. **Naive timestamps are rejected (400)**. Always include `Z` or an offset: `2026-08-01T15:00:00Z`, not `2026-08-01T15:00:00`.
 2. **Schedule window**: `--at` must be at least 60 seconds in the future and within 18 months.
 3. **Read-only keys cannot write**: `scheduled:create`/`scheduled:delete` with a read-only key returns 403 `insufficient_scope`. Check `superx me` for the key's scopes.
-4. **Writes are main-account-only**: passing a linked account to `scheduled:create` returns 403 `writes_main_account_only`. Reads accept any owned account.
+4. **Writes are main-account-only**: passing a linked or shared account to `scheduled:create` returns 403 `writes_main_account_only`. Reads accept any account `superx accounts` lists. The exceptions are `context:*` and `queue:set`, which are per-account settings.
 5. **Images need an upload first**: `--media` takes `object_key`s from `media:upload`, never file paths or URLs. Unknown keys return 400 `invalid_media`; a presign whose bytes were never PUT returns 400 `media_not_uploaded`. Video is not supported.
 6. **Size caps**: max 25 thread parts, 25,000 characters total.
 7. **Rate limited (429)**: `rate_limited` on stderr with a retry delay. Back off; do not hammer.
@@ -387,6 +468,9 @@ superx scheduled:list --status scheduled
 23. **Signal agents find leads asynchronously**: `signals:create-agent` returns the created agent, not leads. Leads land over the following minutes and days; read them with `signals:leads`.
 24. **Plan caps on agents return 403 `cap_reached`**: the plan allows only so many agents (and keyword signals per agent). Pause/delete an existing agent or ask the account owner to upgrade.
 25. **Agent creation is composite**: with an auto-created list, a mid-failure can leave an empty `Leads: ...` contact list behind (visible in `lists:list`, deletable in the app). The agent itself is never left without signals.
+26. **`context:set` list flags REPLACE the stored list**: `--interests` and `--favorite-creators` overwrite what is there; include every value the user should keep. `""` on a string flag clears it (style-guide overrides then revert to the generated guide). These settings steer all future AI output; confirm with the user before changing them.
+27. **`queue:set --slots-json` REPLACES the whole schedule** and re-flows queued posts onto the new slots. Read the current slots with `queue:get` first and send the full set. `'[]'` clears every slot and leaves the queue all-custom. `reflow.bailed: true` means the settings saved but no post moved.
+28. **`editor_restricted` (403)**: the account is shared with the key owner with Editor permission. Editors can change queue settings but not context settings. Only the account owner can.
 
 ---
 
@@ -459,6 +543,19 @@ superx articles:publish <id>
 superx articles:cover <id> --style "minimal"
 superx articles:delete <id>
 
+# Context settings (AI writing background)
+superx context:get
+superx context:set --rules "Never use hashtags."
+superx context:set --interests "indie hacking,SaaS"   # replaces the list
+superx context:products
+superx context:products:set --url "https://superx.so" --name "SuperX"
+superx context:products:delete <id>
+
+# Queue settings (posting schedule; 0 = Sunday)
+superx queue:get
+superx queue:set --slots-json '[{"time":"09:00","days":[1,3,5]}]'   # replaces the slots
+superx queue:set --timezone "Europe/London"                          # never moves posts
+
 # Docs and help
 superx docs                                       # API quickstart (markdown)
 superx --help                                     # All commands

package/dist/index.js

@@ -200,6 +200,30 @@ var SuperXAPI = class {
   async deleteScheduled(id) {
     return (await this.request(`/scheduled-posts/${encodeURIComponent(id)}`, { method: "DELETE" })).json;
   }
+  // --- Plug templates ---
+  async listPlugTemplates(query = {}) {
+    return (await this.request("/plug-templates", { query })).json;
+  }
+  // --- Context settings ---
+  async getContext(query = {}) {
+    return (await this.request("/context", { query })).json;
+  }
+  async updateContext(body) {
+    return (await this.request("/context", { method: "PATCH", body })).json;
+  }
+  async updateContextProduct(idOrUrl, body) {
+    return (await this.request(`/context/products/${encodeURIComponent(idOrUrl)}`, { method: "PATCH", body })).json;
+  }
+  async deleteContextProduct(id, query = {}) {
+    return (await this.request(`/context/products/${encodeURIComponent(id)}`, { method: "DELETE", query })).json;
+  }
+  // --- Queue settings ---
+  async getQueueSettings(query = {}) {
+    return (await this.request("/queue-settings", { query })).json;
+  }
+  async updateQueueSettings(body) {
+    return (await this.request("/queue-settings", { method: "PATCH", body })).json;
+  }
   // --- Media ---
   async createMediaUpload(body) {
     return (await this.request("/media", { method: "POST", body })).json;
@@ -324,7 +348,7 @@ function getConfig() {
   process.stderr.write("Not authenticated. Either:\n");
   process.stderr.write("  1. Run: superx login\n");
   process.stderr.write("  2. Or set: export SUPERX_API_KEY=sxk_...\n");
-  process.stderr.write("Create an API key at https://app.superx.so/account?tab=developers\n");
+  process.stderr.write("Create an API key at https://app.superx.so/account?tab=api\n");
   process.exit(1);
 }
 
@@ -347,7 +371,7 @@ async function login(argv) {
   let key = (argv.key || "").trim();
   if (!key) {
     note("Create or copy an API key at:");
-    note("  https://app.superx.so/account?tab=developers");
+    note("  https://app.superx.so/account?tab=api");
     note("");
     key = await promptForKey();
   }
@@ -628,6 +652,80 @@ function parsePartsJson(raw) {
   }
   return parsed;
 }
+function numericFlag(name, value) {
+  if (value === void 0 || value === false) return value;
+  if (value === true) {
+    note(`--${name} needs a numeric value.`);
+    process.exit(1);
+  }
+  const n = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(n)) {
+    note(`--${name} must be a number.`);
+    process.exit(1);
+  }
+  return n;
+}
+function applyAdvancedFlags(argv, body) {
+  const retweet = numericFlag("auto-retweet", argv["auto-retweet"]);
+  const retweetRemove = numericFlag("auto-retweet-remove", argv["auto-retweet-remove"]);
+  if (retweet === false) {
+    if (typeof retweetRemove === "number") {
+      note("--auto-retweet-remove cannot be combined with --no-auto-retweet.");
+      process.exit(1);
+    }
+    body.auto_retweet = null;
+  } else if (typeof retweet === "number") {
+    body.auto_retweet = {
+      after_hours: retweet,
+      ...typeof retweetRemove === "number" ? { remove_after_hours: retweetRemove } : {}
+    };
+  } else if (typeof retweetRemove === "number") {
+    note("--auto-retweet-remove requires --auto-retweet <hours>.");
+    process.exit(1);
+  }
+  const del = numericFlag("auto-delete", argv["auto-delete"]);
+  const delThreshold = numericFlag("auto-delete-threshold", argv["auto-delete-threshold"]);
+  if (del === false) {
+    if (typeof delThreshold === "number") {
+      note("--auto-delete-threshold cannot be combined with --no-auto-delete.");
+      process.exit(1);
+    }
+    body.auto_delete = null;
+  } else if (typeof del === "number") {
+    body.auto_delete = {
+      after_hours: del,
+      ...typeof delThreshold === "number" ? { threshold: delThreshold } : {}
+    };
+  } else if (typeof delThreshold === "number") {
+    note("--auto-delete-threshold requires --auto-delete <hours>.");
+    process.exit(1);
+  }
+  const plug = argv["auto-plug"];
+  const plugThreshold = numericFlag("auto-plug-threshold", argv["auto-plug-threshold"]);
+  if (plug === false) {
+    if (typeof plugThreshold === "number") {
+      note("--auto-plug-threshold cannot be combined with --no-auto-plug.");
+      process.exit(1);
+    }
+    body.auto_plug = null;
+  } else if (typeof plug === "string" && plug.length > 0) {
+    if (typeof plugThreshold !== "number") {
+      note("--auto-plug requires --auto-plug-threshold <likes>.");
+      process.exit(1);
+    }
+    body.auto_plug = { template_id: plug, threshold: plugThreshold };
+  } else if (typeof plugThreshold === "number") {
+    note("--auto-plug-threshold requires --auto-plug <templateId>.");
+    process.exit(1);
+  }
+  if (typeof argv["super-followers"] === "boolean") {
+    body.super_followers_only = argv["super-followers"];
+  }
+}
+async function plugTemplatesList(argv) {
+  const api = new SuperXAPI(getConfig());
+  printJson(await api.listPlugTemplates({ account_id: argv.account }));
+}
 async function scheduledCreate(argv) {
   const parts = (argv.part || []).filter((p) => typeof p === "string");
   const sourceCount = [argv.text, parts.length > 0 ? "p" : void 0, argv["parts-json"]].filter(
@@ -663,6 +761,7 @@ async function scheduledCreate(argv) {
   if (argv.scratchpad !== void 0) body.scratchpad = argv.scratchpad;
   const tags = (argv.tag || []).filter((t) => typeof t === "string" && t.length > 0);
   if (tags.length > 0) body.tags = tags;
+  applyAdvancedFlags(argv, body);
   if (argv.account) body.account_id = argv.account;
   const api = new SuperXAPI(getConfig());
   const { json, replayed } = await api.createScheduled(body, argv["idempotency-key"]);
@@ -720,6 +819,7 @@ async function scheduledUpdate(argv) {
   if (argv["clear-scratchpad"]) body.scratchpad = null;
   if (tags.length > 0) body.tags = tags;
   if (argv["clear-tags"]) body.tags = [];
+  applyAdvancedFlags(argv, body);
   if (argv.account) body.account_id = argv.account;
   if (Object.keys(body).filter((k) => k !== "account_id").length === 0) {
     note("Provide at least one field to update. Run: superx scheduled:update --help");
@@ -941,6 +1041,140 @@ async function articlesCover(argv) {
   printJson(await api.generateArticleCover(argv.id, body));
 }
 
+// src/commands/context.ts
+async function contextGet(argv) {
+  const api = new SuperXAPI(getConfig());
+  printJson(await api.getContext({ account_id: argv.account }));
+}
+function commaList(value) {
+  return value.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function stringOrClear(value) {
+  return value === "" ? null : value;
+}
+async function contextSet(argv) {
+  const body = {};
+  const profileDescription = {};
+  if (argv["profile-description"] !== void 0) {
+    profileDescription.text = stringOrClear(argv["profile-description"]);
+  }
+  if (typeof argv["profile-description-enabled"] === "boolean") {
+    profileDescription.enabled = argv["profile-description-enabled"];
+  }
+  if (Object.keys(profileDescription).length > 0) {
+    body.profile_description = profileDescription;
+  }
+  if (argv.interests !== void 0) {
+    body.interests = commaList(argv.interests);
+  }
+  if (argv.rules !== void 0) {
+    body.rules = stringOrClear(argv.rules);
+  }
+  const reply = {};
+  if (argv["reply-rules"] !== void 0) {
+    reply.custom_instructions = stringOrClear(argv["reply-rules"]);
+  }
+  if (typeof argv["reply-author-name"] === "boolean") {
+    reply.include_author_name = argv["reply-author-name"];
+  }
+  if (Object.keys(reply).length > 0) {
+    body.reply = reply;
+  }
+  const voice = {};
+  if (argv["favorite-creators"] !== void 0) {
+    voice.favorite_creators = commaList(argv["favorite-creators"]);
+  }
+  if (typeof argv["own-posts-as-examples"] === "boolean") {
+    voice.use_own_posts_as_examples = argv["own-posts-as-examples"];
+  }
+  if (Object.keys(voice).length > 0) {
+    body.voice = voice;
+  }
+  const styleGuide = {};
+  if (argv["style-audience"] !== void 0) {
+    styleGuide.audience_override = stringOrClear(argv["style-audience"]);
+  }
+  if (argv["style-vocabulary"] !== void 0) {
+    styleGuide.vocabulary_override = stringOrClear(argv["style-vocabulary"]);
+  }
+  if (Object.keys(styleGuide).length > 0) {
+    body.style_guide = styleGuide;
+  }
+  if (Object.keys(body).length === 0) {
+    note("Provide at least one setting flag. Run: superx context:set --help");
+    process.exit(1);
+  }
+  if (argv.account) body.account_id = argv.account;
+  const api = new SuperXAPI(getConfig());
+  printJson(await api.updateContext(body));
+}
+async function contextProducts(argv) {
+  const api = new SuperXAPI(getConfig());
+  const json = await api.getContext({ account_id: argv.account });
+  printJson({ data: json?.data?.products ?? [] });
+}
+async function contextProductsSet(argv) {
+  if (!argv.id && !argv.url) {
+    note("Provide --id (from context:products) to edit, or --url to add or edit by url.");
+    process.exit(1);
+  }
+  if (argv.id && argv.url) {
+    note("Use either --id or --url, not both.");
+    process.exit(1);
+  }
+  const body = {};
+  if (argv.name !== void 0) body.name = stringOrClear(argv.name);
+  if (argv.description !== void 0) body.description = stringOrClear(argv.description);
+  if (argv.positioning !== void 0) body.positioning = stringOrClear(argv.positioning);
+  if (argv.features !== void 0) body.features = stringOrClear(argv.features);
+  if (argv.updates !== void 0) body.updates = stringOrClear(argv.updates);
+  if (argv.account) body.account_id = argv.account;
+  const api = new SuperXAPI(getConfig());
+  printJson(await api.updateContextProduct(argv.id || argv.url, body));
+}
+async function contextProductsDelete(argv) {
+  const id = String(argv.id || "").trim();
+  if (!id) {
+    note("Provide the product id. Run: superx context:products:delete --help");
+    process.exit(1);
+  }
+  const api = new SuperXAPI(getConfig());
+  printJson(await api.deleteContextProduct(id, { account_id: argv.account }));
+}
+
+// src/commands/queue.ts
+async function queueGet(argv) {
+  const api = new SuperXAPI(getConfig());
+  printJson(await api.getQueueSettings({ account_id: argv.account }));
+}
+async function queueSet(argv) {
+  const body = {};
+  if (argv["slots-json"] !== void 0) {
+    let parsed;
+    try {
+      parsed = JSON.parse(argv["slots-json"]);
+    } catch {
+      note(`--slots-json must be valid JSON, e.g. '[{"time":"09:00","days":[1,3,5]}]'`);
+      process.exit(1);
+    }
+    if (!Array.isArray(parsed)) {
+      note(`--slots-json must be a JSON array, e.g. '[{"time":"09:00","days":[1,3,5]}]' (use '[]' to clear).`);
+      process.exit(1);
+    }
+    body.slots = parsed;
+  }
+  if (argv.timezone !== void 0) {
+    body.timezone = argv.timezone;
+  }
+  if (Object.keys(body).length === 0) {
+    note("Provide --slots-json and/or --timezone. Run: superx queue:set --help");
+    process.exit(1);
+  }
+  if (argv.account) body.account_id = argv.account;
+  const api = new SuperXAPI(getConfig());
+  printJson(await api.updateQueueSettings(body));
+}
+
 // src/commands/docs.ts
 async function docs() {
   const apiUrl = resolveApiUrl(loadCredentials()?.apiUrl || DEFAULT_API_URL);
@@ -972,6 +1206,23 @@ var accountOption = (y) => y.option("account", {
   describe: "Account id (from `superx accounts`); defaults to your main account",
   type: "string"
 });
+var advancedSettingsOptions = (y) => y.option("auto-retweet", {
+  describe: "Auto retweet the post after this many hours (1-12); --no-auto-retweet turns it off"
+}).option("auto-retweet-remove", {
+  describe: "Remove the auto retweet after this many hours (1-12); needs --auto-retweet"
+}).option("auto-delete", {
+  describe: "Auto delete the post after this many hours (1-12) if it underperforms; --no-auto-delete turns it off"
+}).option("auto-delete-threshold", {
+  describe: "Views threshold for --auto-delete: delete only below this many views (default 1000)"
+}).option("auto-plug", {
+  describe: "Plug template id (from plug-templates:list) to auto-reply with; --no-auto-plug turns it off",
+  type: "string"
+}).option("auto-plug-threshold", {
+  describe: "Likes threshold for --auto-plug: the reply posts once the post hits this many likes"
+}).option("super-followers", {
+  describe: "Post to Super Followers only (--no-super-followers turns it off)",
+  type: "boolean"
+});
 (0, import_yargs.default)((0, import_helpers.hideBin)(process.argv)).scriptName("superx").usage("$0 <command> [options]").command(
   "login",
   "Authenticate with a SuperX API key (guided paste or --key)",
@@ -1140,7 +1391,7 @@ var accountOption = (y) => y.option("account", {
 ).command(
   "scheduled:create",
   "Create a draft (no --at) or scheduled post; repeat --part for a thread",
-  (y) => accountOption(y).option("text", { describe: "Text for a single post", type: "string" }).option("part", {
+  (y) => advancedSettingsOptions(accountOption(y)).option("text", { describe: "Text for a single post", type: "string" }).option("part", {
     describe: "Thread part text (repeat the flag, 1-25 parts, in order)",
     type: "string",
     array: true
@@ -1163,12 +1414,12 @@ var accountOption = (y) => y.option("account", {
   }).option("idempotency-key", {
     describe: "Idempotency-Key header (max 64 chars); retries with the same key return the original result",
     type: "string"
-  }).example('$0 scheduled:create --text "Hello"', "Create a draft").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z"', "Schedule a post").example('$0 scheduled:create --part "1/ Hook" --part "2/ Detail" --part "3/ CTA"', "Draft a 3-part thread").example('$0 scheduled:create --text "Hello" --title "Launch teaser" --tag abc123', "Draft with a title and a tag").example('$0 scheduled:create --text "Chart of the week" --media "<object_key>" --alt-text "Revenue chart"', "Draft with an image"),
+  }).example('$0 scheduled:create --text "Hello"', "Create a draft").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z"', "Schedule a post").example('$0 scheduled:create --part "1/ Hook" --part "2/ Detail" --part "3/ CTA"', "Draft a 3-part thread").example('$0 scheduled:create --text "Hello" --title "Launch teaser" --tag abc123', "Draft with a title and a tag").example('$0 scheduled:create --text "Chart of the week" --media "<object_key>" --alt-text "Revenue chart"', "Draft with an image").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z" --auto-retweet 6 --auto-retweet-remove 4', "Schedule with an auto retweet").example('$0 scheduled:create --text "Hello" --at "2026-08-01T15:00:00Z" --no-auto-retweet --no-auto-plug', "Schedule with your defaults off for this post"),
   run(scheduledCreate)
 ).command(
   "scheduled:update <id>",
   "Edit a draft or scheduled post; only the flags you pass change",
-  (y) => accountOption(y).positional("id", { describe: "Post id (from scheduled:list or scheduled:create)", type: "string" }).option("text", { describe: "Replacement text for a single post", type: "string" }).option("part", {
+  (y) => advancedSettingsOptions(accountOption(y)).positional("id", { describe: "Post id (from scheduled:list or scheduled:create)", type: "string" }).option("text", { describe: "Replacement text for a single post", type: "string" }).option("part", {
     describe: "Replacement thread part text (repeat the flag, 1-25 parts, in order)",
     type: "string",
     array: true
@@ -1192,13 +1443,94 @@ var accountOption = (y) => y.option("account", {
     describe: "Replacement tag id set (repeat the flag, max 20; replaces ALL current tags)",
     type: "string",
     array: true
-  }).option("clear-tags", { describe: "Remove all tags", type: "boolean" }).example('$0 scheduled:update abc123 --title "Better hook"', "Retitle a draft, everything else untouched").example('$0 scheduled:update abc123 --at "2026-08-01T15:00:00Z" --status scheduled', "Promote a draft to the queue").example("$0 scheduled:update abc123 --status draft", "Pull a post back to drafts (quota refunds)"),
+  }).option("clear-tags", { describe: "Remove all tags", type: "boolean" }).example('$0 scheduled:update abc123 --title "Better hook"', "Retitle a draft, everything else untouched").example('$0 scheduled:update abc123 --at "2026-08-01T15:00:00Z" --status scheduled', "Promote a draft to the queue").example("$0 scheduled:update abc123 --status draft", "Pull a post back to drafts (quota refunds)").example("$0 scheduled:update abc123 --auto-delete 8 --auto-delete-threshold 500", "Add an auto delete to the post").example("$0 scheduled:update abc123 --no-auto-retweet", "Remove the post's auto retweet"),
   run(scheduledUpdate)
 ).command(
   "scheduled:delete <id>",
   "Delete a draft or scheduled post by id",
   (y) => y.positional("id", { describe: "Post id (from scheduled:list or scheduled:create)", type: "string" }),
   run(scheduledDelete)
+).command(
+  "plug-templates:list",
+  "List your auto-plug reply templates (id, text, has_media) for --auto-plug",
+  (y) => accountOption(y),
+  run(plugTemplatesList)
+).command(
+  "context:get",
+  "Show the account's Context settings: profile description, interests, rules, reply settings, favorite creators, style guide, products",
+  (y) => accountOption(y),
+  run(contextGet)
+).command(
+  "context:set",
+  'Edit Context settings; only the flags you pass change (string flags: "" clears; lists fully replace)',
+  (y) => accountOption(y).option("profile-description", {
+    describe: 'Who you are and what you do, grounds the AI voice (max 500 chars; "" clears)',
+    type: "string"
+  }).option("profile-description-enabled", {
+    describe: "Use the profile description in AI writing (--no-profile-description-enabled turns it off)",
+    type: "boolean"
+  }).option("interests", {
+    describe: 'Comma list of topics you want content about (max 30, each max 50 chars; replaces the stored list; "" clears)',
+    type: "string"
+  }).option("rules", {
+    describe: 'SuperX rules the AI must follow on every surface (max 500 chars; "" clears)',
+    type: "string"
+  }).option("reply-rules", {
+    describe: 'Custom instructions for AI-generated replies (max 500 chars; "" clears)',
+    type: "string"
+  }).option("reply-author-name", {
+    describe: "Let AI replies address the post author by name (--no-reply-author-name turns it off)",
+    type: "boolean"
+  }).option("favorite-creators", {
+    describe: 'Comma list of X usernames whose style inspires yours (max 3; replaces the stored list; "" clears)',
+    type: "string"
+  }).option("own-posts-as-examples", {
+    describe: "Use your own posts as voice examples (--no-own-posts-as-examples turns it off)",
+    type: "boolean"
+  }).option("style-audience", {
+    describe: 'Manual audience description that outranks the generated style guide (max 600 chars; "" reverts to generated)',
+    type: "string"
+  }).option("style-vocabulary", {
+    describe: 'Manual vocabulary and style description that outranks the generated style guide (max 1000 chars; "" reverts to generated)',
+    type: "string"
+  }).example('$0 context:set --rules "Never use hashtags. Keep posts under 200 chars."', "Set your SuperX rules").example('$0 context:set --interests "indie hacking,SaaS,AI agents"', "Replace your interests").example('$0 context:set --favorite-creators "levelsio,marc_louvion"', "Set favorite creators").example('$0 context:set --style-audience ""', "Revert to the generated audience description"),
+  run(contextSet)
+).command(
+  "context:products",
+  "List the account's products (used for product mentions in generated content)",
+  (y) => accountOption(y),
+  run(contextProducts)
+).command(
+  "context:products:set",
+  "Add or edit ONE product by --url (creates it when new, cap 5) or --id",
+  (y) => accountOption(y).option("id", { describe: "Product id (from context:products) to edit", type: "string" }).option("url", { describe: "Product http(s) url; creates the product when it does not exist", type: "string" }).option("name", { describe: 'Product name (max 200 chars; "" clears)', type: "string" }).option("description", { describe: 'What the product is (max 1000 chars; "" clears)', type: "string" }).option("positioning", { describe: 'Positioning and differentiation (max 2000 chars; "" clears)', type: "string" }).option("features", { describe: 'Key features (max 2000 chars; "" clears)', type: "string" }).option("updates", { describe: 'Recent updates worth mentioning (max 2000 chars; "" clears)', type: "string" }).example('$0 context:products:set --url "https://superx.so" --name "SuperX" --description "X growth platform"', "Add or edit a product by url").example('$0 context:products:set --id 3 --updates "Shipped the public API"', "Update one field by id"),
+  run(contextProductsSet)
+).command(
+  "context:products:delete <id>",
+  "Remove a product by id (reversible by re-adding the same url)",
+  (y) => accountOption(y).positional("id", { describe: "Product id (from context:products)", type: "string" }),
+  run(contextProductsDelete)
+).command(
+  "queue:get",
+  "Show the account's posting schedule: predefined time slots and the timezone they run in",
+  (y) => accountOption(y),
+  run(queueGet)
+).command(
+  "queue:set",
+  "Change the posting schedule; changing the slots also re-flows queued posts onto them",
+  (y) => accountOption(y).option("slots-json", {
+    describe: `JSON array of slots, e.g. '[{"time":"09:00","days":[1,3,5]}]' (0 = Sunday; max 50, one entry per time; replaces the stored slots; '[]' clears them)`,
+    type: "string"
+  }).option("timezone", {
+    describe: 'IANA timezone the slot times run in, e.g. "Europe/London" (changing only this never moves queued posts)',
+    type: "string"
+  }).example(
+    `$0 queue:set --slots-json '[{"time":"09:00","days":[1,2,3,4,5]},{"time":"17:30","days":[1,3,5]}]'`,
+    "Replace the posting slots and re-flow the queue"
+  ).example('$0 queue:set --timezone "Europe/London"', "Change the posting timezone without moving posts").example(`$0 queue:set --slots-json '[]'`, "Clear every predefined slot").epilogue(
+    "Changing the timezone and the slots in one call usually moves nothing, because the existing posts were placed under the old timezone; to re-flow them, change the timezone first, then send the slots in a second call."
+  ),
+  run(queueSet)
 ).command("tags:list", "List your tags (id, name, color)", {}, run(tagsList)).command(
   "tags:create <name>",
   "Create a tag",

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "superx-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "SuperX CLI - command line interface to the SuperX API for Twitter/X growth: read posts and analytics, find engaged contacts, and schedule posts and threads",
   "main": "dist/index.js",
   "bin": {
-    "superx": "./dist/index.js"
+    "superx": "dist/index.js"
   },
   "scripts": {
     "dev": "tsup --watch",
@@ -36,7 +36,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/superx-so/superx-agent.git"
+    "url": "git+https://github.com/superx-so/superx-agent.git"
   },
   "homepage": "https://docs.superx.so",
   "bugs": {