Install yottactl

yottactl is YottaBot's command line tool. It signs you in, gives you a token for this API, and has a command for every endpoint here, under yottactl org.

macOS and Linux

curl -fsSL https://yotta.bot/install-yottactl.sh | sh

It installs the newest release in ~/.local/bin, after checking it against the release's checksums. For one version, or another folder:

curl -fsSL https://yotta.bot/install-yottactl.sh | sh -s -- 1.0.0
curl -fsSL https://yotta.bot/install-yottactl.sh | YOTTACTL_INSTALL_DIR=/usr/local/bin sh

Homebrew

On macOS or Linux, with Homebrew:

brew install yottabot-platform/tap/yottactl

brew upgrade yottactl updates it. The formula installs the same signed builds, with shell completion for bash, zsh and fish.

Windows

In PowerShell:

irm https://yotta.bot/install-yottactl.ps1 | iex

It installs yottactl.exe in %LOCALAPPDATA%\Programs\yottactl and adds that folder to your PATH. It needs no administrator rights. Set YOTTACTL_VERSION first for one version.

Download it yourself

The Access Portal's Downloads has every build: choose yottactl in its app picker. Or take a file from https://downloads.app.yotta.bot/yottactl/<version>/:

System File
macOS, Apple silicon yottactl-<version>-darwin-arm64.tar.gz
macOS, Intel yottactl-<version>-darwin-amd64.tar.gz
Linux, x64 yottactl-<version>-linux-amd64.tar.gz
Linux, ARM64 yottactl-<version>-linux-arm64.tar.gz
Windows, x64 yottactl-<version>-windows-amd64.zip
Windows, ARM64 yottactl-<version>-windows-arm64.zip

Each archive holds the one program, yottactl (yottactl.exe on Windows). Put it on your PATH.

Check a download

Every release lists its files' SHA-256 checksums in SHA256SUMS, beside them:

curl -fsSLO https://downloads.app.yotta.bot/yottactl/1.0.0/SHA256SUMS
shasum -a 256 -c SHA256SUMS --ignore-missing

On macOS, yottactl is signed with YottaBot's Developer ID and notarized by Apple; codesign --verify --verbose yottactl shows it. The Windows builds aren't signed yet, as Boo Desktop's aren't.

Sign in

yottactl --version
yottactl login

yottactl login opens your browser at your company's sign-in page, where you approve a code; yottactl keeps the token. Authentication explains the token and how to use it with curl.