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