focal 0.2.2

Terminal focus library - focus terminal windows and multiplexer panes
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

# focal

Terminal focus library - focus terminal windows and multiplexer panes.

## Features

- **Terminal detection**: Identify which terminal emulator owns a TTY
- **Cross-platform activation**: Bring terminal windows to front (macOS + Linux)
- **Terminal-specific handlers**: Precise tab/pane focusing for iTerm2, Terminal.app, WezTerm, Kitty
- **Multiplexer support**: Switch to the correct tmux/zellij/screen pane

## Usage

```rust
use focal::{focus_session, FocusResult};

// Focus the terminal containing a process
match focus_session(pid, None) {
    FocusResult::Success => println!("Focused!"),
    FocusResult::MuxSwitched { mux, target } => {
        println!("Switched to {mux} {target}");
    }
    FocusResult::NotFound => println!("Terminal not found"),
    _ => {}
}

// With a multiplexer hint (for faster tmux detection)
let _ = focus_session(pid, Some("tmux"));
```

## Supported Terminals

### macOS
- iTerm2 (tab-specific focusing via JXA)
- Terminal.app (tab-specific focusing via JXA)
- WezTerm (pane-specific focusing via CLI)
- Kitty (window-specific focusing via remote control)
- Ghostty (window-specific focusing via JXA)
- Generic terminals (Alacritty, etc.) via osascript

### Linux
- WezTerm (pane-specific focusing via CLI)
- Kitty (window-specific focusing via remote control)
- Ghostty (window-specific focusing via wmctrl/xdotool/swaymsg/hyprctl)
- Generic terminals via wmctrl, xdotool, swaymsg, or hyprctl

## Supported Multiplexers

- tmux
- zellij (planned)
- screen (planned)