CLI commands

Every action is a command: xholic <area> <action>. Required flags are in bold. Every command also takes the global flags (--json, --account, and --dry-run, --estimate where they apply). The linked reference lists each flag’s type and meaning.

Your profile

Command	Flags	What it does
xholic me get	None	Load this before writing anything for the user.

Accounts

Command	Flags	What it does
xholic accounts list	None	List the X accounts this connection can act on (own, added and shared), with your role on each and which one is the default.

Context and voice

Command	Flags	What it does
xholic context writing-kit	--topic --limit	Material for writing posts in the user’s voice: real posts that worked (their own winners, their circle this week, bookmarks, library outliers) to build each new post from, fresh facts and takes, and what they posted lately so you don’t repeat it.
xholic context update	--target-audience --content-goals --product-context --selected-topics --account-rules	Change the account’s audience, goals, product context, topics or rules that every Xholic writer reads.
xholic context products	None	The account’s saved products with their facts (what it is, audience, features, proof), analysis limits and removal notices.
xholic context bio-product-suggestion	None	The link in the account’s X bio when it isn’t a saved product yet, so it can be added with context.add_product.
xholic context add-product	--url	Add a product by its website URL.
xholic context refresh-product	--product-id	Read the product’s website again and update its facts.
xholic context set-product-auto-refresh	--product-id --when-edited	Choose whether a product keeps refreshing automatically after its facts were edited by hand.
xholic context update-product	--product-id --structured-facts	Replace a product’s facts.
xholic context delete-product	--product-id	Remove a product from the account’s context.
xholic context dismiss-product-notice	--product-id	Hide the notice that a product was removed automatically.

Profile check

Command	Flags	What it does
xholic profile check	None	Check the account’s X profile (bio, pinned post, banner, link) against what makes strangers follow, with concrete fixes.

Updates

Command	Flags	What it does
xholic events updates	--since --limit	Call at the start of a conversation.

Insights

Command	Flags	What it does
xholic insights whats-working	--range --timezone	What worked for the account over a period and why: best posts, formats, topics and times, compared with their normal.
xholic insights bank	--area-id --limit	The account’s knowledge areas and the insights Xholic mined from their posts, for teaching posts.

Niche

Command	Flags	What it does
xholic niche now	--kind --topic --limit	Posts proven this week in the account’s circle and niche, plus bookmarks, likes and library outliers.

Engage

Command	Flags	What it does
xholic engage who-to-engage	--limit	People worth replying to right now and why: unanswered mentions, the account’s reply circle, and warm Signals leads.
xholic engage reply-circle	--limit	The people the account trades replies with most, and who to reply to next to grow.
xholic engage get-consent	None	Whether the user accepted Engage’s guidelines.
xholic engage accept-consent	--version	Record that the user accepted Engage’s guidelines for engaging on X.
xholic engage list-feeds	--placement	The account’s saved Engage feeds (FEEDS) or extension timelines (TIMELINE).
xholic engage create-feed	--name --type --placement --query --contact-list-id --x-list-id --excluded-handles --excluded-terms	Save a feed of posts to engage with: a topic, a contact list, an X list, or one account (timelines only).
xholic engage create-feeds	--feeds	Save up to 8 Engage feeds in one call.
xholic engage update-feed	--id --name --type --placement --query --contact-list-id --x-list-id --excluded-handles --excluded-terms	Change a saved feed.
xholic engage delete-feed	--id	Delete a saved Engage feed.
xholic engage feed	--feed-id --type --query --sort --cursor --hide-replied	Posts to engage with from a saved feed (feedId) or an ad-hoc topic search (type TOPIC + query), top or latest.
xholic engage set-item-state	--tweet-id --hidden --replied --account-id	Hide a post from Engage feeds (a skip), or mark it replied or not replied.
xholic engage clear-skips	None	Bring back every post the account hid from Engage feeds.

Mentions

Command	Flags	What it does
xholic mentions list	--kind --hide-replied	The account’s latest mentions and replies to its posts, synced by Xholic.

Replies

Command	Flags	What it does
xholic replies mine	--sort	Replies the account sent, newest or best first.
xholic replies prefetch	--tweet-id	Load an X post and its thread ahead of drafting a reply with Xholic’s reply writer.
xholic replies select-draft	--tweet-id --generation-id --index	Switch a reply generation to one of its other drafts (already paid for, free).
xholic replies get-settings	None	The reply writer’s custom instructions and whether replies may use the author’s name.
xholic replies update-settings	--custom-instructions --include-author-name	Change the reply writer’s custom instructions or whether replies may use the author’s name.

