CLI reference

Everything below runs as creatoros … (from the Social Agents codebase, or via npx @creatoros/cli after init). Add --pretty to any read command for human-friendly output; agents usually consume the default JSON.

Setup, accounts & publishing

creatoros init

Onboard: paste your API key, install the agent skills, generate agent surfaces (CLAUDE.md, START.md, slash commands)

creatoros sync

Refresh skills + agent surfaces to the latest we’ve shipped. Your edited files are never clobbered; updates land alongside as .new files

creatoros auth:check

Verify the saved API key is valid (exits 0 when good; skills run this first)

creatoros accounts:list --pretty

List this workspace’s connected social accounts and their account IDs

creatoros media:upload <file>

Upload an image or video once; returns a media id (med_…) reusable across every platform

creatoros posts:create

Publish or schedule a post to one or many accounts (--accounts takes comma-separated account IDs; --cover <med_id> sets a video cover)

creatoros posts:list --pretty

The queue: scheduled + published posts

creatoros posts:get <postId> --pretty

One post’s status, targets, and timing

creatoros posts:update / posts:delete

Edit or remove a scheduled post before it goes out

creatoros posts:retry <postId>

Re-attempt a post that failed on a platform

creatoros posts:edit <postId> --platform <network> --text "..."

Edit the text of a post that is already live (X, Facebook, LinkedIn, YouTube)

creatoros posts:unpublish <postId> --platform <network>

Take a published post down from one network (not Instagram or TikTok)

creatoros posts:bulk-upload --file calendar.json [--dryRun]

Schedule a whole calendar in one call; dry-run it first

creatoros validate:post-length --text "..." --pretty

Check a caption against every platform’s character limit before posting

creatoros validate:media --url <url> --pretty

Check a media URL is reachable and a supported format

creatoros accounts:connect <platform>

Get a link that connects a new social account to this workspace

creatoros webhooks:create --url <https://…>

Get Creator OS events (post.published, comment.received, …) POSTed to your server, signed with X-CreatorOS-Signature

Inbox: comments & messages

creatoros inbox:comments --pretty

List comments across every connected account

creatoros inbox:post-comments <postId>

Comments on one specific post

creatoros inbox:reply <postId>

Reply to a comment on a post

creatoros inbox:private-reply <postId> <commentId>

Answer a commenter in their DMs instead of the thread

creatoros inbox:like-comment / inbox:unlike-comment <postId> <commentId>

Like (or unlike) a comment

creatoros inbox:hide-comment / inbox:unhide-comment <postId> <commentId>

Hide (or unhide) a comment: reversible, and invisible to the commenter

creatoros inbox:delete-comment <postId>

Delete a comment permanently

creatoros inbox:conversations --pretty

List DM conversations across accounts

creatoros inbox:messages <conversationId>

Read the messages in one conversation

creatoros inbox:send <conversationId>

Send a DM in a conversation

creatoros inbox:mark-read <conversationId>

Mark a conversation as read

creatoros inbox:update-conversation <conversationId>

Archive / unarchive a conversation

creatoros automations:list --cloud

List your comment-to-DM automations with their stats

Analytics

creatoros analytics:posts --pretty

Per-post performance across every connected platform

creatoros analytics:daily --pretty

Daily account metrics over time

creatoros analytics:best-time --pretty

Best posting windows learned from your accounts

creatoros accounts:follower-stats --pretty

Follower counts across all connected accounts

Skool communities

