CLI REFERENCE
Connect commands Signatures, flags and examples for recala connect.
On this page Use these commands Connections: the CMS and Search Console.
Examples assume you have signed in and selected the intended organization. Set shell variables such as ARTICLE_ID to ids from the corresponding list command. Set PUBLICATION_TIME to a future local time in YYYY-MM-DDTHH:MM format.
Badges describe the command’s strongest effect; a preview or read-only option may do less. Guarded writes can require confirmation even without --yes . “Needs a person” covers identity, consent and credentials.
Connect Google Search Console: Google sign-in in the browser, then choose the property.
needs a person Acts on an organization
Signature Copy
recala connect gsc [OPTIONS] Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --oauthNo Sign in with Google in the browser (the default path). --propertyNo The property to use, e.g. sc-domain:example.com. --service-accountNo Instead: the email to add as a Restricted user. --checkNo With the service account: connect this property once it was added.
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala connect gsc --oauth Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Publish to Sanity. The write token comes from RECALA_SANITY_TOKEN, --token-stdin or a hidden prompt.
needs a person Acts on an organization
Signature Copy
recala connect sanity [OPTIONS] Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --projectNo Sanity project ID. --datasetNo Dataset (default production). --blog-urlNo The public HTTPS address where articles appear. --authorNo PERSON_ID=SANITY_AUTHOR_ID. Repeat for each author. --token-stdinNo Read the CMS secret from one stdin line; never echoes it.
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala connect sanity Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
The sitemaps Search Console holds for this site: health, errors, and last read.
needs a person Acts on an organization
Signature Copy
recala connect sitemap [OPTIONS] Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use).
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala connect sitemap Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
The CMS (its endpoint and the public site), Search Console and the sitemap, with the next step for each.
read Acts on an organization
Signature Copy
recala connect status [OPTIONS] Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use).
Examples See what is connected: the CMS and Search Console.
Terminal Copy
recala connect status Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .
Publish to WordPress: self-hosted with an application password
needs a person Acts on an organization
Signature Copy
recala connect wordpress [OPTIONS] Replace [OPTIONS] with the flags you need, or omit it.
Scroll horizontally to see all columns →
Flag Required Description --jsonNo Print one JSON document (errors as JSON on stderr). --orgNo Organization name, slug or id (else RECALA_ORG, else recala org use). --siteNo The WordPress site address. --userNo Self-hosted: the WordPress user that publishes. --wordpress-comNo The site is hosted on WordPress.com (also behind your own domain). --wpcom-addressNo With --wordpress-com and your own domain: the *.wordpress.com address. --token-stdinNo Read the application password from one stdin line; never echoes it.
Examples Run in your terminal with the intended organization selected.
Terminal Copy
recala connect wordpress Exit codes: 0 OK1 ERROR2 USAGE3 NOT_AUTHENTICATED4 FORBIDDEN5 NOT_FOUND6 CONFLICT7 INVALID8 RATE_LIMITED9 UNAVAILABLE10 CONFIRMATION_REQUIRED11 PAYMENT_REQUIRED
API commands share the CLI’s HTTP error mapping. Read human and JSON output rules .