Cloudreve CLI

A command-line client for Cloudreve. File operations, transfers, shares, and account management with cloudreve-cli or cr.

Linux · macOS · Windows · Standalone binaries · Text and JSON output

Important

Under active development. Features and interfaces may change. Stay tuned for updates.

Command reference · Contributing · Releases · MIT

Install

mise use -g github:cloudreve/cli@1.0.0

Download an archive for direct installation. Each release includes both executable names and SHA-256 checksums. No separate Node.js or Bun installation is required.

Usage

cr auth login --server https://cloud.example --email you@example.com
cr ls /my/
cr mkdir /my/Documents
cr cp local:./report.pdf /my/Documents/
cr cp /my/Documents/report.pdf local:./downloaded.pdf

Passwords are prompted securely. Remote paths start at /my/; local paths use local:.

Output

Example listing:

$ cr ls /my/
Modified times: UTC
TYPE        SIZE  MODIFIED          NAME
dir            —  2026-09-20 09:41  Documents/
file     2.3 MiB  2026-09-20 09:42  report.pdf
file     1.5 KiB  2026-09-20 09:43  notes.md

--json returns structured output. --no-prompt disables interactive prompts.

Browser login · development builds

cr auth login --server https://cloud.example

The browser returns directly to a temporary local callback. No code copying is required. Browser and CLI run on the same computer; --no-open prints the URL instead. This requires a server with the built-in Cloudreve CLI OAuth application enabled and is not included in CLI 1.0.0.

Password login supports OTP and supplied CAPTCHA answers through --secrets-stdin. Interactive CAPTCHA is handled in the browser.

Compatibility

Cloudreve ≥4.17.0 and <5. trash empty requires 4.18.0 or later.

Development

mise install
mise run setup
mise run check
mise run release:build

---

Cloudreve · Foundation · SDK · CLI