CLI reference
The reachweaver command line, generated from the program’s own argument parser, so it always matches the installed version. reachweaver --help shows the everyday commands, reachweaver --help all lists every command by task and reachweaver COMMAND --help shows one.
Every command is a dry run or a local operation by default. Live publishing needs the owner’s approval of the exact text and the live switches; see the security checklist.
Global options
Section titled “Global options”Put these before the command name.
| Option | Description |
|---|---|
--version |
Print the installed version number (the same as the version command) and exit |
--db DB |
Local persistent SQLite database path (defaults to state/reachweaver.sqlite) |
--accounts ACCOUNTS |
Accounts config path (defaults to config/accounts.json) |
--profile PROFILE |
Profile knowledge base path (defaults to config/profile.json in the workspace); personas, usernames and sign-up details, local only |
--home DIR |
Use this workspace folder (one that carries a .reachweaver-workspace file; create it with workspace –init). Default: the nearest one at or above the current folder |
--plain |
No colour or tables, even in a terminal (the plain text format that scripts rely on) |
All 133 commands
Section titled “All 133 commands”| Command | What it does |
|---|---|
start |
Read-only guide: look at your accounts file, database and queue… |
next |
What to post next: at most 5 concrete steps (your open ideas by… |
help |
Show the everyday commands |
context |
Read-only session start for an agent: version, paths, account… |
describe |
Machine-readable command catalog generated from the parser:… |
connect |
Guided account connection (experimental): a status table of your… |
account-add |
Add one account you own to accounts.json (public details only |
account-remove |
Remove one account entry from accounts.json (keeps… |
account-advisor |
Offline channel shortlist and setup coaching |
profile |
Your private profile: personas (work, family…), a username per… |
account-route |
Which account and username to use for a persona on a network |
account-kit |
Prepare sign-up details for accounts you create yourself: one… |
version |
Print the installed ReachWeaver version |
init |
Initialize local database (not an online account) |
doctor |
Inspect account configuration and missing credentials without… |
health |
Offline readiness per configured account: adapters, credentials… |
workspace |
Read-only: what lives in this folder (config, database, approval… |
ui |
Serve a read-only dashboard of your local state on 127.0.0.1… |
studio |
Open the dashboard and the post composer together on 127.0.0.1,… |
list |
List posts and statuses |
show |
Show exact post text and account metadata for human review |
journal |
Read-only: what was posted, when, where, with which metadata and… |
capabilities |
Offline platform capability/API-approval registry |
registry-age |
Offline age of every dated platform fact in the bundled research… |
completion |
Print a shell completion script for commands, options and fixed… |
mcp-serve |
Experimental: a local MCP server on stdin/stdout for MCP clients… |
idea |
Ideas inbox: save a post idea for later with reachweaver idea… |
draft |
Queue a platform-native text draft for an account (repeat… |
check |
Validate a draft before approval |
repeat-check |
Read-only: have we already shared this video, image, wording or… |
mark-shared |
Record material you shared by hand (manual export, a platform… |
review |
Owner-only guided approval: walk the drafts one by one, oldest… |
approve |
Approve the exact current text |
unapprove |
Withdraw approval: an approved or scheduled post goes back to… |
cancel |
Cancel a draft, approved or scheduled post so it is never sent |
schedule |
Give an approved post a due time (explicit timezone offset) |
media-attach |
Add one image with required alt text to a DRAFT: a local… |
media-detach |
Offline: remove every image attachment from a DRAFT |
ai-declare |
Offline: record your AI-content declarations on a DRAFT: who… |
video-attach |
Offline: bind one local MP4 to a TikTok DRAFT |
video-detach |
Offline: remove the video from a TikTok DRAFT |
youtube-attach |
Attach one local MP4 + upload metadata to a YouTube draft |
youtube-detach |
Remove the video from a YouTube draft |
campaign-check |
Offline evidence/brand/variant checks |
campaign-preview |
Offline per-channel previews: exact text, platform length,… |
campaign-stage |
Idempotently stage verified text variants as drafts |
campaign-export |
Export validated draft pack for manual publishing |
claims-check |
Offline LEXICAL claim grounding of variants vs declared evidence |
review-packet |
Offline: write a NEW private folder with the exact text,… |
review-comment |
Record a co-reviewer’s comment in the packet’s private… |
review-status |
Read-only: reviewer comments per post, STALE when the post… |
publish |
Preview due work |
pause |
Emergency global stop for all live publishing |
resume |
Explicitly lift the emergency stop |
reconcile |
Human-confirm outcome of an uncertain send |
approval-mode |
Show or tighten approval safeguards: human confirmation and keyed… |
calendar-plan |
Propose audience-local times |
calendar-gaps |
Read-only: empty and overloaded slots per account from the local… |
connect-check |
Explicit online, non-publishing account identity check |
postiz-check |
Explicit online, READ-ONLY Postiz integration listing/receipt… |
disconnect |
Stop publishing to one account on this installation: tighten-… |
reconnect |
Lift a local disconnect |
share |
Easy offline handoff: choose social networks, type a caption and… |
posted |
Record a post you made by hand from its link, with its numbers if… |
manual-export |
Offline creator-ready package for Threads/Instagram/Facebook… |
manual-export-batch |
Offline: preflight 1-25 manual-export items as a whole, then… |
delivery-options |
Offline delivery route per distribution-registry channel… |
statusline |
One short read-only line for Claude Code’s status line (version,… |
queue-health |
Offline status, attempts, overdue and uncertain sends, provider… |
dead-letter |
Read-only needs_review posts grouped by sanitized error code +… |
ops-metrics |
Read-only operational counts (claims, failures by send class,… |
ops-summary |
One redacted read-only report: overall readiness, per-account… |
credentials-audit |
Offline credential hygiene: env variable NAMES only, never values |
link-health |
Read-only: broken, redirected or preview-less links in stored… |
trace |
Read-only: everything that happened to one post, oldest first:… |
metrics |
Record one post’s numbers (likes, replies…) that you read in… |
import-metrics |
Import native-analytics snapshots normalized as CSV (all rows or… |
metrics-fetch |
Explicit online, READ-ONLY poll of public Bluesky/Mastodon post… |
report |
Coverage-aware local analytics |
youtube-analytics |
Offline sampling report over stored metric snapshots of published… |
timing-evaluate |
Read-only per-account matched-age outcome analysis |
baseline-eval |
Read-only: personalized slots/variant campaigns/readouts vs… |
insights |
Read-only ‘What works for you’: compares your own published… |
platform-risk |
Read-only multi-homing report: share of your recorded reach per… |
attribution-report |
Read-only UTM/referrer join of local analytics exports |
pilot-report |
Offline per-arm readout of an owner field-pilot CSV log |
peer-benchmark |
Offline: compare your public counters with peers’ public counters… |
suggest |
Read-only ranked human review of profile, posts, SEO, engagement,… |
weekly-digest |
Write suggest (and with –include-db the local report) as one… |
experiment-preregister |
Offline: validate a growth plan and write a NEW hashed… |
experiment-verify |
Offline: detect post-hoc edits by recomputing a plan’s sha256 hash |
experiment-evaluate |
Matched-age, non-causal readout of preregistered post pairs |
experiment-readout |
Read-only: verify a preregistration, map arms to posts, label the… |
experiment-next |
Offline: deterministic next dimension from prior classified… |
experiment-simulate |
Offline SIMULATED label distribution for a seeded synthetic… |
profile-audit |
Offline owner-snapshot, per-platform profile readiness and fix… |
post-audit |
Offline platform-specific creative checks and comparable-age… |
seo-destinations |
Offline canonical landing page + competing-message check |
seo-content-check |
Discoverability checks on owner-supplied post texts (length, alt… |
landing-check |
SEO brief + campaign CTA landing-page checks |
ai-visibility |
AI answer-engine and search visibility of your own pages:… |
utm-link |
Offline canonical UTM-tagged destination URL |
creative-preflight |
Offline editorial checklist for 1-6 draft posts |
voice-profile |
Statistics of how you write, from your own past posts |
voice-check |
Advisory: compare a draft with your voice profile and a heuristic… |
ai-label-check |
Advisory: which AI-content label each target platform asks for… |
eu-review-evidence |
Read-only: who approved each published post, when, the approved… |
media-check |
Offline media manifest checks: headers, platform limits, alt… |
media-storyboard |
Offline: campaign brief -> vertical-video storyboard, SRT… |
media-cutlist |
Offline: one master video -> per-platform cut list (segments that… |
distribution-plan |
Offline regional channel research and hypothetical timing windows |
social-web-plan |
Offline open social web map: which accounts are on ActivityPub,… |
discovery-plan |
Offline platform discovery and topic/hashtag recommendations |
sources-scan |
Rank opt-in GitHub/feed/changelog/DOI source signals |
signal-brief |
Offline: one sources-scan signal -> NEW campaign scaffold +… |
release-brief |
Offline: a saved GitHub release JSON or CHANGELOG section -> NEW… |
creator-match |
Offline creator relevance shortlist from owner-curated public-… |
creator-kit |
Write one NEW private source kit for independent creator… |
creator-coverage |
Offline owner-confirmed creator pickup counts at 48h/7d |
engagement-fetch |
READ-ONLY fetch of public replies (and, with –quotes, Bluesky… |
engagement-triage |
Offline comment/mention triage + reply/issue DRAFTS |
engagement-queue |
Offline aging/SLA review queue over an engagement export |
followup-suggest |
Read-only: when a published post’s exact metric crosses an owner-… |
engage-scout |
Ranked daily shortlist of conversations to join in your own… |
engage-log |
Record which engage-scout items you replied to or skipped, or… |
archive |
Write a private folder with one sub-folder per post: the exact… |
media-relink |
After moving the workspace: point recorded attachment paths of… |
data-export |
Offline JSON export of your local DB with secret-looking text… |
data-purge |
Retention purge plan (dry run) |
privacy-status |
Offline DB permissions, size, row counts, oldest records,… |
schema-validate |
Offline canonical schema check (1.0, 1.1 or 1.2) of one JSON… |
schema-export |
Read-only: local outbox rows as canonical schema JSON lines |
update |
Check GitHub Releases for a newer ReachWeaver skill bundle… |