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
mise use -g github:cloudreve/[email protected]
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.
cr auth login --server https://cloud.example --email [email protected] 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:.
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.
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.
Cloudreve ≥4.17.0 and <5. trash empty requires 4.18.0 or later.
mise install mise run setup mise run check mise run release:build
Cloudreve · Foundation · SDK · CLI