About Cloudinary Shell (cldsh)

A tiny interactive CLI (REPL) to explore and manage your Cloudinary account — folder-style. It supports a comprehensive set of commands including ls, cd, mkdir, upload, download, mv, view, open, info, rm, rm -rf, pwd, lcd, lpwd, tree, url, and config. This tool works seamlessly even with the Cloudinary Free plan.

For developers working with Cloudinary, this CLI offers a streamlined way to interact with assets directly from the terminal. It provides features like tab autocompletion for commands and paths, persistent command history, and detailed asset information such as size, dimensions, and type.

Key Features:

• Familiar Shell-like Prompt: Displays the current Cloudinary folder for intuitive navigation.
• Tab Autocompletion: Speeds up command entry for commands, folders, and flags.
• Persistent Command History: Easily recall previous commands using arrow keys.
• Detailed Listing: ls -l provides size, dimensions, name, and type for assets.
• Asset Management: Supports uploading, downloading, moving, renaming, and deleting assets and folders.
• Interactive Preview: Render images and video thumbnails directly in compatible terminal emulators.
• URL Generation: Easily get CDN URLs for assets, with options for transformations.
• Local Directory Sync: lcd and lpwd commands allow managing your local machine's directory within the shell.
• Tree View: Visualize your Cloudinary folder structure with an ASCII tree.
• Configuration Management: Easily log in, switch between multiple Cloudinary accounts, and manage credentials.

Getting Started:

You can run the CLI without installation using npx cloudinary-shell or install it globally with npm i -g cloudinary-shell and then use the cldsh command.

Prerequisites: Node.js 18+ and a Cloudinary account are required.

Authentication: Supports interactive login, environment variables, and local .env files for secure credential management.