stax 0.86.3

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

# stax.tmux

[**stax.tmux**](https://github.com/cesarferreira/stax.tmux) is a TPM-compatible plugin that puts your stack in the tmux status bar and adds keybindings for common actions.

![stax.tmux in action](../assets/tmux.png)

## Features

- **Live status bar** — branch, stack position, PR number, and CI state; auto-refreshes in the background
- **Keybindings** — `prefix + S` popup, `prefix + ]`/`[` navigate up/down the stack, `prefix + M-s` sync
- **Window auto-rename** — tmux window title follows the current branch automatically

## Install

### With TPM (recommended)

Add to `~/.tmux.conf`:

```tmux
set -g @plugin 'cesarferreira/stax.tmux'
```

Then press `prefix + I` to install.

### Manual

```bash
git clone https://github.com/cesarferreira/stax.tmux ~/.tmux/plugins/stax.tmux
~/.tmux/plugins/stax.tmux/stax.tmux
```

## Status bar format

```
cesar/fix/refresh-pr-draft-on-sync [1/1] #394  running  15:12
```

| Segment | Meaning |
|---------|---------|
| Branch | Current git branch |
| `[1/1]` | Position in stack |
| `#394` | PR number |
| `running` | CI state |

## Related

- [stax.tmux repository](https://github.com/cesarferreira/stax.tmux)
- [Claude Code](claude-code.md) · [Codex](codex.md) · [Gemini CLI](gemini-cli.md) · [OpenCode](opencode.md)