tpane 0.5.2

Configure tmux with Lua.
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

# Plugins

Plugins are loaded from Lua with `tpane.use`.

```lua
tpane.use("sensible")
tpane.use("vim-navigator")
tpane.use("yank")
tpane.use("themes")
```

## Built-in plugins

### sensible

Common tmux defaults:

```lua
tpane.use("sensible")
```

Sets:

```lua
tpane.options {
  escape_time = 0,
  history_limit = 50000,
  display_time = 4000,
  status_interval = 5,
  focus_events = true,
  status_keys = "emacs",
  aggressive_resize = true,
}
```

### vim-navigator

Use Vim-style pane navigation. If the active process looks like Vim, the key is sent to the pane. Otherwise tmux moves panes.

```lua
tpane.use("vim-navigator")
```

Binds `C-h`, `C-j`, `C-k`, and `C-l`.

### yank

Copy-mode bindings for yanking selected text and pane paths.

```lua
tpane.use("yank")
```

### themes

Bundled themes from the iTerm2 Color Schemes collection.

```lua
tpane.use("themes")
tpane.theme("Gruvbox Dark", { transparent = true })
```

List themes:

```sh
tpane themes
```

## Git plugins

Use a git plugin by passing a spec:

```lua
tpane.use("tool", {
  repo = "https://github.com/example/tpane-tool.git",
  branch = "main",
})
```

If the plugin lives in a monorepo:

```lua
tpane.use("tool", {
  repo = "https://github.com/example/tools.git",
  path = "plugins/tpane-tool",
})
```

Manage installed git plugins:

```sh
tpane plugin status
tpane plugin sync
tpane plugin update
tpane plugin clean
tpane plugin list
tpane plugin remove NAME
```