pcloud-cli

module
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 12, 2026 License: MIT

README

pCloud-cli - pCloud Command Line Interface

Go Report Card

Command line interface to pCloud API written in Go.

Usage

pcloud-cli --help

Run pcloud-cli onboard to set up pCloud-cli and save authorization data to ~/.pcloud.json.

Before running onboarding, configure API and OAuth settings using environment variables or config values:

  • PCLOUD_BASE_URL (or base_url in config)
  • PCLOUD_CLIENT_ID (or client_id in config)
  • PCLOUD_CLIENT_SECRET (or client_secret in config)

Build

To build pcloud-cli binary, clone and run make pcloud-cli.

Installation

Installing pcloud-cli can be done by cloning git repo and running make install.

Usage

Main command help:

Usage:
  pCloud-cli [flags]
  pCloud-cli [command]

Available Commands:
  onboard     Set up pCloud-cli and authenticate.
  file        Actions to manage files.
  folder      Actions to manage folders.
  help        Help about any command
  version     Print the version number of pCloud-cli

Flags:
      --config string   config file (default is $HOME/.pcloud-cli.json)
  -h, --help            help for pCloud-cli
      --token string    bearer token to access API, can be used when not using config file
  -v, --verbose         verbose output for debugging

File sub-command help:

Usage:
  pCloud-cli file [flags]
  pCloud-cli file [command]

Available Commands:
  checksum    Calculate chacksums of file.
  copy        Copy file to another location.
  delete      Delete file.
  get         Get remote file url and download it.
  rename      Rename / Move source file.
  upload      Upload local file to remote folder.

Flags:
  -h, --help   help for file

Global Flags:
      --config string   config file (default is $HOME/.pcloud-cli.json)
      --token string    bearer token to access API, can be used when not using config file
  -v, --verbose         verbose output for debugging

Folder sub-command help:

Usage:
  pCloud-cli folder [flags]
  pCloud-cli folder [command]

Available Commands:
  create      Create folder.
  delete      Delete folder.
  list        List folders in pCloud directory
  rename      Rename / Move folder.

Flags:
  -h, --help   help for folder

Global Flags:
      --config string   config file (default is $HOME/.pcloud-cli.json)
      --token string    bearer token to access API, can be used when not using config file
  -v, --verbose         verbose output for debugging

Directories

Path Synopsis
cmd
pcloud-cli command
internal
cli
sync
Package sync provides a one-way sync engine that mirrors a pCloud directory tree to a local directory.
Package sync provides a one-way sync engine that mirrors a pCloud directory tree to a local directory.
tui
tui/preview
Package preview fetches a remote pCloud file and renders it for display in a terminal viewport.
Package preview fetches a remote pCloud file and renders it for display in a terminal viewport.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL