dropbox-cli

Execute Dropbox operations using the `dropbox` CLI. All Dropbox interactions should use this CLI. The `dropbox` CLI follows this pattern: ```bash dropbox [arguments] [options] ```

Task	Command
List files in a directory	dropbox files ls /Documents
List with details	dropbox files ls -l /Photos
Search for files	dropbox files search "report"
Download a file	dropbox files get /path/to/file.pdf
Upload a file	dropbox files put ./local.pdf /Dropbox/path.pdf
Check recent changes	dropbox files changes --after yesterday
View file history	dropbox files history /path/to/file
Check storage usage	dropbox account usage
</quick_start>

**MANDATORY: Consult the adjacent `usage.json` at `/_repo/skills/-cli/usage.json` before executing ANY `dropbox` command.** This file contains complete command syntax, all arguments, all options, and usage instructions for every command. Never guess at command syntax. - **auth** — Login, logout, check status, refresh tokens, test credentials - **auth** -- Authentication commands and nested `auth profiles` management - **files** — List, upload, download, move, copy, delete, search, history, restore - **folders** — Restore deleted folders and contents - **account** — View account info and storage usage - **sharing** — Inspect, list, and download shared links/folders Use `dropbox auth status --table` or `dropbox auth test` to verify Dropbox auth. Do not use `dropbox files info /` as an auth or API smoke probe: Dropbox `files/get_metadata` does not support root folder metadata. For root content reachability, use `dropbox files ls /` instead. For classic local Dropbox paths under `/Users/adam/Dropbox/...`, do not use macOS `fileproviderctl`; those paths are not File Provider URLs and can return `NSFileProviderErrorDomain Code=-1005` with `No item for URL`. If a local Dropbox file is missing, placeholder-only, or needs to be materialized, map the local path to its Dropbox API path by stripping `/Users/adam/Dropbox`, then use the Dropbox CLI surface from `usage.json`, typically `dropbox files get `. </essential_principles> **`usage.json`** — Complete command tree with arguments, options, defaults, and usage instructions for every command. </reference_index> - Command executes without error - Output is displayed in requested format - Correct command and flags used (verified against usage.json) </success_criteria>