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
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.