Command reference

Colon and space forms are interchangeable (posts:create ≡ posts create). stdout is always JSON; failures print { "error": { "code", "message" } } to stderr and exit 1. Comma-separated lists (-i, -m) take multiple IDs.

Auth

Command	Options	Purpose
auth:login	--api-key <key>, --no-browser, --api-url <url>	Browser device-flow login, or store a key with --api-key.
auth:status	—	Validate the current key; reports source (env/file) and connected platform count.
auth:logout	—	Delete the stored credentials file.

loomta auth:login
loomta auth:login --api-key loomta_sk_xxx
loomta auth:status

See CLI authentication for the full login model.

Platforms

Command	Purpose
platforms:list	List connected accounts and their IDs.
platforms:schema <platformId>	Content/media limits and the settings fields for one platform.

loomta platforms:list
loomta platforms:schema <platformId>

Media

Command	Options	Purpose
upload <file>	--mime-type <type>, --media-type image|video, --folder-id <id>	Upload a local image/video; returns a READY object with an id.
media:list	--folder-id <id|null>, --media-type image|video	List media, optionally filtered.
media:folders:list	—	List media folders.
media:folders:create <name>	—	Create a folder.

ID=$(loomta upload clip.mp4 | jq -r '.id')
loomta media:list --media-type video
loomta media:folders:create "Launch assets"

Note

--mime-type is inferred from the file extension when omitted (.jpg/.jpeg, .webp, .mp4, .webm, .mov). --media-type is inferred from the MIME type. Use --folder-id null in media:list to target the root folder.

Posts

Command	Options	Purpose
posts:create	-c, --content <text> (required), -i, --platform <ids> (required), -m, --media <ids>, --mode draft|now|schedule, -s, --scheduled-for <iso>, --settings <json>	Create a post on one or more platforms.
posts:list	--start-date <iso>, --end-date <iso>	List posts in a date range.
posts:get <postId>	—	Fetch one post group (root + children).
posts:reschedule <postId>	-s, --scheduled-for <iso> (required)	Change a post’s scheduled time.
posts:delete <postId>	—	Delete a post and its group.

# Publish now
loomta posts:create -c "ship day 🚀" -m "$ID" -i "<platformId>" --mode now

# Schedule (mode switches to `schedule` automatically when -s is set)
loomta posts:create -c "later" -m "$ID" -i "<platformId>" -s "2026-07-01T12:00:00Z"

mode + scheduledFor

--mode defaults to now, and flips to schedule automatically when you pass -s. Passing --mode schedule without -s errors with scheduled_for_required. --settings must be a JSON object string.

Slides (AI — spends credits)

Command	Options	Purpose
slides:caption	-r, --request <text> (required), -n, --slide-count <3-10> (required), -l, --language <lang>, --slide-length short|medium|long	Generate a caption + per-slide text for a carousel.
slides:composite	--slides <json> (required), --caption-size small|medium|large	Bake captions onto uploaded images.

loomta slides:caption -r "Why indie devs love our app" -n 4
loomta slides:composite --slides '[{"index":0,"mediaId":"<id>","caption":"Reason 1"}]'

--request is capped at 500 characters; --slide-count must be 3–10. See AI credits.

Global

Flag	Purpose
--version	Print the CLI version.
--help	Print help for the program or a subcommand.

loomta --help
loomta posts:create --help

For the underlying HTTP endpoints these commands call, see the API Reference.