People

Command	Flags	What it does
xholic people get	--username	Everything about one X account: profile, recent posts, and the history with the user (replies, DMs, notes, lead status).

Posts

Command	Flags	What it does
xholic posts get	--tweet-id	Any X post by id or URL with its numbers and context.
xholic posts conversation	--tweet-id	A post’s thread and replies.
xholic posts schedule	--text --thread-parts --scheduled-at --timezone --media --automation	Schedule a post or thread on X at a time.
xholic posts publish-now	--text --thread-parts --media --automation	Post to X immediately.

X search

Command	Flags	What it does
xholic x search	--query --sort	Live X search, one page of up to 20 posts.

Inspiration

Command	Flags	What it does
xholic inspiration search	--query --time-range --limit	Search Xholic’s library of proven posts by idea, with outlier scores (how far a post beat its author’s normal).
xholic inspiration explain-structure	--tweet-id	Xholic AI breaks down why an Inspiration post works: hook, structure and reusable pattern.

Library

Command	Flags	What it does
xholic library saved	--query --kind --questions-only --limit	The account’s X bookmarks and likes mirrored by Xholic, plus saved posts.
xholic library save	--tweet-id	Save an X post to the user’s library by its id.
xholic library save-by-url	--url	Save an X post to the user’s library from its URL.
xholic library unsave	--tweet-id	Remove a post from the user’s library.

Creators

Command	Flags	What it does
xholic creators top-posts	--username --range --limit	Another creator’s best posts over a period.

Drafts

Command	Flags	What it does
xholic drafts check	--text --thread-parts --source-text	Free checks before posting: length for the account’s X tier, links (Xholic drafts never contain links), near-copies of a source post, repeats of what the account posted recently, and thread structure.
xholic drafts save	--text --thread-parts --timezone	Save a post or thread as a draft in Xholic.
xholic drafts with-xholic	--count --angles --source-post-ids --like-post-id --topic	Only when the user explicitly asks for Xholic’s writer.
xholic drafts reply-with-xholic	--tweet-id --instructions	Only when the user explicitly asks for Xholic’s reply writer.

Queue

Command	Flags	What it does
xholic queue list	--view --limit	Scheduled posts and drafts, soonest first.
xholic queue reschedule	--post-id --scheduled-at --timezone	Move a queued post to a new time.
xholic queue unschedule	--post-id	Take a scheduled post out of the queue and keep it as a draft.
xholic queue edit	--post-id --text --thread-parts --media --automation	Change the text, thread, media or automations of a draft or scheduled post.
xholic queue delete	--post-id	Delete a draft or scheduled post from Xholic.
xholic queue counts	None	How many posts are queued, drafted, posted and failed.
xholic queue get-post	--post-id	One draft, scheduled, posted or failed post in Xholic with its text, thread, media, automations and status.
xholic queue post-now	--post-id --text --thread-parts --media --automation --expected-updated-at	Publish an existing draft or scheduled post to X right away.
xholic queue cancel	--post-id	Cancel a draft, scheduled or failed post so it never goes out.
xholic queue share-draft	--post-id	Create a public read-only link to a draft so someone without Xholic can review it.
xholic queue revoke-share	--post-id	Turn off every public link to a draft.
xholic queue add-automation-step	--post-id --type --delay-minutes --views-threshold --likes-threshold --template-name --template-text --monitoring-window-minutes --reply-keyword --require-repost --max-recipients --message-template	Add one automation step to a post that is already live: repost, unrepost, delete, a plug reply after enough likes, or DMs to people who reply with a keyword.
xholic queue update-automation-step	--post-id --rule-id --type --delay-minutes --views-threshold --likes-threshold --template-name --template-text --monitoring-window-minutes --reply-keyword --require-repost --max-recipients --message-template	Change a pending automation step on a live post.
xholic queue remove-automation-step	--post-id --rule-id	Remove a pending automation step from a live post before it runs.

Media

