Installation

The club CLI is a single native binary built for every major platform. There are three ways to get it:

1. Install script — one-liner that fetches the right archive for your OS + CPU, verifies the checksum, and drops the binary on your PATH. Works on Linux and macOS.
2. Manual download — grab the archive from the releases page and extract it wherever you want. Use this on Windows, in locked-down environments, or when you want to pin a specific version by hand.
3. From source — activate the CLI via dart pub global activate from a cloned repo. Best for local development on the CLI itself.

Install script (Linux and macOS)

curl -fsSL https://club.birju.dev/install.sh | bash

The script detects your OS (linux / macos) and CPU (x64 / arm64), downloads the matching release archive, verifies its SHA-256 against the release’s SHA256SUMS.txt, and installs the binary to ~/.local/bin/club.

Note

Piping a script into bash is something to think about every time. If you’d rather read it first, download and inspect it before running: curl -fsSLO https://club.birju.dev/install.sh && less install.sh && bash install.sh.

Options

Flag	Env var	Description
--version <x>	CLUB_VERSION	Install a specific release (e.g. 0.1.0) instead of the newest tag.
--install-dir <path>	—	Install to a different directory. Default ~/.local/bin.
--repo <owner/name>	CLUB_REPO	Pull from a fork or mirror. Default BirjuVachhani/club.

Examples:

# Pin to a specific version
curl -fsSL https://club.birju.dev/install.sh \
  | bash -s -- --version 0.1.0

# Install into /usr/local/bin instead of ~/.local/bin
curl -fsSL https://club.birju.dev/install.sh \
  | sudo bash -s -- --install-dir /usr/local/bin

PATH

If the chosen install directory is not on your PATH, the script prints the exact line to add to your shell’s rc file. For the default ~/.local/bin:

zsh

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

bash

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

fish

fish_add_path "$HOME/.local/bin"

Manual download

Every tagged release attaches one archive per supported target plus a single SHA256SUMS.txt:

Target	Archive
Linux x86_64	club-cli-<version>-linux-x64.tar.gz
Linux arm64	club-cli-<version>-linux-arm64.tar.gz
macOS Intel	club-cli-<version>-macos-x64.tar.gz
macOS Apple silicon	club-cli-<version>-macos-arm64.tar.gz
Windows x86_64	club-cli-<version>-windows-x64.zip

Linux / macOS

1. Grab the archive and the checksums file from the latest release:

   VERSION=0.1.0
   TARGET=linux-x64   # or macos-arm64, etc.
   
   curl -fLO "https://github.com/BirjuVachhani/club/releases/download/${VERSION}/club-cli-${VERSION}-${TARGET}.tar.gz"
   curl -fLO "https://github.com/BirjuVachhani/club/releases/download/${VERSION}/SHA256SUMS.txt"

2. Verify the archive:

   shasum -a 256 -c SHA256SUMS.txt --ignore-missing

   You should see club-cli-${VERSION}-${TARGET}.tar.gz: OK.

3. Extract and install:

   tar -xzf "club-cli-${VERSION}-${TARGET}.tar.gz"
   install -m 0755 "club-cli-${VERSION}-${TARGET}/bin/club" ~/.local/bin/club

Windows

1. Download the .zip and SHA256SUMS.txt from the latest release page.

2. Verify the archive in PowerShell:

   Get-FileHash .\club-cli-0.1.0-windows-x64.zip -Algorithm SHA256

   Compare the hash against the line for your file in SHA256SUMS.txt.

3. Extract the zip. Move club-cli-<version>-windows-x64\bin\club.exe somewhere on your PATH (for example, %USERPROFILE%\bin), or add the extracted bin directory to PATH directly.

From source

Useful when you’re hacking on the CLI itself or want to run an unreleased build. Requires the Dart SDK 3.11 or newer.

git clone https://github.com/BirjuVachhani/club.git
cd club
dart pub get
dart pub global activate --source path packages/club_cli

Make sure $HOME/.pub-cache/bin is on your PATH:

export PATH="$PATH:$HOME/.pub-cache/bin"

Note

The repo also ships scripts/build-cli.sh which uses dart build cli to produce a native binary and drops it into ~/.local/bin/club. It’s what the release workflow runs on CI.

Verifying the install

club --version

If you see the version printed, you’re done. Continue to Login & Setup to authenticate against your club server.

Upgrading

Re-running the install script replaces the existing binary:

curl -fsSL https://club.birju.dev/install.sh | bash

For manual installs, repeat the download step with the new version.

Uninstalling

Use the uninstall script that matches how you installed:

curl -fsSL https://club.birju.dev/uninstall.sh | bash

This removes the binary at ~/.local/bin/club and, if present, the bundle directory at ~/.local/share/club. Stored credentials at ~/.config/club are kept by default — pass --purge to delete them too.

Options

Flag	Description
--purge	Also delete ~/.config/club (credentials + config).
--install-dir <path>	Look for the binary here instead of ~/.local/bin. Must match the value you passed to install.sh.
--dry-run	Print what would be removed without deleting anything.

Examples:

# Preview the removal
curl -fsSL https://club.birju.dev/uninstall.sh | bash -s -- --dry-run

# Remove binary + credentials
curl -fsSL https://club.birju.dev/uninstall.sh | bash -s -- --purge

# Uninstall from a custom location
curl -fsSL https://club.birju.dev/uninstall.sh \
  | sudo bash -s -- --install-dir /usr/local/bin

Homebrew

If you installed via Homebrew, uninstall with brew instead — the script only knows about install.sh layouts:

brew uninstall club
brew untap birjuvachhani/club

Manual

If you’d rather do it by hand:

rm -f ~/.local/bin/club
rm -rf ~/.local/share/club   # only if the bundle layout was used
rm -rf ~/.config/club        # credentials — only if you want a clean slate