Install the CLI

curl -fsSL https://artifacts.tonbo.dev/install.sh | bash

Verify:

artifacts --version
# artifacts version 0.0.1-dev

What the installer does

1. Platform detection

   Refuses anything that isn't linux-x86_64. v0 ships only this target; macOS and arm64 are on the v1 roadmap. The Mac can still be used as a staging source for Import data.

2. fuse3 install

   Detects fusermount3 in PATH. If missing, installs fuse3 via the host's package manager (apt-get, dnf, yum, apk). Uses sudo if available; falls back to error if not root and no sudo.

3. Binary download + verification

   Resolves the latest commit SHA from https://artifacts.tonbo.dev/release/latest-main, downloads the matching binary + .sha256 sidecar, verifies the checksum.

4. Install to PATH

   Drops to /usr/local/bin/artifacts (root) or ~/.local/bin/artifacts (non-root). Prints a PATH hint if ~/.local/bin isn't already on $PATH.

Pinning a version

ARTIFACTS_VERSION=8edb2181e222 \
  curl -fsSL https://artifacts.tonbo.dev/install.sh | bash

Use this for reproducible CI builds or to match what's running in production.

Custom download host

Self-hosted / staging clusters expose their own copy of the installer and binaries:

ARTIFACTS_DOWNLOAD_HOST=https://artifacts-staging.example.com \
  curl -fsSL https://artifacts-staging.example.com/install.sh | bash

Manual install

If you can't pipe to bash (locked-down host, audit policy):

SHA=$(curl -fsSL https://artifacts.tonbo.dev/release/latest-main)
curl -fsSL "https://artifacts.tonbo.dev/release/$SHA/artifacts" -o /tmp/artifacts
curl -fsSL "https://artifacts.tonbo.dev/release/$SHA/artifacts.sha256" -o /tmp/artifacts.sha256
echo "$(cat /tmp/artifacts.sha256)  /tmp/artifacts" | sha256sum -c -
chmod +x /tmp/artifacts
sudo mv /tmp/artifacts /usr/local/bin/artifacts
sudo apt-get install -y fuse3