stax 0.96.0

Fast stacked Git branches and PRs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

# Install

The shortest path on macOS and Linux:

```bash
brew install cesarferreira/tap/stax
```

Or with [`cargo binstall`](https://github.com/cargo-bins/cargo-binstall):

```bash
cargo binstall stax
```

Both `stax` and the short alias `st` are installed.

## Prebuilt binaries

From [GitHub Releases](https://github.com/cesarferreira/stax/releases/latest):

```bash
# macOS (Apple Silicon)
curl -fsSL https://github.com/cesarferreira/stax/releases/latest/download/stax-aarch64-apple-darwin.tar.gz | tar xz
# macOS (Intel)
curl -fsSL https://github.com/cesarferreira/stax/releases/latest/download/stax-x86_64-apple-darwin.tar.gz | tar xz
# Linux (x86_64)
curl -fsSL https://github.com/cesarferreira/stax/releases/latest/download/stax-x86_64-unknown-linux-gnu.tar.gz | tar xz
# Linux (arm64)
curl -fsSL https://github.com/cesarferreira/stax/releases/latest/download/stax-aarch64-unknown-linux-gnu.tar.gz | tar xz

mkdir -p ~/.local/bin
mv stax st ~/.local/bin/
```

Ensure `~/.local/bin` is on your `PATH`:

```bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc   # or ~/.bashrc
```

## Windows

Download `stax-x86_64-pc-windows-msvc.zip` from [Releases](https://github.com/cesarferreira/stax/releases/latest), extract `stax.exe` and `st.exe`, and place them on your `PATH`. See [Windows notes](../reference/windows.md) for shell and tmux limitations.

## Native macOS app

The native GUI is published as a separate artifact on the same GitHub Release as the CLI. It is not a new crates.io package, and installing it does not change or enlarge the `stax` and `st` CLI binaries.

Apple Silicon:

```bash
curl -fLO https://github.com/cesarferreira/stax/releases/latest/download/Stax-aarch64-apple-darwin.zip
ditto -x -k Stax-aarch64-apple-darwin.zip .
mv Stax.app /Applications/
```

Intel:

```bash
curl -fLO https://github.com/cesarferreira/stax/releases/latest/download/Stax-x86_64-apple-darwin.zip
ditto -x -k Stax-x86_64-apple-darwin.zip .
mv Stax.app /Applications/
```

Download only from the project [GitHub Releases page](https://github.com/cesarferreira/stax/releases/latest). For an unsigned release, Control-click `/Applications/Stax.app`, choose **Open**, then choose **Open** again. If Gatekeeper still blocks the first launch, open **System Settings → Privacy & Security** and choose **Open Anyway** for Stax. Do not disable Gatekeeper globally. Signed and notarized releases open normally.

Launch the welcome window from Finder or Spotlight, or open a repository directly with `st gui [path]`. The app bundle id is `com.cesarferreira.stax`.

## Build from source

Requires Rust and system OpenSSL (Debian/Ubuntu: `libssl-dev pkg-config` · Fedora/RHEL: `openssl-devel` · Arch: `openssl pkg-config`).

```bash
cargo install --path . --locked
```

Without system OpenSSL:

```bash
cargo install --path . --locked --features vendored-openssl
```

## Verify and onboard

```bash
stax --version
st setup --yes       # shell integration, AI skills, and auth from gh (if available)
st cli upgrade       # later, upgrade via the install method you used
```

For native shell completion, evaluate or install the generated script. For example:

```bash
source <(st completions bash)
source <(st completions zsh)
st completions fish | source
# PowerShell
st completions powershell | Out-String | Invoke-Expression
# Elvish
eval (st completions elvish | slurp)
```

Next: [Quick start →](quick-start.md)