Files
r2client/r2cli/README.md
2025-09-19 21:34:09 -04:00

36 lines
761 B
Markdown

# r2cli
A rudimentary CLI tool for Cloudflare R2-compatible S3 storage, built on the `r2client` Rust library.
## Features
- Upload files to an R2 bucket
- Download files from an R2 bucket
- List files and folders in an R2 bucket
- Delete a file in an R2 bucket
## Usage
Set the following environment variables:
- `R2_ACCESS_KEY`
- `R2_SECRET_KEY`
- `R2_ENDPOINT`
- `R2_BUCKET`
For ease of use within development environments, environment variables will also be sourced from `.env`
### Example commands
```sh
r2cli upload <local_file> <remote_key>
r2cli download <remote_key> <local_file>
r2cli list-files
r2cli list-folders
```
## Requirements
- Rust
- Valid Cloudflare R2 credentials
## Todo
- [ ] If you REALLY feel goofy, a TUI would be pretty sick