Connect Skool on the Connect page in Creator OS first (you sign in on Skool's own page) and choose which communities to share. Use the community slug from skool:account. Needs CLI 0.4.0 or later (npx @creatoros/cli@latest).

creatoros skool:account

The connected Skool account and the communities you shared, each read or read & write

creatoros skool:categories <community>

Post categories (label ids). Communities with several need --labelId on new posts

creatoros skool:posts <community> [--sort newest] [--page 2]

One page of the feed (sorts: newest-cm, newest, best-1w, best-1m, best-1y)

creatoros skool:find <community> --unanswered [--text <q>] [--since <iso>]

Find posts, e.g. every post nobody has replied to yet

creatoros skool:post <community> <postId> / skool:comments <community> <postId>

One post / its full comment thread (--flat for a flat list)

creatoros skool:create <community> --title <t> --text <body> [--labelId <id>] [--poll "A,B"] [--media <url,url>]

Publish a post or poll with images or video attached (--notifyAll also emails every member)

creatoros skool:multi-post --communities <a,b> --title <t> --text <body> [--media <url,url>]

Post the same thing to several communities, with a result per community

creatoros skool:comment <community> <postId> --text <reply> [--parentId <commentId>]

Comment on a post, or reply to a comment

creatoros skool:update / skool:delete <community> <postId>

Edit or delete a post or comment

creatoros skool:pin / skool:unpin / skool:like / skool:unlike <community> <postId>

Pin or like posts

creatoros skool:members <community> [--search <name>] / skool:pending <community>

Active members / join requests with their application answers

creatoros skool:approve / skool:deny <community> <memberId>

Approve or decline a join request

creatoros skool:revenue / skool:growth / skool:engagement <community>

MRR (mrr_usd), members and retention / last 30 days of visitors, signups, conversion / active members

creatoros skool:chart <community> <mrr|members|retention_members|signups_by_source|...>

One dashboard time series (16 charts, money in dollars)

creatoros skool:members <community> --tab churned|banned|invited|admin / skool:emails <community>

Past, banned or invited members / emails from join applications (owner or admin only)

creatoros skool:profile / skool:followers [--following] [--page N]

Follower, following and post counts / who follows you (30 per page)

creatoros skool:chats [--unread] / skool:messages <chatId>

DM conversations / one conversation's messages

creatoros skool:send <chatId> --text <msg> / skool:start-chat <userId> --community <slug>

Reply in a DM / start a new chat (Skool sends a chat request)

creatoros skool:block <userId> [--unblock] / skool:blocked

Stop (or allow again) someone messaging you / list blocked users

Blog (WordPress)

Your own WordPress site, so your agent can write SEO articles on your domain. Needs CLI 0.6.0 or later. New articles are drafts unless you pass --publish or --schedule.

creatoros blog:connect / blog:connect-selfhosted --site https://yoursite.com --username <u> --password "<app password>"

Connect a WordPress.com site (sign-in link) or a self-hosted one (Application Password)

creatoros blog:sites

Connected WordPress sites

creatoros blog:list [--limit 20] / blog:get <articleId>

Articles (published, scheduled, drafts) / one article with its HTML

creatoros blog:create --title <t> --file post.html [--slug <s>] [--excerpt <e>] [--tags a,b] [--image <url>] [--publish | --schedule <iso>]

Write an article (a draft unless --publish or --schedule); --html "<p>..</p>" instead of --file

creatoros blog:update <articleId> [--title ..] [--file ..] [--publish | --unpublish]

Edit, publish or unpublish an article

creatoros blog:delete <articleId>

Delete an article for good

Variations

One video into up to 20 different versions, one for every account you post from. Needs CLI 0.7.0 or later. See the Variations guide.

creatoros variations:create <file|url> [--count 20] [--hook "<text>" | --noHook] [--notes "<about>"] [--noGifs] [--wait]

One video into up to 20 versions (a local file is uploaded first); --wait polls until it is done

creatoros variations:list / variations:get <id>

Runs (with your plan access) / one run with every version: hook, caption, hashtags, video_url

creatoros variations:download <id> [--dir ./out]

Save every ready version as an MP4, plus captions.txt

creatoros variations:cancel <id>

Stop a run that is still rendering (finished versions stay)

Ads (add-on)

Meta, Google, LinkedIn, TikTok, X and ChatGPT ads. Needs the Ads add-on and CLI 0.5.0 or later. Ads spend real money: create with --paused and review before resuming. See the Ads guide.

creatoros ads:connections

Ad networks connected to this workspace; each id (acc_) is the --accountId for the rest

creatoros ads:connect meta|google|tiktok|x / ads:connect-openai --apiKey <key>

A sign-in link to connect an ad network / connect ChatGPT ads with an API key

creatoros ads:accounts <accountId>

Ad accounts a connection can spend from (adAccountId, currency, billing status)

creatoros ads:overview [--from <date>] [--platform <p>]

Every campaign with ad sets and ads, spend, clicks and CTR rolled up

creatoros ads:campaigns / ads:list [--mine] / ads:get <adId>

Campaigns / individual ads / one ad with creative and targeting

creatoros ads:analytics <adId> / ads:campaign-analytics <campaignId>

Spend, impressions, clicks, CPC, conversions and ROAS with a daily series

creatoros ads:create --accountId <acc_> --adAccountId <id> --name <n> --goal traffic --budget 20 --budgetType daily ... --paused

Launch a campaign + ad set + ad (spends real money unless --paused)

creatoros ads:best-posts --accountId <acc_> --adAccountId <act_...>

Posts a Meta ad account can boost, best performers first

creatoros ads:boost <postId> ... --validateOnly

Dry run for ads:create or ads:boost: every check, nothing created (run it before the real call)

creatoros ads:boost <postId> --accountId <acc_> --adAccountId <id> --budget 15 --budgetType daily [--countries US]

Promote a published post (Meta, Google, X)

creatoros ads:pause / ads:resume <adId>, ads:campaign-pause / ads:campaign-resume <campaignId> --platform <p>

Pause or resume an ad or a whole campaign

creatoros ads:budget <adId> / ads:campaign-budget <campaignId> --platform <p> --amount 25 --type daily

Change a budget (whole currency units)

creatoros ads:cancel <adId>

Cancel an ad for good (prefer pausing)

creatoros ads:audiences / ads:audience-create / ads:audience-add <aud_> --file emails.txt

Customer list audiences (emails are hashed before sending)

creatoros ads:targeting --accountId <acc_> --q fitness --dimension interest

Look up targeting ids

creatoros ads:call <METHOD> <path> [--query '{"accountId":"acc_..."}'] [--body '{...}']

Any other ads endpoint (lead forms, pixels, creatives, catalogs, reports, ...): see the full list in the Ads guide

Scheduled agent runs

creatoros automations:create <name> --schedule "<cron>" --skill <skill>

Schedule a recurring agent run, locally (launchd/cron) or --target railway for always-on cloud

creatoros automations:list / automations:remove <name>

Review or remove scheduled agent runs

Run creatoros --help for the full list, or creatoros <command> --help for one command’s flags. Every command is a thin wrapper over the Creator OS API.