cli

@medialit/cli

Upload and manage MediaLit files from the terminal.

npm install -g @medialit/cli
medialit login
medialit upload photo.jpg --public

Log in

medialit login

Your browser opens to sign in. If you have more than one app, you choose the app the CLI works with. Run medialit login again to choose a different one.

For a self-hosted MediaLit, pass its URL once. Later commands use the server you last logged in to:

medialit login --endpoint https://medialit.example.com

Without a browser, for example over SSH, use --no-browser and open the printed URL on another device whose browser can reach this machine's 127.0.0.1.

In CI, skip logging in and set MEDIALIT_API_KEY (and MEDIALIT_ENDPOINT if you self-host).

Commands

Command	What it does
medialit upload <files…>	Uploads and seals files, then prints their URLs
medialit ls	Lists sealed files, newest first
medialit get <id>	Prints a file's URL, a fresh one for private files
medialit seal <id>	Keeps a temporary upload
medialit rm <id>	Deletes a file
medialit whoami	Shows the server, account, app and storage used
medialit logout	Logs out of the server

Uploads are private unless you pass --public. Add --caption <text> or --group <name> to label them, or --temp to leave them unsealed so MediaLit deletes them after 24 hours. Large files are uploaded in chunks and retried if the connection drops.

ls takes --public, --private, --group <name>, --page <n> and --limit <n>.

Every command takes --json. URLs and JSON go to stdout and messages to stderr, so you can pipe the output:

medialit upload report.pdf --public | pbcopy

Where your login is stored

In ~/.config/medialit/credentials.json (%APPDATA%\medialit on Windows), readable only by you. Set MEDIALIT_CONFIG_DIR to use another folder.