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 initOnboard: paste your API key, install the agent skills, generate agent surfaces (CLAUDE.md, START.md, slash commands)
creatoros syncRefresh skills + agent surfaces to the latest we’ve shipped. Your edited files are never clobbered; updates land alongside as .new files
creatoros auth:checkVerify the saved API key is valid (exits 0 when good; skills run this first)
creatoros accounts:list --prettyList 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:createPublish 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 --prettyThe queue: scheduled + published posts
creatoros posts:get <postId> --prettyOne post’s status, targets, and timing
creatoros posts:update / posts:deleteEdit 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 "..." --prettyCheck a caption against every platform’s character limit before posting
creatoros validate:media --url <url> --prettyCheck 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 --prettyList 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 --prettyList 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 --cloudList your comment-to-DM automations with their stats
Analytics
creatoros analytics:posts --prettyPer-post performance across every connected platform
creatoros analytics:daily --prettyDaily account metrics over time
creatoros analytics:best-time --prettyBest posting windows learned from your accounts
creatoros accounts:follower-stats --prettyFollower 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:accountThe 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:blockedStop (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:sitesConnected 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:connectionsAd 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 ... --pausedLaunch 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> ... --validateOnlyDry 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 dailyChange 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.txtCustomer list audiences (emails are hashed before sending)
creatoros ads:targeting --accountId <acc_> --q fitness --dimension interestLook 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.