From antigravity-awesome-skills
Provides rclone command reference and usage guidance for cloud storage operations including upload, download, sync, copy, move, mount, and remote management.
How this skill is triggered — by the user, by Claude, or both
Slash command
/antigravity-awesome-skills:rclone-cliThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use this skill when you need rclone command-line cloud storage manager reference and usage guide. Use this skill whenever the user mentions rclone, or any task involving terminal-based cloud file operations such as upload, download, sync, copy, move, mount, or remote management. Triggers on S3-compatible storage,...
references/bisync.mdreferences/cache.mdreferences/chunker.mdreferences/combine.mdreferences/commands/rclone.mdreferences/commands/rclone_about.mdreferences/commands/rclone_archive.mdreferences/commands/rclone_archive_create.mdreferences/commands/rclone_archive_extract.mdreferences/commands/rclone_archive_list.mdreferences/commands/rclone_authorize.mdreferences/commands/rclone_backend.mdreferences/commands/rclone_bisync.mdreferences/commands/rclone_cat.mdreferences/commands/rclone_check.mdreferences/commands/rclone_checksum.mdreferences/commands/rclone_cleanup.mdreferences/commands/rclone_completion.mdreferences/commands/rclone_completion_bash.mdreferences/commands/rclone_completion_fish.mdUse this skill when you need rclone command-line cloud storage manager reference and usage guide. Use this skill whenever the user mentions rclone, or any task involving terminal-based cloud file operations such as upload, download, sync, copy, move, mount, or remote management. Triggers on S3-compatible storage,...
Rclone is a command-line program to manage files on cloud storage. It is a feature-rich alternative to cloud vendors' web storage interfaces. Over 70 cloud storage products support rclone including S3 object stores, business & consumer file storage services, and standard transfer protocols.
Rclone has powerful cloud equivalents to the unix commands rsync, cp, mv, mount, ls, ncdu, tree, rm, and cat. It preserves timestamps and verifies checksums at all times. Transfers can be restarted from the last good file.
Official resources: rclone.org | Docs | Commands | Install | Forum | GitHub
Before using rclone, verify it is installed:
# Check if rclone is installed
rclone --version
# If not found, run the install script:
# See scripts/install.sh in this skill's directory
sudo -v ; curl https://rclone.org/install.sh | sudo bash
# Or for beta version:
sudo -v ; curl https://rclone.org/install.sh | sudo bash -s beta
For offline/manual installation, use the bundled script at scripts/install.sh.
IMPORTANT: Rclone is extremely powerful and can irreversibly modify or delete data on cloud storage. Pay close attention to the following safety guidelines:
--dry-run first when running sync, move, delete, or purge commands. This shows what would happen without actually doing it.--interactive / -i flag while learning rclone to avoid accidental data loss. It asks for confirmation before each destructive operation.rclone config to store credentials securely, or use environment variables.~/.config/rclone/rclone.conf contains sensitive data — protect it with chmod 600.rclone purge ignores all filters — it deletes everything under the specified path. Use with extreme caution.rclone sync makes dest identical to source — files in dest that are not in source will be DELETED. Always verify with --dry-run first.--rc) should bind to localhost only by default. Exposing it without authentication (--rc-htpasswd) allows anyone to control your rclone instance.--vfs-cache-mode full for safer writes.# Interactive configuration (recommended)
rclone config
# Show current config (redacts secrets by default)
rclone config show
# Show full config including secrets (DANGEROUS — do not share output)
rclone config show --redacted=false
# List configured remotes
rclone listremotes
# Create a remote non-interactively
rclone config create myremote s3 provider=AWS env_auth=true region=us-east-1
# Update existing remote
rclone config update myremote region=us-west-2
rclone subcommand [options] source:path dest:path
Source and destination paths use remote:path syntax. For local paths, just use /path/to/dir.
# List files
rclone ls remote:path # list all objects with size
rclone lsd remote:path # list directories
rclone lsl remote:path # list with size, modtime, path
rclone lsf remote:path # list in flexible format
rclone size remote:path # total size and object count
rclone tree remote:path # tree view
# Copy (does not delete files at destination)
rclone copy /local/path remote:path # local to remote
rclone copy remote:path /local/path # remote to local
rclone copy remote1:path remote2:path # remote to remote (server-side if possible)
# Sync (makes destination identical to source — DELETES extra files at dest)
rclone sync --dry-run /local/path remote:path # ALWAYS dry-run first!
rclone sync -i /local/path remote:path # interactive mode
# Move (copies then deletes source)
rclone move /local/path remote:path
# Delete operations
rclone delete remote:path # delete contents of path
rclone purge remote:path # delete path AND all contents (ignores filters!)
# Check integrity
rclone check /local/path remote:path # compare source and dest
rclone checksum remote:path # verify checksums
rclone cryptcheck crypt:path # verify encrypted remote
# Directory operations
rclone mkdir remote:path # create directory
rclone rmdir remote:path # remove empty directory
rclone rmdirs remote:path # remove empty directories recursively
# Other useful commands
rclone cat remote:path/file.txt # output file to stdout
rclone dedupe remote:path # interactively find/delete duplicates
rclone about remote: # get quota information
rclone version # show version
Filter rules determine which files rclone processes. Always test with --dry-run and -vv.
# Include only specific patterns
rclone copy /src /dst --include "*.jpg"
rclone copy /src /dst --include-from filter-file.txt
# Exclude specific patterns
rclone copy /src /dst --exclude "*.tmp"
rclone copy /src /dst --exclude-from exclude-file.txt
# Use filter rules (preferred when mixing include/exclude)
rclone sync /src /dst --filter "+ *.jpg" --filter "- *"
rclone sync /src /dst --filter-from rules.txt
# Size-based filtering
rclone copy /src /dst --min-size 1M --max-size 10G
# Age-based filtering
rclone copy /src /dst --min-age 7d --max-age 30d
# IMPORTANT: Do NOT mix --include, --exclude, and --filter flags.
# Use --filter exclusively when combining rules.
Filter pattern syntax:
* matches any sequence of non-separator characters** matches any sequence including separators? matches any single non-separator character{a,b} matches pattern alternatives{{regexp}} matches using Go regexp# Verbosity
-v # info level
-vv # debug level (shows filter matches)
--log-level LEVEL # DEBUG|INFO|NOTICE|ERROR
# Safety
--dry-run # preview without doing anything
-i, --interactive # ask before each operation
--ignore-existing # skip files that exist at dest
-I, --ignore-times # transfer all, ignore modtime/size
# Transfer control
--transfers N # parallel transfers (default 4)
--checkers N # parallel checks (default 8)
--bwlimit RATE # bandwidth limit (e.g. 10M)
--max-transfer SIZE # stop after transferring this much
-c, --checksum # use checksum instead of modtime
--size-only # compare by size only
# Performance
--multi-thread-streams N # multi-thread downloads (default 4)
-P, --progress # show real-time progress
# Config
--config STRING # config file path
-C, --no-check-dest # skip dest check on copy
# Basic mount
rclone mount remote:path /mnt/remote
# Recommended mount with caching
rclone mount remote:path /mnt/remote \
--vfs-cache-mode full \
--vfs-cache-max-size 10G \
--vfs-read-chunk-size 128M
# Unmount
fusermount -u /mnt/remote # Linux
umount /mnt/remote # macOS
rclone serve http remote:path # HTTP file server
rclone serve webdav remote:path # WebDAV server
rclone serve sftp remote:path # SFTP server
rclone serve ftp remote:path # FTP server
rclone serve s3 remote:path # S3-compatible server
rclone serve dlna remote:path # DLNA media server
rclone serve restic remote:path # Restic backup backend
rclone serve docker remote:path # Docker registry
# Configure encrypted remote wrapping another remote
rclone config
# Choose "crypt" type, point to an existing remote (e.g., "drive:private")
# Use crypt remote — files are encrypted/decrypted transparently
rclone copy /local/files crypt:path
rclone ls crypt:path
# Check integrity of encrypted files
rclone cryptcheck crypt:path
For in-depth information, consult these reference files:
These files are converted from the official Hugo-based rclone documentation under
testdata/rclone/docs/. Treat any remaining Hugo shortcode or template syntax
as a conversion bug: replace it with normal Markdown, a static table, or an
official URL before relying on it in an answer.
| File | Content | When to read | Official link |
|---|---|---|---|
references/usage.md | Full usage guide: syntax, config, remote paths, options | Understanding advanced rclone behavior | Docs |
references/flags.md | Complete global flags reference | Looking up specific flag options | Flags |
references/filtering.md | Filtering, includes/excludes, patterns | Building complex filter rules | Filtering |
references/rc.md | Remote control / HTTP API | Using rclone's API for programmatic control | RC API |
references/bisync.md | Bidirectional sync between two paths | Setting up two-way sync | Bisync |
references/crypt.md | Encrypted remote configuration | Setting up encrypted cloud storage | Crypt |
references/cache.md | Cache backend and directory caching | Optimizing performance with caching | Cache |
references/chunker.md | Transparent file chunking | Handling large files on limited remotes | Chunker |
references/union.md | Union backend (merge multiple remotes) | Combining multiple storage backends | Union |
references/combine.md | Combine backend (unified namespace) | Unified view of multiple remotes | Combine |
references/hasher.md | Hasher backend for checksum handling | Adding hash support to remotes | Hasher |
references/overview.md | Cloud storage system feature comparison | Comparing provider capabilities | Overview |
references/install.md | Detailed installation instructions | Troubleshooting installation | Install |
references/docker.md | Docker usage guide | Running rclone in Docker | Docker |
references/faq.md | Frequently asked questions | Troubleshooting common issues | FAQ |
references/commands/ | Individual command documentation | Detailed command usage | Commands |
For configuring specific cloud storage providers, read the corresponding file in
references/providers/ when present. Some virtual/backing providers, such as
crypt, cache, chunker, union, combine, and hasher, live as top-level
files in references/ because they are cross-provider backends rather than
single cloud services.
s3.md — Amazon S3 / compatible (Official)drive.md — Google Drive (Official)dropbox.md — Dropbox (Official)onedrive.md — Microsoft OneDrive (Official)azureblob.md — Azure Blob Storage (Official)b2.md — Backblaze B2 (Official)googlecloudstorage.md — Google Cloud Storage (Official)sftp.md — SFTP (Official)webdav.md — WebDAV (Official)swift.md — OpenStack Swift (Official)ftp.md — FTP (Official)https://rclone.org/<name>/For detailed command documentation, read the corresponding file in references/commands/:
rclone_copy.md, rclone_sync.md, rclone_move.md — transfer commandsrclone_mount.md — FUSE mountrclone_serve_*.md — various serve modesrclone_config*.md — configuration managementrclone_bisync.md — bidirectional synchttps://rclone.org/commands/<command>/rclone config # interactive setup wizard
rclone lsd remote: # verify connection works
rclone sync --dry-run -P /home/user/documents remote:backup/documents
# Review dry-run output carefully, then:
rclone sync -P /home/user/documents remote:backup/documents
rclone copy --dry-run -P source_remote:path dest_remote:path
rclone copy -P --transfers 8 source_remote:path dest_remote:path
rclone copy --dry-run remote:backup/documents /home/user/restored
rclone copy -P remote:backup/documents /home/user/restored
rclone copy --bwlimit 10M -P /data remote:backup
# First configure a crypt remote wrapping your storage remote
rclone config
# Then use the crypt remote for all operations
rclone sync -P /sensitive-data crypt:backup
# Add to crontab (daily at 2am):
0 2 * * * rclone sync -P /data remote:backup >> /var/log/rclone.log 2>&1
npx claudepluginhub sickn33/antigravity-awesome-skills --plugin antigravity-bundle-aas-localization-international-growthSync files across cloud storage using rclone. Covers S3, R2, Backblaze, Google Drive, Dropbox, and S3-compatible providers with setup, upload, sync, and listing commands.
Provides rclone setup, configuration, and commands to upload, sync, list, and manage files in AWS S3, Cloudflare R2, Backblaze B2, Google Drive, Dropbox.
Manages Cloudflare R2 S3-compatible object storage in Workers: bucket creation, bindings, uploads/downloads, CORS, presigned URLs, multipart uploads. Fixes R2_ERROR and CORS issues.