Install¶

tubebrain currently supports seven practical install paths:

• public Pages download mirror
• curl-to-shell installer
• Homebrew formula
• npm wrapper package
• cargo install --git
• cargo install --path .
• nix run

For most users, the public Pages mirror is the cleanest default.

Canonical public download base:

• https://transscendsurvival.org/tubebrain/downloads/latest/

The GitHub release page remains the canonical release record:

• https://github.com/Jesssullivan/tubebrain/releases/latest

curl-to-shell installer¶

curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/install.sh | sh

The installer:

• auto-detects the supported target for the current machine
• downloads the matching mirrored tarball from the Pages mirror
• verifies the tarball against the published SHA256SUMS
• installs tubebrain into ~/.local/bin by default

If you override --repo to point at a private GitHub repository, the installer can still use GH_TOKEN, GITHUB_TOKEN, or gh auth token.

Useful flags:

curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/install.sh | sh -s -- --version v0.1.10
curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/install.sh | sh -s -- --bin-dir "$HOME/bin"

Run curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/install.sh | sh -s -- --help to see the full option surface.

Homebrew¶

Install from the Tinyland tap:

brew tap tinyland/tools https://github.com/tinyland-inc/homebrew-tools.git
brew install tubebrain

The Homebrew formula installs the published binary release rather than building from source.

Fallback if you do not want to add the tap:

brew install --formula https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain.rb

npm wrapper package¶

The repository now includes a publishable npm wrapper package at packages/npm/tubebrain.

That package:

• detects the current supported platform
• downloads the matching tubebrain release artifact
• verifies it against the published SHA256SUMS
• caches the binary locally and then executes it

The wrapper is published to the npm registry as tubebrain under the beta dist-tag while the v0.1.x series stabilizes. The latest dist-tag is reserved for v1.0.

npm install -g tubebrain@beta
npx -p tubebrain@beta tubebrain -- --version

A GitHub Packages mirror publishes the same build as @jesssullivan/tubebrain for redundancy:

npm install -g --registry=https://npm.pkg.github.com @jesssullivan/tubebrain@beta

Tagged releases also attach the packaged .tgz asset as a direct-download fallback for environments without npm registry access:

npm install -g https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-npm-package.tgz
npm exec --yes --package=https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-npm-package.tgz tubebrain -- --version

Release tarballs¶

Latest published binaries are mirrored publicly at:

• https://transscendsurvival.org/tubebrain/downloads/latest/

Published targets:

• aarch64-apple-darwin
• x86_64-unknown-linux-gnu
• aarch64-unknown-linux-gnu

Each release also includes a SHA256SUMS file for checksum verification.

Apple Silicon macOS:

mkdir -p ~/.local/bin && tmpdir="$(mktemp -d)" && curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-aarch64-apple-darwin.tar.gz | tar -xz -C "$tmpdir" && install -m 0755 "$tmpdir/tubebrain" ~/.local/bin/tubebrain

Linux x86_64:

mkdir -p ~/.local/bin && tmpdir="$(mktemp -d)" && curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-x86_64-unknown-linux-gnu.tar.gz | tar -xz -C "$tmpdir" && install -m 0755 "$tmpdir/tubebrain" ~/.local/bin/tubebrain

Linux ARM64:

mkdir -p ~/.local/bin && tmpdir="$(mktemp -d)" && curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-aarch64-unknown-linux-gnu.tar.gz | tar -xz -C "$tmpdir" && install -m 0755 "$tmpdir/tubebrain" ~/.local/bin/tubebrain

Verify:

tubebrain --version

The published tarballs are the official prebuilt distribution channel today.

Verify a Linux tarball against the published checksums:

curl -fsSLO https://transscendsurvival.org/tubebrain/downloads/latest/SHA256SUMS
curl -fsSLO https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-x86_64-unknown-linux-gnu.tar.gz
grep 'tubebrain-x86_64-unknown-linux-gnu.tar.gz$' SHA256SUMS | sha256sum -c -

On macOS, use shasum -a 256 tubebrain-aarch64-apple-darwin.tar.gz and compare the result with the matching line in SHA256SUMS.

Source installs¶

Git:

cargo install --locked --git https://github.com/Jesssullivan/tubebrain tubebrain

Local checkout:

cargo install --path .

Nix:

