Install the CLI

The Loomta CLI (loomta) wraps the public API as a small, JSON-in/JSON-out command set — built for shell scripts and AI agents as much as for humans.

Requirements

• Node.js ≥ 20

Install

npm

npm install -g @loomta/cli

pnpm

pnpm install -g @loomta/cli

This installs the loomta binary on your PATH.

Verify

loomta --version
loomta --help

--help lists every command group. Then authenticate and confirm the key works:

loomta auth:login
loomta auth:status
# → { "status": "authenticated", "source": "file", "connectedPlatforms": 1 }

Colon or space — your choice

Every command works in both forms: loomta posts:create ≡ loomta posts create. The colon form is convenient for agents; the space form reads like normal subcommands. This documentation uses the colon form.

How output works

• stdout is always a single JSON document — pipe it straight into jq.
• Diagnostics (login progress, etc.) go to stderr, so they never corrupt the JSON on stdout.
• Failures print { "error": { "code", "message", "details" } } to stderr and exit with code 1.

loomta platforms:list | jq -r '.platforms[].id'

Next

• Authentication — the three ways to log in.
• Command reference — every command and flag.
• Recipes — end-to-end publishing workflows.