Installation¶

Standalone binary (recommended)¶

No runtime required. The installer downloads the right archive for your platform, verifies its checksum, and puts tx on your PATH:

curl -LsSf https://raw.githubusercontent.com/bgarcevic/tomix-cli/main/install/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/bgarcevic/tomix-cli/main/install/install.ps1 | iex"

Archives for six platforms are on the releases page, checksums included, if you prefer to install manually.

.NET tool¶

If you have the .NET SDK installed:

dotnet tool install -g Tomix.Cli

From source¶

You need the .NET 10 SDK:

git clone https://github.com/bgarcevic/tomix-cli
cd tomix-cli
dotnet build
./tx doctor        # .\tx.ps1 doctor on Windows

./tx wraps dotnet run — it always reflects your current source. To install your build as a real global tool, run ./scripts/install-dev.sh (./scripts/install-dev.ps1 on Windows).

Verify the install¶

tx doctor

doctor checks that your environment is ready and is the first thing to attach to a bug report when something seems off.

Shell completion¶

tx completion bash >> ~/.bashrc          # bash
tx completion zsh                        # zsh
tx completion fish                       # fish
tx completion powershell | Invoke-Expression   # PowerShell