Command	Flags	What it does
xholic media create-upload	--original-filename --mime-type --byte-size --kind	Start a media upload (image, GIF or video).
xholic media complete-upload	--media-id --parts	Mark an upload finished after the bytes were PUT to the upload URL.
xholic media get	--media-id	One uploaded media item’s state.
xholic media preview	--media-id	A short-lived URL to view an uploaded media item.
xholic media delete	--media-id	Delete an uploaded media item that no post uses.
xholic media browse-klipy	--type --q --page	Search or browse KLIPY GIFs and memes to attach to a post.
xholic media import-klipy	--type --slug	Copy a KLIPY GIF or meme into the account’s media.

Content export

Command	Flags	What it does
xholic content export	--range --timezone	The account’s posts with their numbers for a period, as data you can analyse.

Analytics

Command	Flags	What it does
xholic analytics summary	--range --timezone	Totals and a daily series for a period: impressions, engagement, followers, posts and replies counted separately.
xholic analytics content	--range --timezone --search --sort --limit	How the account’s posts performed, compared with its normal.
xholic analytics growth	None	The follower funnel for the last 7 and 30 days (impressions to profile visits to follows), its weakest step and the profile check score.
xholic analytics import-status	None	Whether the account’s post history is still importing, up to date or delayed, and how far it got.
xholic analytics export-posts-csv	--range --timezone --kind --origin --format --search --sort --direction --from --to	Every post in a period with its numbers as CSV text (up to 5,000 rows).
xholic analytics export-daily-csv	--range --timezone	Daily totals for a period (posts, impressions, engagement, follower change) as CSV text.
xholic analytics list-imports	None	X analytics CSV files imported into this account, with the days each one covered.
xholic analytics import-csv	--csv --confirm-ownership	Import the account overview CSV exported from X analytics to fill in past days.
xholic analytics delete-import	--id	Remove an imported analytics file and the days it wrote.

Memory

Command	Flags	What it does
xholic memory remember	--fact --kind	Save a fact, writing preference or answer about the user to the memory every Xholic writer reads.
xholic memory forget	--memory-id --fact	Remove a memory the user says is wrong or outdated.
xholic memory list	None	Everything the user told Xholic to remember.

Workers

Command	Flags	What it does
xholic workers list	None	The account’s Workers (always-on AI writers): settings, schedule and status.
xholic workers drafts	--neuron-id --limit	Drafts a Worker wrote that are waiting for review.
xholic workers overview	None	The account’s growth overview: milestones, Workers and what they produced.
xholic workers find-creators	--query	Find X creators whose style a Worker can learn from.
xholic workers create	--name --status --voice-mode --creator-xids --instructions --apply-account-rules --mirror-proven-posts --topic-mode --custom-topic --product-ids --output-count --schedule-mode --schedule-time-minutes --schedule-day-of-week	Create a Worker that writes posts on a schedule or on demand.
xholic workers update	--worker-id --changes	Change a Worker’s instructions, voice, topics, products, size or schedule.
xholic workers set-status	--worker-id --status	Pause or resume a Worker.
xholic workers run	--neuron-id	Queue a Worker to write a new batch now with Xholic’s writer.
xholic workers create-ready-made	None	Create the preset Worker built from the account’s context (voice, creators it already has posts for, products).
xholic workers rebuild-ready-made	--id --keep-instructions	Refresh the ready-made Worker’s creators and brief from the account’s current context.
xholic workers cancel-queued-run	--id	Stop a Worker run that is queued and hasn’t started yet.
xholic workers runs	--limit	Recent Worker runs, newest first: status, trigger, credits and why a run failed or was skipped.
xholic workers voice	None	The account’s takes (opinions) and expertise areas that Workers write from, each marked as mined or added by the user.
xholic workers add-take	--text	Add an opinion the user holds, in their words, for Workers to write from.
xholic workers remove-take	--id	Remove a take so Workers stop writing from it.
xholic workers add-expertise	--name	Add a subject the account teaches, so Workers write knowledge posts about it.
xholic workers remove-expertise	--id	Remove an expertise area and its insight cards.
xholic workers review-draft	--id --status --reason	Move a Worker draft: DRAFT keeps it in the user’s drafts, DISMISSED throws it away, TO_REVIEW puts it back in review.
xholic workers draft-feedback	--id --action	Tell the Workers to write more or fewer drafts like this one.
xholic workers draft-meme	--id	The reaction image (GIF or meme) attached to a Worker meme draft.
xholic workers set-draft-meme	--id --kind --pick	Swap or remove the reaction image on a Worker meme draft.

