# wezterm — vertical tabs

Fork of [wezterm/wezterm](https://github.com/wezterm/wezterm) with a **side tab bar** (left or right), for high-density tab titles without horizontal scrolling.

Implements the feature requested in [wezterm#3537](https://github.com/wezterm/wezterm/issues/3537) (based on [PR #7574](https://github.com/wezterm/wezterm/pull/7574)), plus a small layout tweak for the new-tab control on vertical bars.

![Vertical tab bar](docs/screenshots/vertical-tabs.png)

*Tab bar on the left (`tab_bar_position = "Left"`), full titles, fancy tabs.*

## Config

```lua
local wezterm = require 'wezterm'
local config = wezterm.config_builder()

config.tab_bar_position = 'Left'  -- or 'Right', 'Top', 'Bottom'
config.tab_bar_width = '250px'    -- only used for Left / Right

return config
```

| Option | Values | Notes |
|--------|--------|--------|
| `tab_bar_position` | `"Top"` · `"Bottom"` · `"Left"` · `"Right"` | Default `"Top"`. Left/Right force the fancy tab bar. |
| `tab_bar_width` | e.g. `"200px"`, `"250px"` | Width of the side bar; ignored for Top/Bottom. |
| `tab_bar_at_bottom` | `true` / `false` | Still works when `tab_bar_position` is left at default `"Top"`. |

## Install (Nix flake)

```bash
# build
nix build git+https://tangled.org/nandi.uk/wezterm

# run
nix run git+https://tangled.org/nandi.uk/wezterm

# or from a clone
git clone git@tangled.org:nandi.uk/wezterm
cd wezterm
nix build
./result/bin/wezterm start
```

Default package is GUI wezterm. Upstream-style packaging also lives under [`nix/`](./nix) for comparison.

## Source

| | |
|--|--|
| **This fork** | https://tangled.org/nandi.uk/wezterm |
| **Upstream** | https://github.com/wezterm/wezterm |
| **Docs** | https://wezterm.org/ |

Upstream remains the project of [@wez](https://github.com/wez). This fork only carries the side-tab work until it lands upstream.