Install

The installer

curl -fsSL https://stagetui.com/install.sh | sh

The installer reads your platform, downloads the matching binary from GitHub Releases, and checks its SHA-256 against the checksums.txt of that release. It installs to ~/.local/bin and adds that directory to your PATH when it is missing. It never uses sudo.

Options go after --:

Option	Effect
--version <tag>	Install one release instead of the newest
--dir <path>	Install somewhere other than ~/.local/bin
--no-modify-path	Print the export line instead of editing a profile
--force	Install again over the same version
--uninstall	Remove the binary. The configuration stays

To read the script before you run it:

curl -fsSL -O https://stagetui.com/install.sh
less install.sh && sh install.sh

Note

The Linux binaries are built against glibc. On a musl system such as Alpine, the installer stops and tells you to build from source.

Build from source

You need Bun and git.

git clone https://github.com/nikok6/stage
cd stage
bun install --cwd apps/tui
bun start

bun start runs stage in the current directory. The directory must be a git repository.

To build one binary instead:

bun run build

The binary lands in apps/tui/dist/stage. Copy it anywhere on your PATH.

Update

stage update

The command downloads the installer and runs it against the directory of the binary that runs it. One installation is therefore replaced in place, and a second copy never lands elsewhere on your PATH. The installer owns the download, the checksum and the swap, so a fix reaches you even on a broken version. When the version on disk is the newest one, the installer says so and downloads nothing.

stage update does not touch a shell profile.

First run

Run stage inside a git repository.

cd ~/code/my-project
stage

On the first run, stage looks for a lazygit configuration. If it finds one, it offers to translate it, and it asks one time. Read Coming from lazygit.

Flag	Effect
--theme <id>, -t	Use a theme for this run
--import [path]	Translate a lazygit configuration
--version, -v	Print the version
--help, -h	Print the usage

There is one command, stage update. A flag or a command that stage does not know stops it with an error that names what you typed.

Next

Do Your first review.