dosya.dev from your terminal.

# Upload a file to a workspace
$ dosya upload ./render-final.mp4 -w ws_abc123
render-final.mp4 [████████████████████████████████] 100% | 12.4 GB/12.4 GB | 245.0 MB/s
Uploaded: file_8xk2m9p4

# Upload an entire folder recursively
$ dosya upload ./project-assets/ -w ws_abc123 --recursive --parallel 5
Uploading 147 files...
Done. 147 uploaded, 0 failed.

# Download a file (8 parallel connections by default)
$ dosya download file_8xk2m9p4 -o ./downloads/
File: render-final.mp4 (12.4 GB)
render-final.mp4 [████████████████████████████████] 100% | 12.4 GB/12.4 GB | 389.0 MB/s | 32s
Saved to ./downloads/render-final.mp4
Done. 12.4 GB written (8 connections).

# Use 16 connections for maximum speed
$ dosya download file_8xk2m9p4 -c 16

# Resume an interrupted download automatically
$ dosya download file_8xk2m9p4
Resuming download: 4.2 GB/12.4 GB already downloaded

# Two-way sync a local folder with a workspace folder
$ dosya sync add ~/Documents ws_abc123:Docs
Added sync pair a1b2c3: /Users/you/Documents <-> ws_abc123:Docs (two-way)

# Preview the plan, then run it
$ dosya sync run --dry-run
[a1b2c3] plan: 12 action(s)
  upload-new    designs/logo.svg
  download-new  notes/todo.md
$ dosya sync run
[a1b2c3] applied 12, 0 conflict(s), 0 failure(s)

# ...or keep it live
$ dosya sync watch
Watching /Users/you/Documents <-> ws_abc123 (two-way). Press Ctrl+C to stop.

# Backup-only: never let the cloud delete your local files
$ dosya sync add ~/Pictures ws_abc123:Photos --mode push-safe

# Generate a share link
$ dosya share file_8xk2m9p4 --password "secret" --expires 7d
https://dosya.dev/s/xK9m2pQ4
Expires: 4/24/2026

# Get JSON output for scripting
$ dosya share file_8xk2m9p4 --json
{
  "ok": true,
  "link": { "url": "https://dosya.dev/s/rT5n8wL2", ... }
}

# List workspaces
$ dosya workspace list
ID              NAME                    STORAGE
ws_abc123       Brand Campaign 2026     234.0 GB
ws_def456       Client Deliverables     12.0 GB
ws_ghi789       Research Data           1.20 TB

# List files in a workspace
$ dosya ls ws_abc123
NAME                    SIZE        MODIFIED    ID
render-final.mp4        12.4 GB     2h ago      file_8xk2m9p4
brand-guide.pdf         45.0 MB     1d ago      file_3mn7k2q9
assets/                 -           3d ago      fld_9xp4r2w1

# Search across files, folders and shares
$ dosya search "invoice"
Files:
NAME              SIZE       MODIFIED   ID
invoice-q3.pdf    240.0 KB   2h ago     file_8xk2m9p4

# Reference files by path - no ids required
$ dosya info reports/2026/invoice-q3.pdf
Name:      invoice-q3.pdf
Size:      240.0 KB
Version:   3
Shares:    1

# Your folder tree and storage at a glance
$ dosya usage
Plan:    pro
Storage: 234.0 GB / 1.0 TB  (23%)

# Favourite the things you reach for most
$ dosya star reports/invoice-q3.pdf
Starred 1 item(s).

# Deletions go to the trash - and come back
$ dosya rm old-draft.pdf
Deleted 1 item(s) (recoverable).
$ dosya trash restore old-draft.pdf
Restored 1 file(s).

# Every file keeps a version history
$ dosya upload invoice-q4.pdf --version-of invoice-q3.pdf
$ dosya versions invoice-q3.pdf
invoice-q3.pdf - current version 4
VERSION  SIZE       UPLOADER   CREATED
4 *      241.0 KB   you        just now
3        240.0 KB   you        2h ago

# Create a new workspace
$ dosya workspace create --name "Q3 Campaign"
Created workspace: Q3 Campaign (ws_new789)

# Invite a team member
$ dosya member invite --email alice@company.com --role Admin -w ws_abc123
Invited alice@company.com as Admin

# Move, copy and make folders - by path, no ids needed
$ dosya mkdir releases/2026
Created releases/2026/ (fld_9xp4r2w1)
$ dosya mv render-final.mp4 releases/2026
Moved 1 item(s).
$ dosya cp brand-guide.pdf releases/2026
Copied to brand-guide.pdf (file_3mn7k2q9)

# Delete (goes to the trash, recoverable)
$ dosya rm old-draft.pdf
Deleted 1 item(s) (recoverable).