Install

tonic is distributed as a CLI binary. The current project status is alpha, so prefer pinning versions in automation.

Shell (Linux)

curl -fsSL https://tonic.fairlabs.dev/install.sh | sh

The installer verifies the release checksum and installs to ~/.local/bin. Pin a version or change the destination with environment variables:

curl -fsSL https://tonic.fairlabs.dev/install.sh | TONIC_VERSION=0.11.0 TONIC_INSTALL_DIR=./bin sh

Update a shell-installed binary with:

tonic update

The command reports when tonic is already current. Homebrew and Nix installations must be updated through their package manager.

Homebrew

brew tap fairlabs/tap https://forgejo.fairlabs.dev/fairlabs/homebrew-tap.git
brew install tonic

Nix Profile

nix profile install git+https://forgejo.fairlabs.dev/fairlabs/tonic.git

Run without installing:

nix run git+https://forgejo.fairlabs.dev/fairlabs/tonic.git

Verify

tonic --version
tonic --help

The release build injects the current version. Local source builds may report dev (alpha).

Next Step

Start with a local SQLite target so you can exercise the command surface without provisioning a remote database.

tonic connections add sqlite scratch --path ./scratch.db --local
tonic query ping --target scratch