Skip to content
OTFotf
All posts

Proton Drive CLI enables encrypted file management across Windows, Mac, and Linux

D
DaveAuthor
8 min read
Proton Drive CLI enables encrypted file management across Windows, Mac, and Linux

Proton’s new Proton Drive CLI lands as a real milestone: a cross-platform, privacy-first command-line tool for managing encrypted cloud storage on Windows, macOS, and Linux, shipped alongside a major re-architecture of the Proton Drive backend. This isn't a half-baked wrapper or limited to Linux die-hards. The binary works natively everywhere, exposes core filesystem and sharing controls, and delivers JSON outputs ready for automation—serving terminal-centric users, devops, and anyone tired of cloud GUIs slowing them down.

The Proton Drive CLI isn’t just another storage tool. For the first time, privacy-conscious teams and automation workflows can interact with end-to-end encrypted cloud storage, from setup to real-world backup logic, using only standard terminals and scripts. That opens doors beyond manual file sync: cron-driven backups, dynamic permission auditing, and custom reporting run cleanly, with cross-platform session management handled out-of-the-box.

What is Proton Drive CLI and why does it matter?

Proton Drive CLI is Proton’s official command-line tool for interacting with their encrypted cloud storage service from any terminal—on Windows, Mac, or Linux. With a single downloadable binary, you get the core features expected of a serious file management CLI: browse directories, upload and download, handle trash, manage sharing/invitations, and get JSON-structured outputs for all of it.

Why this matters:

  • Cross-platform done right: One tool, same UX, for every OS. The team ditched fragmented native codebases in favor of a unified engine, so there’s real parity—no “better on Mac” or “Linux only” caveats.
  • Privacy in the terminal: You’re using Proton Drive because you care about end-to-end encryption. Unlike standard cloud platforms (which require trust-in-the-provider), every file operation via CLI is encrypted all the way.
  • Ready for automation: Structured outputs (--json), consistent commands, and secure session handling mean the CLI fits straight into CI, scheduled syncs, and user-side scripting with zero extra glue.

Per Neowin’s coverage, Proton Drive CLI fills a long-standing hole for automation, bulk movement, and scripting—the fabric that heavy users and teams rely on, but that most privacy-first providers ignore. The launch comes just after a total engine rebuild that reportedly made Drive "3x faster on all platforms," with cryptography now handled up to 4x faster for less heat and battery waste. The CLI inherits this performance and reliability.

For devs and privacy-minded orgs, the takeaway is blunt: Proton’s ecosystem-level encrypted storage is now a first-class platform, not just a web UX.

How to install Proton Drive CLI on Windows, Mac, and Linux

Proton keeps installation predictable: download one CLI binary for your OS, grant execute rights (on Mac/Linux), and run. No arcane dependencies. Official install instructions, according to Neowin, are:

On macOS or Linux:

# Download the binary from Proton’s official source
curl -LO 
# Make it executable
chmod +x proton-drive
# Optionally, move it to /usr/local/bin for system-wide use
sudo mv proton-drive /usr/local/bin/

On Windows:

  • Download the official proton-drive.exe from Proton’s release page.
  • Place it somewhere on your PATH for global use.

Verify installation by running:

proton-drive --help

or, on Windows:

proton-drive.exe --help

Authentication: Your first proton-drive auth invocation launches the browser for secure login, rather than asking for credentials inline. After login, your active session is stored using your OS’s native secrets manager (macOS Keychain, Windows Credential Manager, etc.), so tokens aren’t sitting in plaintext config files or dotfiles.

For builders or packagers who prefer source, Proton provides TypeScript sources and recommends using Bun to build and test before compiling—non-trivial, useful for those auditing the tool but not required for standard use.

Security note: sessions are committed to native storage—no plaintext passwords on disk. This lowers opsec risk compared to CLIs that default to config files or manual token management.

user terminal on Windows, Mac, and Linux piping file uploads to Proton's encrypted Drive,

One codebase. iOS, Android, and web.

The Fitness Kit ships with auth, a database, and a backend already connected — no setup. Live demo at fitness-preview.otf-kit.dev.

See the live demo

What are the key commands and features of Proton Drive CLI?

