CLI command reference

Use flashdrive --help for the top-level list and a command’s --help for its options. These commands use the selected profile and saved workspace or drive unless you supply an explicit global flag.

Task	Command
Sign in / check account / sign out	`flashdrive login`, `flashdrive whoami`, `flashdrive logout`
Check or install an update	`flashdrive update --check`, `flashdrive update`
Read saved settings	`flashdrive config list`
Choose a profile	`flashdrive config use PROFILE`
List or select workspaces	`flashdrive workspace list`, `flashdrive workspace use WORKSPACE_ID`
List, create, or select drives	`flashdrive drive list`, `flashdrive drive create NAME`, `flashdrive drive use DRIVE_ID`
Inspect drive files and capacity	`flashdrive drive usage`, `flashdrive storage`, `flashdrive limits`
Upload files or a folder	`flashdrive upload PATH`, add `--recursive` for a folder
Check or resume a transfer	`flashdrive upload status UPLOAD_ID`, `flashdrive upload resume RUN_ID --wait`
List files or match paths	`flashdrive file list`, `flashdrive file glob PATTERN`
Read text or download a file	`flashdrive file read FILE_ID`, `flashdrive file get FILE_ID DESTINATION`
Create folder paths	`flashdrive folder ensure PATH`
Move or rename a file	`flashdrive document move FILE_ID --to FOLDER_ID --name NAME --expected-revision REVISION`
Search words or a phrase	`flashdrive fulltext QUERY`, add `--phrase` for exact phrases
Search matching lines	`flashdrive grep PATTERN`
Mount / inspect / unmount	`flashdrive mount --at DIRECTORY`, `flashdrive mounts`, `flashdrive unmount DIRECTORY`
Keep dependency paths local	`flashdrive mount-excludes list`, `flashdrive mount-excludes add DIRECTORY`
Check an accepted operation	`flashdrive operation status OPERATION_ID --wait`

Scope a command

Global flags can appear before or after the command:


flashdrive --profile work --drive DRIVE_ID file list

Use --workspace, --drive, or --folder when the task needs that scope. --base-url selects an explicit API origin for the command. See profiles and credentials before using a different connection.

For practical examples, start with installation and first use, uploads, mounted files, or error recovery.