Overview
Install
Shell Script (Linux, macOS and FreeBSD)
curl -fsSL https://download.hop.sh/install | sh
Arch Linux
Use your favourite AUR helper to install the package:
# yay example
$ yay -S hop-cli
Windows
Install with the Hop Windows Installer 64bit or the Hop Windows Installer 32bit
Login
Once installed, you will be able to use the following command to authenticate the CLI with your Hop account. This will open a browser window to login.
hop auth login
If you want to login to the Hop CLI in a headless environment (e.g. without a
browser), then you can provide a Project Token or a PAT using the --token
flag.
Projects
When first logging in, the CLI will execute commands against your default personal project.
Switching Projects
You can switch projects using the following command:
hop projects switch
This will bring up an interface that allows you to use arrow keys to select a project:
$ hop projects switch
Select a project:
> Bunny's Project /bunny project_MjcxMDk5Nzg1MTM1MDYzMTA 2022-06-30T19:25:22.573Z personal
Lanyard /lanyard project_MjcxMjgyNDEyMDc2MjM3NDE 2022-06-30T20:37:56.722Z regular
ganyu /ganyu project_MzAzNjU3MDkyNDI4MDYyODY 2022-07-09T19:02:29.251Z regular
hopvideo.net /hopvideo project_MzA4ODY2MzcxNjEyNzEzMjY 2022-07-11T05:32:28.145Z regular
You can also use hop projects switch <namespace>
to perform the switch
directly.
Project override flag
You can specify --project
on any Hop CLI command to override the currently
selected project for the current command.
More
Use hop help
to view a full list of command categories. You can also use
hop <category> help
for a list of commands within a category.