Leads

Command	Flags	What it does
xholic leads list	--agent-id --status --limit	Leads found by the account’s Signals agents, hottest first, with why each one fits.
xholic leads set-status	--id --status --suppress	Mark a lead COLLECTED (keep), CONTACTED (reached out) or DISMISSED (not now).
xholic leads rate	--id --verdict --reason	Mark a lead as a FIT or NOT_FIT, with an optional short reason, so the Signals agent learns who to find.

Signals

Command	Flags	What it does
xholic signals automation-setup	None	Every Worker and Signals agent with its settings, for planning changes.
xholic signals customer-brief	None	Who the account’s customers are, what they ask, and where to find them, from Signals.
xholic signals draft-audience	--mode --product-id --url --audience-description	Draft who a Signals agent should find, from a product, a URL or a description.
xholic signals suggest-sources	--audience-description --rubric --product-id --existing	Suggest keywords, profiles and lists a Signals agent should watch.
xholic signals test-searches	--queries	Try search queries on live X before an agent uses them.
xholic signals create-agent	--name --product-id --audience-description --exclusions --rubric --strictness --dm-policy --destination-list-id --baseline-mode --interval-hours --status --sources --new-list-name	Create an always-on agent that finds leads on X from sources and an audience description.
xholic signals find-customers	--product-id --replace-agent-id	One-click agent that finds people asking for what a product does, and its competitors’ customers.
xholic signals update-agent	--agent-id --changes	Change a Signals agent’s audience, sources, rubric or schedule.
xholic signals set-status	--agent-id --status	Pause or resume a Signals agent.
xholic signals dashboard	None	Every Signals agent with its status, sources, last run and lead counts, plus the month’s scoring quota and any ready-made or product agent that needs a rebuild.
xholic signals search-profiles	--q	Search X accounts by name or handle to watch in a Signals agent (Profile or Followers sources).
xholic signals source-details	--usernames --list-ids	Names and avatars for X accounts and X lists a Signals agent watches.
xholic signals create-ready-made	None	Create the one-click Signals agent built from the account’s context and tested searches.
xholic signals rebuild-ready-made	--id --keep-targeting	Refresh the ready-made Signals agent from the account’s current context.
xholic signals expand-ready-made	--id	Top the ready-made Signals agent up to the paid plan’s size with more searches from the profile, keeping its current ones.
xholic signals dismiss-expand	--id	Hide the offer to add more searches to the ready-made Signals agent, for good.
xholic signals rebuild-product-agent	--id	Rebuild a product’s Find customers agent after the product changed.
xholic signals run-agent	--id	Queue a Signals agent to search for leads now instead of waiting for its schedule.
xholic signals runs	--limit	Recent Signals agent runs, newest first, with what each found and scored.
xholic signals agent-brief	--id	One Signals agent’s weekly brief: themes, questions and competitors its leads talk about, with the people and posts behind each.
xholic signals market-brief	None	The weekly brief across all of the account’s Signals agents: one view of what the market asks for and who to reply to.
xholic signals products	None	The account’s products, each with its Find customers agent (and build progress) and competitors.

Competitors

Command	Flags	What it does
xholic competitors list	--product-id --discover	A product’s competitors, optionally discovering new ones.
xholic competitors add	--product-id --entry	Add a competitor to a product.
xholic competitors discover	--product-id	Find a product’s competitors and add them as suggestions to accept or dismiss.
xholic competitors set-status	--product-id --competitor-id --status	ACCEPTED keeps a suggested competitor; DISMISSED removes any competitor.

Contacts