A command-line tool is only as useful as its verbs and outputs. Proton Drive CLI delivers, exposing file management, sharing, invitation control, and script-friendly outputs. Here’s what lands at launch:

  • Authentication

    proton-drive auth

    Fires up your default browser for login. Session persisted via native system tools (macOS Keychain, Windows Credential Manager, etc.).

  • Uploading local files, skipping duplicates

    proton-drive upload /path/to/local-folder

    Only uploads files not already on Proton Drive—avoids wasted network and charges. Designed for incremental backup patterns.

  • Downloading remote folders/files

    proton-drive download /remote/folder --destination /local/path

    Pulls entire directory trees to local disk. Sync logic lives outside CLI (your script), but the download primitive is fast and predictable.

  • Directory listing and navigation

    proton-drive ls /remote/path/

    List directory contents, ready for piping into further scripts or UI tools.

  • Moving files to trash, basic deletion

    proton-drive trash /remote/file
  • Check sharing status and permissions

    proton-drive share-status /remote/folder

    See who has access, at what level.

  • Inviting a collaborator

    proton-drive invite /remote/folder --email user@domain.com --role editor --message "Let's collaborate"

    Grant edit permissions, add a custom onboarding message. Essential for team or family folders.

  • Export output as JSON
    Add --json to any command to deliver structured output for automation.

    proton-drive ls /remote/path/ --json

    Yields script-ready arrays—no regex needed for parsing.

  • Automation-friendly design
    Every command supports headless use, zero UI dependencies, no forced interactive prompts—matching CI and batch job needs.

Missing? Not for long. Proton confirms that upcoming CLI updates will include direct management for photos (including custom albums), generating secure public sharing links, and multi-account toggle—features usually gated to web UX in other products.

Takeaway: If you automate, backup, or need share-aware storage for a team, these verbs are enough to ship entire workflows without ever touching the Web UI.

How can developers automate tasks using Proton Drive CLI?

If you write scripts or manage cloud jobs, the Proton Drive CLI moves from "nice to have" to "core tool." Its real strength is outputting machine-parsable JSON and chaining file/storage commands just like any other POSIX-style or Windows CLI.

Example: Scheduled backups with file skip

# On Linux/macOS: add to your crontab (edit with 'crontab -e')
0 3 * * * /usr/local/bin/proton-drive upload /home/user/Documents --json >> /var/log/proton-backups.log 2>&1

This script uploads your documents every night at 3am, skipping files already present in Drive, and appends a JSON summary to a log for monitoring—no dupe uploads, no web UI.

On Windows: use Task Scheduler for scheduled scripts You can run a batch or PowerShell script invoking:

proton-drive.exe upload "C:\Users\Me\Documents" --json >> "C:\ProtonBackups\backup.log"

More patterns:

  • Run proton-drive ls --json to get directory listings into your own monitoring pipeline.
  • Script out proton-drive invite commands to batch-onboard collaborators with custom roles, all via CI.
  • Use proton-drive share-status --json to regularly audit sharing permissions and alert if stray users hold edit access.
  • Wrap the download + upload primitives for your own deploy-to-cloud automation logic.

The CLI’s authentication handshake (browser-to-terminal, native token storage) means even automated jobs can renew sessions securely—no token plaintext or unsafe storage. Combine that with cron or scheduled jobs and you’ve got a proper privacy-first backup stack.

Takeaway: Proton Drive CLI is not just for ad-hoc terminal fans. It integrates with the workflows power users already run, with the security model privacy advocates demand.

What are the future updates planned for Proton Drive CLI?

Even if the current verb set is enough for most automated sync and sharing logic, Proton has already revealed major planned updates—backed, per Neowin, by a total Drive engine rewrite under the hood:

  • Photo management and custom albums: Not just storage for documents. The CLI will soon support image organizing, curated photo albums, and likely metadata-based queries—a rare feature for an encrypted storage CLI.
  • Secure public sharing links: Generate links to files and folders, granting access without forcing full folder invites—critical for workflows (send a single doc, not the whole project) and contractors.
  • Multi-account switching: For power users handling both personal and team environments. The CLI will enable switching accounts without logouts or redundant config—think one CLI instance, smooth context hops.
  • More solid collaboration primitives: Beyond invites, expect richer role controls and possible integration with Proton’s AI assistant for file search, summaries, and more.

These features are not science fiction—they’re already confirmed for future CLI versions. Expect the pace to match the Drive SDK revamp that accelerated core storage 3× and simplified cross-OS cryptography.

For anyone who’s had to explain to leadership why a storage CLI matters: these roadmap features close the gap between privacy-focus and real enterprise use.

Closing: What Proton Drive CLI enables

With Proton Drive CLI, privacy-conscious developers finally get first-class, cross-platform command-line access to end-to-end encrypted storage. Install is dead-simple on Windows, Mac, or Linux. File manipulation, sharing management, collaborative invitations, and JSON export for automation are all shipped and production-ready. Official support for scripting, scheduled jobs, and native session security means the CLI is not just another wrapper: it’s a workhorse for orgs who automate.

As Proton Drive’s rebuilt engine powers new features and performance, the CLI stands out as a pillar for encrypted, scriptable cloud workflows—no bloated web UI required. The future is secure, automated, and cross-platform—by default.

cross-platformbackendannouncement
OTF Fitness Kit

Stop wiring. Start shipping.

  • Auth, DB, and backend already connected — no Supabase setup needed
  • iOS + Android + web from one codebase
  • CLAUDE.md pre-tuned + 40+ tested AI prompts included