Na semana passada, concluímos o lançamento do Proton Drive SDK, um mecanismo compartilhado projetado para harmonizar o Proton Drive em todas as plataformas e trazer para você os recursos de que precisa mais rapidamente. Hoje, estamos dando o próximo passo: o Proton Drive CLI já está disponível para Windows, macOS e Linux.
O CLI traz o poder do nosso armazenamento em nuvem e da nossa criptografia de ponta a ponta para scripts, backups e pipelines de implantação sem a complicação de escrever código. Ele foi desenvolvido com base no mesmo Proton Drive SDK que equipa nossos aplicativos clientes oficiais do Proton Drive, sendo totalmente interoperável com eles.
Para a nossa comunidade de desenvolvedores: embora estejamos desenvolvendo nosso aplicativo completo para Linux, o CLI já permite criar scripts para muitos dos principais recursos do Proton Drive a partir dos seus ambientes de script favoritos (ou até mesmo agendar tarefas com o cron). O CLI foi desenvolvido para complementar o aplicativo Proton Drive. Ele não substitui o aplicativo por completo — por exemplo, apenas os aplicativos incluem um mecanismo de sincronização completo que roda em segundo plano — mas é uma forma de atingir muitos objetivos a partir de um ambiente de script leve.
O que é o CLI?
Uma interface de linha de comando (CLI) é um programa executado a partir de um shell, como o Terminal, PowerShell ou SSH. Você passa um comando e argumentos, ele faz o trabalho e é encerrado. Como outras ferramentas de linha de comando Unix, você pode usar pipes e scripts com o Proton Drive CLI em conjunto com outras ferramentas em fluxos de trabalho maiores.
O Proton Drive CLI é um único binário que você pode adicionar a esse ambiente. Ele suporta operações comuns do Drive, como listar pastas, enviar e baixar arquivos, gerenciar a lixeira, compartilhamentos ou convites. Por padrão, os resultados são exibidos em texto simples e legível — e se estiver criando automações com base nisso, você pode mudar para um formato legível por máquina usando o parâmetro --json (ou -j).
Como o Proton Drive CLI ajuda?
Até agora, usar o Proton Drive como parte de um fluxo de trabalho automatizado — ao lado de ferramentas como scripts de implantação, tarefas de backup, cron ou runbooks internos — significava fazer tudo manualmente (como abrir o aplicativo ou arrastar arquivos) ou fazer engenharia reversa do funcionamento interno do Drive para escrever scripts personalizados frágeis e difíceis de manter. O CLI muda isso ao permitir que você execute operações do Proton Drive diretamente do terminal. Ele pode, por exemplo, enviar arquivos após o término de um build, fazer o backup de uma pasta de forma programada, convidar um revisor ou verificar o que foi compartilhado.
Isso é especialmente útil quando você precisa que uma ação específica aconteça em um momento específico, em vez de manter as pastas sincronizadas continuamente, como publicar arquivos após um lançamento, capturar um instantâneo (snapshot) de uma pasta compartilhada antes de uma auditoria ou revogar o acesso quando alguém passa pelo processo de desligamento. O CLI executa a operação, informa se deu certo e encerra.
É uma solução natural para quem já trabalha no terminal e para equipes que desejam que seus fluxos de trabalho do Drive sejam registrados como comandos repetíveis, em vez de uma série de cliques difíceis de lembrar.
Primeiros passos com o Proton Drive CLI
No lançamento, o CLI cobre o essencial: iniciar e encerrar sessão, navegar e gerenciar arquivos e pastas (incluindo a lixeira) e gerenciar compartilhamentos e convites.
Alguns fluxos típicos:
proton-drive auth login
# Enviar arquivos do diretório local para uma pasta em Meus arquivos
proton-drive filesystem upload ./reports/* /my-files/Reports --conflict-strategy skip
# Ver quem tem acesso e convidar um colega
proton-drive sharing status /my-files/Reports
proton-drive sharing invite --user [email protected] --role editor --message "Por favor, revise os relatórios" /my-files/Reports
# Baixar para um diretório de backup local
proton-drive filesystem download /my-files/Reports ./backups
Para ver o conjunto completo de comandos e flags, execute proton-drive help ou proton-drive --help. Por exemplo, proton-drive filesystem upload --help.
Saiba mais sobre como usar o Proton Drive CLI.
O que vem por aí
As próximas adições ao Proton Drive CLI incluem suporte para:
- Fotos e álbuns
- Arquivos e pastas compartilhados usando um link público seguro
- Suporte a várias contas para equipes maiores e provedores de serviços gerenciados
Nosso objetivo de longo prazo é trazer tudo o que você pode fazer no aplicativo Proton Drive para a linha de comando.
Baixar o Proton Drive CLI
A maneira mais rápida de começar é baixar os binários pré-compilados para a sua plataforma:
No macOS e Linux, você precisará tornar o arquivo executável após baixá-lo (chmod +x proton-drive). Depois de fazer isso, execute proton-drive version para confirmar o build.
O login é feito pelo seu navegador — sem precisar digitar a senha na linha de comando. Suas sessões são armazenadas com segurança pelo seu sistema operacional (Gerenciador de Credenciais do Windows, as Chaves do macOS ou libsecret no Linux).
Compilar a partir do código-fonte
Prefere compilar a partir do código-fonte? O CLI é implementado em TypeScript, empacotado com o Bun(nova janela) e está disponível para download no repositório do Drive SDK(nova janela). Depois de cloná-lo, você pode instalar as dependências e compilar o CLI a partir do diretório principal:
cd js/cli
bun install
bun run build
./release/proton-drive auth login
./release/proton-drive filesystem list /my-files
Veja o README do CLI no repositório para mais detalhes.
Uso aceitável e limites de taxa
O Proton Drive CLI segue as mesmas políticas de uso aceitável de todos os clientes do Proton Drive. Para se manter dentro dos limites, envie ou baixe apenas o que realmente mudou — não reenvie os mesmos arquivos repetidamente nem grave novamente pastas inteiras se apenas alguns arquivos forem novos. As contas que geram um tráfego extraordinariamente alto são temporariamente limitadas para proteger o serviço de todos.
Agora no seu terminal, com o mesmo nível de privacidade
O Proton Drive CLI já está disponível, e mais recursos serão adicionados em breve. Tudo o que você faz pelo terminal é protegido pela mesma criptografia de ponta a ponta que o restante do Proton Drive. Baixe o CLI, experimente-o e conte para nós o que você desenvolveu. E, se você usa o Linux: um cliente de desktop completo com sincronização está a caminho.
