RECALA CLI
CLI reference
Install, sign in and find the command you need. Every command and flag comes from the CLI’s own schema.
On this page
CLI 0.5.1 · 81 commands · Generated from the CLI schema
Each command is marked read, writes or needs a person. Conditional commands use the strongest effect they can have. Guarded writes can require confirmation even without --yes. Read the write confirmation rules.
Install the CLI
curl -fsSL https://recala.co/install.sh | shuv tool install https://recala.co/releases/cli/recala_cli-0.5.1-py3-none-any.whlpipx install https://recala.co/releases/cli/recala_cli-0.5.1-py3-none-any.whlThe script needs uv or pipx. Install uv first if neither is available. With pipx, use Python 3.11 or newer. Install uv. Recala is in beta. Join the beta.
Authentication: keys, scopes and caps →
Sign in with a one-time code
The terminal opens recala.co/cli and prints a code. Sign in to Recala, type that code and approve the request. Return to your terminal to continue.
recala loginCredentials are resolved in this order. There is no command-line token flag; keep credentials out of your shell history.
Scroll horizontally to see all columns →
| Priority | Source | When used |
|---|---|---|
| 1 | RECALA_API_KEY | Environment credential, where organization-key access is enabled. |
| 2 | RECALA_TOKEN | Environment access token, if no API key is set. |
| 3 | Saved login | The session from your one-time sign-in. |
Sign in on a remote machine
recala login --no-browserOpen the printed link on your own device and type the code there.
Choose your organization
Use the organization’s name, slug or id. Save your choice once, or override it for a single command.
recala org use <name>Scroll horizontally to see all columns →
| Priority | Source | Scope |
|---|---|---|
| 1 | --org | This command; for example --org rebeam. |
| 2 | RECALA_ORG | Your shell, script or agent. |
| 3 | recala org use | The choice saved on this machine. |
recala article list --org rebeamList organizations or set a shell default
recala org listRECALA_ORG=rebeam recala article listFind a command group
Top-level commands
Commands you run directly, with no subcommand.
Article
Read, edit, review, approve, schedule and unpublish articles.
Authors
The real people who sign articles.
Autoapprove
Automatic approval for passing drafts and the person who signs them.
Cadence
Publication days, time and autopilot consent.
Cms
Connect your content management system and check its status.
Connect
Connections: the CMS and Search Console.
Index
Check indexing status and submit content for indexing.
Keys
Organization API keys, where key access is enabled. A person’s session manages keys.
Knowledge
The sources Recala writes from.
Org
Choose and show the organization you act on.
Questions
Report
Reports on the company's authority.
Skills
The agent skills that ship with the CLI.
Topics
The topic queue: what Recala proposes to write next.
Read the exit code
Scripts can branch on these stable codes. Read the JSON output contract for error details.
Scroll horizontally to see all columns →
| Code | Name | Meaning | What to do |
|---|---|---|---|
| 0 | OK | Done. | Continue. |
| 1 | ERROR | Unexpected error, or an answer the CLI could not read. | Stop and report error.message to the person. Do not retry a write. |
| 2 | USAGE | Bad flags or arguments. | Fix the command. recala schema --json lists every flag. |
| 3 | NOT_AUTHENTICATED | Not signed in, or the credential was refused. | Stop and ask the person to run recala login. |
| 4 | FORBIDDEN | Your role does not allow it. | Stop and name what is missing. Never look for another way around it. |
| 5 | NOT_FOUND | Not found. | Check the id with a list command. |
| 6 | CONFLICT | Not allowed yet: no organization selected, not ready to schedule, or no person linked. | Fix the precondition the message names, or ask the person. |
| 7 | INVALID | The input was refused. | Read error.message and fix the input. |
| 8 | RATE_LIMITED | Rate limited. | Wait, then retry once. |
| 9 | UNAVAILABLE | Server or network trouble. | Retry a read once. After outcome_unknown, never retry: check the state first. |
| 10 | CONFIRMATION_REQUIRED | Confirmation is missing or was declined. | Nothing was sent. Ask the person to confirm in a terminal or grant this sign-in access. |
| 11 | PAYMENT_REQUIRED | Not allowed to spend: no credits, a cap reached or a blocked topic. | Stop and tell the person. An agent never buys. |