Installation

The club CLI is a single native binary built for every major platform. There are four 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. install.sh for Linux/macOS, install.ps1 for Windows.
2. Homebrew — on macOS (and Linux with Homebrew installed), tap this repo and brew install club. Upgrades and uninstall flow through brew like any other formula.
3. Manual download — grab the archive from the releases page and extract it wherever you want. Use this in locked-down environments or when you want to pin a specific version by hand.
4. From source — activate the CLI via dart pub global activate from a cloned repo. Best for local development on the CLI itself.

For CI/CD, see the CI/CD Integration guide — there’s a one-liner GitHub Action that installs the CLI and configures dart pub in a single step.

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 stable one.
--pre	CLUB_PRE	Include pre-releases when resolving the newest version.
--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.

By default the script installs the newest stable release. Pass --pre to include pre-releases.

Examples:

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

# Include pre-releases
curl -fsSL https://club.birju.dev/install.sh \
  | bash -s -- --pre

# 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"

Install script (Windows)

iwr -useb https://club.birju.dev/install.ps1 | iex

The script detects the architecture, downloads the matching .zip from the release, verifies its SHA-256 against SHA256SUMS.txt, and copies club.exe into %USERPROFILE%\.club\bin.

Note

Same caveat as the Unix version — pipe-to-iex runs whatever the endpoint returns. To inspect first: iwr -useb https://club.birju.dev/install.ps1 -OutFile install.ps1; notepad install.ps1; .\install.ps1.

Options

Parameter	Env var	Description
-Version <x>	CLUB_VERSION	Install a specific release (e.g. 0.1.0) instead of the newest stable one.
-Pre	CLUB_PRE	Include pre-releases when resolving the newest version.
-InstallDir <path>	CLUB_INSTALL_DIR	Install to a different directory. Default %USERPROFILE%\.club\bin.
-Repo <owner/name>	CLUB_REPO	Pull from a fork or mirror. Default BirjuVachhani/club.

By default the script installs the newest stable release. Pass -Pre to include pre-releases.

Parameters require direct invocation. When piping to iex, set the matching env var first:

# Pin a version
$env:CLUB_VERSION = '0.1.0'
iwr -useb https://club.birju.dev/install.ps1 | iex

# Or, with the script saved to disk:
iwr -useb https://club.birju.dev/install.ps1 -OutFile install.ps1
.\install.ps1 -Version 0.1.0 -InstallDir "$env:LOCALAPPDATA\Programs\club\bin"

PATH

If the install directory isn’t on PATH yet, the script prints the exact PowerShell line to add it persistently for your user. The default location, %USERPROFILE%\.club\bin, isn’t on PATH out of the box — add it with:

[Environment]::SetEnvironmentVariable(
  'Path',
  "$env:USERPROFILE\.club\bin;" + [Environment]::GetEnvironmentVariable('Path','User'),
  'User'
)

Then open a new terminal.

Homebrew (macOS and Linux)

The club repo doubles as a Homebrew tap. Because the repo is named club (not homebrew-club), the tap URL has to be passed explicitly the first time:

brew tap birjuvachhani/club https://github.com/BirjuVachhani/club.git
brew install club

The formula pulls the prebuilt binary for your platform (macOS arm64/x64, Linux arm64/x64) from the matching GitHub release and verifies its SHA-256.

Upgrade and uninstall with the usual brew commands:

brew update && brew upgrade club
brew uninstall club
brew untap birjuvachhani/club   # if you want to drop the tap too

Note

Credentials written by club login live at ~/.config/club and are not touched by brew uninstall. Delete that directory by hand if you want a clean slate.

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

Use club upgrade:

club upgrade

It resolves the newest stable release, then hands off to the same install script that put the binary there, so the result is identical to re-running the one-liner. Replacing the running binary is safe on every platform.

Options

Flag	Description
--check	Report whether a newer release exists, then exit without installing.
--version <x>	Install this exact version. Accepts 0.4.2 or v0.4.2. Downgrades are allowed and prompt for confirmation.
--pre	Consider pre-release tags when resolving the newest version.
--force	Reinstall when already current, and proceed on a local build.
--dry-run	Print what would be installed and where, then exit.
-y, --yes	Skip the downgrade confirmation.
--install-dir <path>	Override the auto-detected install directory.
--json	Machine-readable output.

Exit codes

Code	Meaning
0	Upgraded, already current, or --check found nothing newer.
65	--check only: a newer version is available.
66	A downgrade needed confirmation but the shell is not interactive. Pass --yes.
69	GitHub was unreachable, or a pinned --version has no build for your platform.
70	The installer ran and failed.
78	This install cannot upgrade itself, or the target directory is not writable.

--check returning 65 follows the git diff --exit-code convention, which trips up CI steps that treat any non-zero code as failure. Prefer --json there:

club upgrade --check --json | jq -e .updateAvailable

Homebrew installs

club upgrade refuses when the binary came from Homebrew, because Homebrew owns its own files. Use brew upgrade instead:

brew update && brew upgrade club

The same applies to dart pub global activate installs and to running from a source checkout, both of which are detected and refused with the right command to run instead.

Pre-releases

club upgrade and both install scripts default to the newest stable release. Pass --pre to any of them to include pre-releases.

Newly published releases

A release is only offered once its build artifacts have finished uploading. Releases are published manually and the build runs afterwards, so a tag can be visible on GitHub for a few minutes before it is installable. During that window club upgrade reports that you are up to date rather than sending you into an installer that would fail. --json reports the pending version as pendingVersion so the state is still visible.

Update notifications

After a command runs, club may print a one-line hint when a newer release exists. It checks at most once every 24 hours and caches the result in ~/.config/club/update_check.json. Set NO_UPDATE_CHECK to turn it off; it is already skipped in CI.

Manual installs

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