Skip to main content
These commands read the account around your spaces rather than the memories in them. They call the control plane, which an API key does not reach.

Which credential they need

Every command on this page that sends a request needs the command-line login from anona login --cli, except plain anona usage (your credit balance), which an API key can read too. Only the exports commands take --space. An API key or a temporary profile gets exit 4 with session_required:
If you are signed in with anona login --cli and still get session_required, an API key is set: --api-key, ANONA_API_KEY or ~/.anona/config.env outranks the login. Unset the key, or run the command without it, to use the login. The credential matrix, and the fixed list of routes a CLI login may call, is in Authentication. Your role and organization are read from your membership on every request, so being removed or demoted applies to the CLI within 30 seconds.

Reading the account

usage with no flag is unchanged: your credit balance, which an API key can also read (profile, user-profile, usage). Two flags turn it into a history, and these need anona login --cli:

Invitations

pending lists what is waiting on you, with each invitation’s token. accept prints Joined <org>. (or the space you were given access to); decline prints Declined.. Accepting checks that your signed-in email is the invited address, so a forwarded token does not hand over the seat.

Exports

An export is a downloadable bundle of one space. Only the space’s owner can start one. exports create prints Export <job_id> started.; exports list prints <job_id> <status> <created_at>; exports download saves the file and prints Saved <bytes> bytes to <FILE>.. The file comes from a short-lived download link. If the link has expired or its storage refuses it, the command exits 7 and prints anona: download link expired or refused (HTTP <status>); run download again. Running exports download again asks for a fresh link. --json: create prints {"job_id", "space_id", "status", "created_at"}, list prints {"items": [...], "total"}, and download prints {"job_id", "path", "bytes"}, written by the CLI after saving the file.

Done in the dashboard

Anything that creates, changes or spends is not a CLI command. These print one line to stderr, send nothing, and exit 4: The verb in the sentence (upgrading your plan, renaming the organization, …) follows the command you typed. Any further arguments, and --yes, are accepted and ignored: the command still sends nothing and exits 4. Listing a space’s members is a CLI command: see spaces members list.