Appearance

Commands ​

This page contains a reference for all supported commands.

In addition to this reference, you can use hxtransfer help [COMMAND] from within the CLI to see the help description for your installed version.

TIP

Most commands support the --json option to allow the output to be easily parsed. We recommend any scripts that rely on output values from the command to use this flag instead of parsing the command output.

Command Index ​

hxtransfer auth ​

Show authentication information.

USAGE
  $ hxtransfer auth [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show authentication information.

hxtransfer config ​

Show current configuration.

USAGE
  $ hxtransfer config [--json]

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show current configuration.

hxtransfer download ID [DESTINATION] ​

Download a transfer by ID.

USAGE
  $ hxtransfer download ID [DESTINATION] [--json]

ARGUMENTS
  ID           Transfer ID (case-insensitive prefix match)
  DESTINATION  [default: .] Destination folder or file output path

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Download a transfer by ID.


  Downloads a specific file by ID to the given destination path.

hxtransfer help [COMMAND] ​

Display help for hxtransfer.

USAGE
  $ hxtransfer help [COMMAND...] [-n]

ARGUMENTS
  COMMAND...  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for hxtransfer.

hxtransfer request ID ​

Show details of an existing sharing request.

USAGE
  $ hxtransfer request ID [--json]

ARGUMENTS
  ID  Request ID (case-insensitive prefix match)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show details of an existing sharing request.

hxtransfer request create SUBJECT ​

Create a new sharing request.

USAGE
  $ hxtransfer request create SUBJECT [--json] [-d <value>] [-e <value>]

ARGUMENTS
  SUBJECT  Subject

FLAGS
  -d, --deadline=<value>        Request deadline (format: yyyy/MM/dd HH:mm)
  -e, --deadline-epoch=<value>  Request deadline (epoch time)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Create a new sharing request.

hxtransfer request download ID [DESTINATION] ​

Download received files from an existing sharing request.

USAGE
  $ hxtransfer request download ID [DESTINATION] [--json] [--force]

ARGUMENTS
  ID           Request ID (case-insensitive prefix match)
  DESTINATION  [default: .] Destination folder

FLAGS
  --force  Skip confirmation prompt.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Download received files from an existing sharing request.


  All uploaded files for the sharing request will be downloaded to the given destination folder.
  Files that already exist will be skipped, unless --force is specified.

hxtransfer request edit ID ​

Edit settings of an existing sharing request.

USAGE
  $ hxtransfer request edit ID [--json] [-a] [--clear-deadline] [-d <value>] [-e <value>] [-s <value>]
    [--unarchive]

ARGUMENTS
  ID  Request ID (case-insensitive prefix match)

FLAGS
  -a, --archive                 Archive the request
  -d, --deadline=<value>        Set request deadline (format: yyyy/MM/dd HH:mm)
  -e, --deadline-epoch=<value>  Request deadline (epoch time)
  -s, --subject=<value>         New request subject
      --clear-deadline          Remove the request deadline
      --unarchive               Unarchive the request

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Edit settings of an existing sharing request.

hxtransfer request exportkey ID ​

Export keys for an existing sharing request to enable file download from a browser.

USAGE
  $ hxtransfer request exportkey ID [--json]

ARGUMENTS
  ID  Request ID (case-insensitive prefix match)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Export keys for an existing sharing request to enable file download from a browser.

hxtransfer request files ID ​

Show received files of an existing sharing request.

USAGE
  $ hxtransfer request files ID [--json]

ARGUMENTS
  ID  Request ID (case-insensitive prefix match)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show received files of an existing sharing request.

hxtransfer request importkey ID KEYFILE ​

Import keys for an existing sharing request to enable file download.

USAGE
  $ hxtransfer request importkey ID KEYFILE [--json]

ARGUMENTS
  ID       Request ID (case-insensitive prefix match)
  KEYFILE  Path to backup file created by the web application

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Import keys for an existing sharing request to enable file download.

hxtransfer request list ​

List active requests.

USAGE
  $ hxtransfer request list [--json] [--archived]

FLAGS
  --archived  Show archived requests.

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List active requests.

hxtransfer send ID ​

Show details of an existing transfer.

USAGE
  $ hxtransfer send ID [--json]

ARGUMENTS
  ID  Transfer ID (case-insensitive prefix match)

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Show details of an existing transfer.

hxtransfer send files [FILES] ​

Send one or more files.

USAGE
  $ hxtransfer send files [FILES...] [--json] [-c <value>] [-d <value>] [-e <value>] [--generate-password]

FLAGS
  -c, --count=<value>      Maximum download count
  -d, --desc=<value>       [default: Secure Files 02/06/2025] Transfer description
  -e, --exp=<value>        Expiry duration (days)
  --generate-password

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Send one or more files.

ALIASES
  $ hxtransfer send file

hxtransfer send list ​

List active transfers.

USAGE
  $ hxtransfer send list [--json] [-e <value>]

FLAGS
  -e, --expiredDays=<value>  Expired days to include

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  List active transfers.

hxtransfer send message [MESSAGE] ​

Send a secure message, either by specifying the message as a command argument or reading data from stdin.

USAGE
  $ hxtransfer send message [MESSAGE] [--json] [-c <value>] [-d <value>] [-e <value>] [--generate-password] [-s
    <value>]

ARGUMENTS
  MESSAGE  Message body (will be read from stdin if empty)

FLAGS
  -c, --count=<value>      Maximum download count
  -d, --desc=<value>       [default: Secure Message 02/06/2025] Transfer description
  -e, --exp=<value>        Expiry duration (days)
  -s, --subject=<value>    [default: Secure Message] Message subject
  --generate-password

GLOBAL FLAGS
  --json  Format output as json.

DESCRIPTION
  Send a secure message, either by specifying the message as a command argument or reading data from stdin.

ALIASES
  $ hxtransfer send msg

hxtransfer version ​

USAGE
  $ hxtransfer version [--json] [--verbose]

FLAGS
  --verbose  Show additional information about the CLI.

GLOBAL FLAGS
  --json  Format output as json.

FLAG DESCRIPTIONS
  --verbose  Show additional information about the CLI.

    Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.