nix run github:jesssullivan/tubebrain
nix profile install github:jesssullivan/tubebrain

For flake consumers, the repository also exposes overlays.default so you can add tubebrain to a larger Nix configuration without shelling out to nix run.

Requires Rust 1.88+ for source builds.

Platform support¶

The current release workflow publishes and validates these targets on CI:

Platform	Release asset	CI release build	Recommended install path
Apple Silicon macOS	tubebrain-aarch64-apple-darwin.tar.gz	yes	release tarball
Linux x86_64	tubebrain-x86_64-unknown-linux-gnu.tar.gz	yes	release tarball
Linux ARM64	tubebrain-aarch64-unknown-linux-gnu.tar.gz	yes	release tarball

Current support expectations:

• the three published release assets above are the official prebuilt targets
• the installer script selects one of those same published tarballs
• the Homebrew formula installs one of those same published tarballs
• the npm wrapper is designed to bootstrap one of those same published tarballs
• cargo install --git and cargo install --path . are the fallback paths when you are outside those published targets
• Nix is supported as a repo-native execution path
• there is no official Windows release artifact today
• there is no official Intel macOS release artifact today

If you are outside the published targets, treat source builds as best-effort/local-validation paths rather than guaranteed prebuilt distributions.

Upgrade¶

Upgrade a release-tarball install¶

Re-run the same install command you used originally. The new binary will replace the existing one in ~/.local/bin/tubebrain.

Upgrade a curl-to-shell install¶

Re-run the same installer command you used originally:

curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/install.sh | sh

Upgrade a Homebrew install¶

brew update
brew upgrade tubebrain

Upgrade an npm-wrapper install¶

Re-run the same install command you used originally:

npm install -g https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-npm-package.tgz

Apple Silicon macOS:

mkdir -p ~/.local/bin && tmpdir="$(mktemp -d)" && curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-aarch64-apple-darwin.tar.gz | tar -xz -C "$tmpdir" && install -m 0755 "$tmpdir/tubebrain" ~/.local/bin/tubebrain

Linux x86_64:

mkdir -p ~/.local/bin && tmpdir="$(mktemp -d)" && curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-x86_64-unknown-linux-gnu.tar.gz | tar -xz -C "$tmpdir" && install -m 0755 "$tmpdir/tubebrain" ~/.local/bin/tubebrain

Linux ARM64:

mkdir -p ~/.local/bin && tmpdir="$(mktemp -d)" && curl -fsSL https://transscendsurvival.org/tubebrain/downloads/latest/tubebrain-aarch64-unknown-linux-gnu.tar.gz | tar -xz -C "$tmpdir" && install -m 0755 "$tmpdir/tubebrain" ~/.local/bin/tubebrain

Upgrade a Git-based cargo install¶

cargo install --locked --git https://github.com/Jesssullivan/tubebrain tubebrain --force

Upgrade a local-checkout cargo install¶

From the repo checkout you want to install:

cargo install --path . --force

Upgrade a Nix run workflow¶

nix run github:jesssullivan/tubebrain already resolves the requested Git ref at execution time. If you pin a tag or commit, update that ref when you want a new version.

Uninstall¶

Uninstall a release-tarball install¶

rm -f ~/.local/bin/tubebrain

Uninstall a curl-to-shell install¶

rm -f ~/.local/bin/tubebrain

Uninstall a Homebrew install¶

brew uninstall tubebrain

Uninstall an npm-wrapper install¶

npm uninstall -g tubebrain

Uninstall a cargo install¶

cargo uninstall tubebrain

Uninstall a Nix run workflow¶

nix run github:jesssullivan/tubebrain does not create a long-lived installed binary on its own, so there is nothing to uninstall unless you separately added it to a Nix profile.

Packaging posture¶

Official channels today:

• public Pages mirror for the latest release assets
• scripts/install.sh
• release-published Homebrew formula tubebrain.rb
• release-published npm wrapper package tubebrain-npm-package.tgz
• source install from Git
• local checkout install
• nix run github:jesssullivan/tubebrain
• nix profile install github:jesssullivan/tubebrain

Not published today:

• crates.io
• npm registry
• nixpkgs

That means the recommended public install story today is:

1. use the installer script if your platform matches a published target
2. use the Homebrew formula if you want Brew-managed upgrades
3. use cargo install --git or Nix if you need a source-backed path