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 | shIt 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 shHomebrew
On macOS or Linux, with Homebrew:
brew install yottabot-platform/tap/yottactlbrew 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 | iexIt 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-missingOn 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 loginyottactl 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.