Command	Flags	What it does
xholic contacts list	--list-id --search --minimum-score --intent --limit	Contacts and lists: search, filter by score or intent.
xholic contacts export	--list-id --search	Contacts in a list as data.
xholic contacts add-to-list	--list-id --handle	Add an X account to a contact list by handle.
xholic contacts add	--list-id --creator-id	Add a person Xholic already has (by X user id, e.g.
xholic contacts update	--id --status --note	Change a contact’s status (NEW, SAVED, CONTACTED, DISMISSED) or its note.
xholic contacts remove	--id	Remove a contact from its list.
xholic contacts save-note	--creator-id --id --note	Add a note about a person, or edit one by passing its id.
xholic contacts delete-note	--id	Delete a note about a person.
xholic contacts search-profiles	--q --list-id	Search X accounts by name or handle to add to a contact list.
xholic contacts profile	--id --lead-id	Everything Xholic knows about one person: profile, lists, notes, engagement with the account, DMs and, with leadId, why they were found as a lead.
xholic contacts follower-import	None	Whether the account’s own followers have been imported into Contacts, and the latest import’s progress.
xholic contacts import-followers	None	Queue an import of the account’s own X followers into Contacts.
xholic contacts imports	None	X list imports into contact lists, with their progress.
xholic contacts import-x-list	--list-id --url	Queue an import of a public X list’s members into a contact list.
xholic contacts cancel-import	--id	Stop a running X list import.

Audience

Command	Flags	What it does
xholic audience dataset	--source --source-id --usernames --open-dms-only	Collect a post’s repliers, quoters or reposters, or an X list’s members, as people you can filter, research and message.

Ask Xholic

Command	Flags	What it does
xholic ask start	--task --model	Hand a long job to Xholic’s own agent, e.g.
xholic ask task	--task-id	Status and answer of a job started with ask_xholic or draft_with_xholic.
xholic ask conversations	--search --cursor --limit --status	The user’s past Ask conversations, newest first, with search and paging.
xholic ask conversation	--id	One Ask conversation with its messages and drafts.
xholic ask catalog	None	Ask’s models the plan can use, its built-in skills (playbooks) and the user’s custom skills.
xholic ask create-skill	--title --description --prompt --model	Save a reusable Ask skill: a named prompt the user can run again.
xholic ask update-skill	--skill-id --title --description --prompt --model	Replace a custom Ask skill’s title, description, prompt and model.
xholic ask delete-skill	--skill-id	Delete a custom Ask skill.

Action catalog

Command	Flags	What it does
xholic actions find	--query --limit	Search everything Xholic can do (about 150 actions) and the docs.

Docs

Command	Flags	What it does
xholic docs read	--path	Read a page of the Xholic docs by path, e.g.

Scheduler

Command	Flags	What it does
xholic scheduler get-settings	None	The account’s scheduler settings: timezone, posting window, quote fallback and default post automations with saved templates.
xholic scheduler update-settings	--timezone --automation	Replace the scheduler timezone and default post automations (with templates).
xholic scheduler set-posting-window	--timezone --posting-window	Set the hours of the day posts may go out at, or clear it with null.
xholic scheduler set-quote-fallback	--timezone --quote-unavailable-action	Choose what happens when a scheduled quote post’s original is gone at publish time: post without the quote, or fail the post.
xholic scheduler lookup-quote	--url	Preview the X post behind a URL before quoting it: author, text, time and media.
xholic scheduler parse-time	--input --timezone	Turn words like “tomorrow 9am” or “next friday at noon” into an exact ISO time in the account’s timezone.
xholic scheduler schedule-view	--tag-ids --timezone --days --start-date	The posting calendar day by day: scheduled posts, open slots and best times, for up to 42 days.
xholic scheduler dashboard-summary	None	What needs attention in the scheduler: failed posts, failed automations and what’s coming up next.
xholic scheduler acknowledge-alert	--kind --post-id --rule-id	Mark a failed post or failed automation alert from scheduler.dashboard_summary as seen so it stops showing.
xholic scheduler best-times	--timezone --slot-count --window-start-minutes --window-end-minutes	The best upcoming times for this account to post, from when its audience engages.
xholic scheduler list-slots	None	The account’s weekly posting slots that “next slot” scheduling fills.
xholic scheduler replace-slots	--slots	Replace every weekly posting slot with this list.

Tags

Command	Flags	What it does
xholic tags list	None	The account’s post tags (name, color, id).
xholic tags create	--name --color	Create a post tag.
xholic tags import-starter	None	Add Xholic’s starter tag set (missing ones only).
xholic tags update	--tag-id --name --color	Rename a tag or change its color.
xholic tags delete	--tag-id	Delete a tag.

Composer

Command	Flags	What it does
xholic composer rewrite	--text --instruction --context --mode --max-characters	Only when the user explicitly asks for Xholic’s rewriter.
xholic composer originality	--parts --source-text	Only when the user explicitly asks.
xholic composer mention-suggestions	--q --remote	X accounts matching a partial handle, from Xholic’s data first.

Remix

Command	Flags	What it does
xholic remix generate	--tweet-id --closeness --custom-instructions --remix-action --max-length --product-id --product-context-intent --current-draft	Only when the user explicitly asks for Xholic’s remixer.
xholic remix select-draft	--remix-id --index	Switch a remix to another of its drafts.
xholic remix post	--remix-id --remixed-text	Post a remix to X now, optionally with edited text.
xholic remix history	--cursor --limit	Past remixes with their source posts and drafts, newest first.
xholic remix list-presets	None	The account’s saved custom instructions for remixing.
xholic remix create-preset	--label --instruction	Save a named custom instruction for remixing.
xholic remix update-preset	--preset-id --label --instruction	Change a remix preset’s label and instruction.
xholic remix delete-preset	--preset-id	Delete a remix preset.

Collections

Command	Flags	What it does
xholic collections list	None	The user’s saved-post collections with counts.
xholic collections create	--name --emoji	Create a collection for saved posts.
xholic collections hooks	None	Get the user’s Hooks collection (for saved hook ideas), creating it if it doesn’t exist.
xholic collections move	--tweet-id --collection-id	Put a saved post in a collection, or take it out with collectionId null.
xholic collections reorder	--ordered-collection-ids	Set the display order of collections, by id.
xholic collections rename	--id --name --emoji	Rename a collection or change its emoji (null removes it).
xholic collections delete	--id	Delete a collection.

Articles

Command	Flags	What it does
xholic articles list	--status --search --limit --cursor	The account’s X Articles (drafts, scheduled, published), newest first.
xholic articles create	--title	Start a new X Article draft with a title.
xholic articles eligibility	None	Whether the X account can publish Articles (X requires Premium) and why not.
xholic articles cover-usage	None	How many AI article covers are left today and this period.
xholic articles get	--id	One article with its title, subtitle, document, assets, status and version.
xholic articles update	--id --title --subtitle --document --version	Save an article’s title, subtitle or body.
xholic articles delete	--id	Delete an article from Xholic.
xholic articles duplicate	--id	Copy an article into a new draft.
xholic articles ai-run	--id --kind --model --instructions --selected-text --cover-style --source-asset-id	Only when the user explicitly asks for Xholic’s article AI.
xholic articles create-asset-upload	--id --kind --filename --mime-type --byte-size --width --height --alt-text	Start an image upload for an article cover or inline image.
xholic articles finalize-asset	--id --asset-id	Mark an article image upload finished after the bytes were PUT to the upload URL.
xholic articles import-klipy	--id --kind --type --slug --alt-text	Copy a KLIPY GIF or meme (from media.browse_klipy) into an article as its cover or an inline image.
xholic articles delete-asset	--id --asset-id	Remove an image from an article.
xholic articles schedule	--id --scheduled-at --timezone --version	Schedule an article to publish on X at a time.
xholic articles publish	--id --version	Publish an article to X now.
xholic articles cancel-schedule	--id	Take a scheduled article out of the queue; it stays a draft.

Contact lists

Command	Flags	What it does
xholic contact-lists list	None	The account’s contact lists with member counts, including which one is the close-accounts list.
xholic contact-lists create	--name --description	Create a contact list.
xholic contact-lists rename	--id --name	Rename a contact list.
xholic contact-lists delete	--id	Delete a contact list and its memberships.
xholic contact-lists set-close-accounts	--id --enabled	Turn a list into the account’s close-accounts list (people whose posts Home and Engage surface first), or turn that off.

Direct messages

Command	Flags	What it does
xholic dm dashboard	None	Direct messages at a glance: sender state (paused, stopped, needs reconnect), today’s usage and limits, active campaigns and unread replies.
xholic dm preview-recipients	--type --tweet-url --include-replies --include-reposts --keyword --exclude-messaged-for-post --continuation --query --handles --list-id --list-url --days --skip-queued --skip-cooldown	Find people to message from a post’s repliers, a search, handles, an X list, recent interactions or a contact list, with whether each can be messaged.
xholic dm quick-send	--name --message-template --confirmed-consent --recipients	Send one message to up to 500 people found with dm.preview_recipients, paced safely from the user’s X account.
xholic dm control-queue	--action	PAUSE_ALL holds every queued DM, RESUME_ALL continues, CANCEL_ALL_PENDING cancels everything not sent yet, ENABLE_SENDING turns DMs back on after a stop.
xholic dm stop-all	None	Emergency stop: cancel every pending DM and stop sending until turned back on with dm.control_queue ENABLE_SENDING.
xholic dm campaigns	--status --limit --offset	The account’s DM campaigns with status and totals, newest first.
xholic dm create-campaign	--name --contact-list-id --delivery-mode	Create a draft DM campaign for a contact list.
xholic dm campaign	--id	One DM campaign: steps, variants, schedule, rules and totals.
xholic dm update-campaign	--id --name --delivery-mode --contact-list-id --steps --schedule --rules	Replace a draft campaign’s settings: send the whole draft (read it with dm.campaign first).
xholic dm control-campaign	--id --action	PAUSE or RESUME a running campaign, or CANCEL_PENDING to cancel its unsent messages.
xholic dm delete-campaign	--id	Delete a DM campaign that hasn’t launched.
xholic dm review-campaign	--id	Check a draft campaign before launch: who can be messaged, who is skipped and why, missing variables, and the outreach guidelines the user must accept.
xholic dm launch-campaign	--id --confirmed-consent	Launch a reviewed campaign: its messages start sending on its schedule.
xholic dm preview-campaign	--id --offset --limit --step-position --variant-label --generate-ai-line	Render a campaign step’s message for a few recipients exactly as it will be sent.
xholic dm duplicate-campaign	--id	Copy a campaign’s steps and settings into a new draft.
xholic dm campaign-recipients	--id --status --step --q --limit --offset	A campaign’s recipients with each one’s status, step and reply.
xholic dm campaign-stats	--id	How a campaign is doing: sent, replied, interested and booked, by step and A/B variant.
xholic dm export-campaign	--id	A campaign’s recipients and results as CSV.
xholic dm today	None	Messages from ASSISTED campaigns ready for the user to send by hand today, with the rendered text and a link to each person’s DMs.
xholic dm mark-assisted-sent	--id	Record that the user sent an assisted DM by hand.
xholic dm undo-assisted-sent	--id	Put an assisted DM back in today’s queue within a minute of marking it sent.
xholic dm skip-recipient	--id	Skip one person in a campaign so they aren’t messaged.
xholic dm cancel-recipient	--id	Cancel a DM that is queued but not sent yet.
xholic dm inbox	--lead-status --campaign-id --unread --limit --offset	DM conversations with replies, newest first, with each person’s lead status.
xholic dm thread	--creator-id	The full DM conversation with one person.
xholic dm update-conversation	--creator-id --lead-status --unread	Set a conversation’s lead status (e.g.
xholic dm reply	--creator-id --text	Send a DM reply in a conversation from the user’s X account.
xholic dm suggest-reply	--creator-id	Have Xholic’s AI suggest a reply in a DM conversation.
xholic dm lists	None	Contact lists available for DM campaigns, with sizes, custom fields and how many can be messaged.
xholic dm estimate-import	--source --filters --max-profiles	Estimate how many profiles an import (followers, following, keyword posters, X list, post engagers or handles) would bring in and what it uses of the plan’s import pool.
xholic dm queue-import	--source --filters --max-profiles --list-id --new-list-name	Queue an import of X profiles into a contact list for DM campaigns.
xholic dm import-csv	--csv --handle-column --field-map --list-id --new-list-name	Import handles and custom fields from CSV text (up to 200 KB) into a contact list.
xholic dm imports	--list-id	Lead imports with their progress, optionally for one list.
xholic dm cancel-import	--id	Stop a running lead import.
xholic dm settings	None	Default delivery mode, schedule and rules for new campaigns, the assisted daily limit and opt-out phrases.
xholic dm update-settings	--defaults --assisted-daily-limit --opt-out-phrases	Replace the DM settings: send all of them (read them with dm.settings first).
xholic dm suppressions	--q --limit --offset	People the account will never DM.
xholic dm suppress	--creator-id --reason	Add a person to the do-not-message list and cancel their pending DMs.
xholic dm bulk-suppress	--handles --reason	Add many handles to the do-not-message list at once and cancel their pending DMs.
xholic dm unsuppress	--creator-id	Remove a person from the do-not-message list.
xholic dm inbound-rules	None	Keyword rules that DM people automatically when they message or reply with a word like GUIDE.
xholic dm create-inbound-rule	--keyword --reply-template --active	Add a rule that automatically DMs replyTemplate to anyone who sends the keyword.
xholic dm update-inbound-rule	--id --keyword --reply-template --active	Replace a keyword rule’s keyword, reply or active state.
xholic dm delete-inbound-rule	--id	Delete a keyword rule.

Home

Command	Flags	What it does
xholic home feed	None	The account’s Home: overview numbers, the welcome drafts after sign-up, and up to five ranked cards for today (mentions to answer, leads, queue gaps, posts taking off, trends).
xholic home card-action	--workspace-id --key --type --action --tweet-ids	Mark a Home card done, dismiss it, snooze it or restore it, by the key and type home.feed returned.
xholic home welcome-action	--workspace-id --action --position	Act on the welcome drafts shown after sign-up: dismiss-message hides the intro, dismiss-draft or restore-draft one draft by position, retry rebuilds drafts that failed.

Settings

Command	Flags	What it does
xholic settings account	None	The signed-in Xholic user’s account: name, email, avatar and whether their main X login is still connected.
xholic settings reply-preferences	None	The account’s custom rules for reply drafts (what every Xholic reply writer must follow).
xholic settings update-reply-preferences	--custom-rules	Replace the account’s custom reply rules.
xholic settings about-you	None	The account’s About You settings as Stark shows them: the free-text description, selected topics and tones.
xholic settings set-account-type	--override	Tell Xholic whether the account is a person, a brand or a topic page, which changes the voice every writer uses.
xholic settings suggest-interests	None	Suggest About You topics from the account’s recent posts.
xholic settings personalization	None	The account’s audience override, style vocabulary override and global rules that every writer reads, plus the generated style guide.
xholic settings update-personalization	--audience-override --style-vocabulary-override --global-rules	Replace the audience override, style vocabulary override and global rules.
xholic settings regenerate-style-guide	None	Rebuild the account’s writing style guide from its posts and style creators.
xholic settings style-creators	None	The up to 3 creators the account writes like (favourite creators), with the current count.
xholic settings search-style-creators	--q	Search X creators to write like, by name or handle (at least 2 characters).
xholic settings add-style-creator	--creator-id	Add one creator to write like (up to 3).
xholic settings save-style-creators	--creator-ids	Replace the creators to write like with this list (up to 3).
xholic settings usage	--days	The user’s external X data usage per feature over the last few days (default 30).
xholic settings quota	--details	What the plan allows today per feature and how much is used.

Billing

Command	Flags	What it does
xholic billing status	None	The user’s plan and subscription state, including trial dates.
xholic billing details	None	The billing details on file for the subscription.
xholic billing payments	None	Past payments and invoices.
xholic billing credit-packs	None	The AI credit packs the user can buy and their prices.
xholic billing trial-eligibility	None	Whether a checkout would still include the free trial for this user.

Sharing

Command	Flags	What it does
xholic sharing list	None	Who the user shared their X accounts with and which accounts others shared with them, with roles and pending invites.

Free tools

Command	Flags	What it does
xholic free-tools profile-report	--handle --report --timezone	A free report on any public X account.
xholic free-tools shadowban-check	--handle	Check whether a public X account looks shadowbanned or limited in search, replies and suggestions.
xholic free-tools trend-regions	None	The regions X trends are available for, with their region slugs for x_trends.
xholic free-tools trends	--region	What is trending on X in a region right now (from Xholic’s recent snapshot).
xholic free-tools read-thread	--url	Unroll an X thread from the link to any of its posts into one readable piece, with its media.
xholic free-tools card-preview	--url	Show how a link will look as a card on X (title, description, image, card type) and what is missing from its tags.
xholic free-tools post-media	--tweet-url --type	Get download links for the video, GIF or images in a public X post.
xholic free-tools username-check	--handle	Whether an X username is available, with similar available suggestions when it is taken.
xholic free-tools x-id-convert	--input	Convert between an X username and its numeric user id, in either direction.
xholic free-tools follower-count	--handle	The current follower and following counts of a public X account.
xholic free-tools account-worth	--handle	An estimate of what a public X account is worth, from its followers, views and engagement on recent posts.
xholic free-tools engagement-calculator	--followers-count --impressions --likes --replies --reposts --quotes	Calculate engagement rates from numbers you already have (followers, impressions, likes, replies, reposts, quotes).