Skip to content

major0/proton-cli

Repository files navigation

Proton CLI

A command-line interface for Proton services.

Status: Early development. Core operations work but the tool is not yet stable.

Features

  • Proton Drive — full file management: ls, find, cp, mv, mkdir, rm, share management, volume usage
  • Proton Lumo — AI assistant: interactive chat, project spaces, and a local OpenAI-compatible API server
  • Parallelism — bounded worker pools with shared rate-limit throttling; concurrent directory traversal and block I/O
  • Persistent Bearer sessions — SRP authentication with automatic token refresh; credentials stored in the OS keyring
  • Persistent cookie sessions — browser-based login for services that require cookie-scoped auth (Lumo); automatic cookie refresh
  • Multi-account support — independent service sessions per account; switch with --account
  • Opt-in caching — per-share dirent, metadata, and on-disk block caches; disabled by default, user-configurable
  • CAPTCHA handling — automatic browser-based human verification via chromedp
  • Encrypted-first — raw API objects are the canonical in-memory representation; decryption is lazy and on-demand; decrypted content is never persisted to disk

Installation

Requires Go 1.22+ and Chrome/Chromium (for CAPTCHA during login).

git clone https://github.com/major0/proton-cli.git
cd proton-cli
make build

Platform dependencies

Platform Packages
Ubuntu/Debian libsecret-1-dev
Fedora/RHEL libsecret-devel
macOS None (uses Keychain)

Documentation

License

See LICENSE.

About

Command Line Interface to ProtonDrive

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors