# LibTmux::Session#list_window_links

- **Module:** LibTmux
- **Package:** libtmux
- **Language:** Ruby
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-ruby/blob/d8ce4bbee0ca7748a81929f81f7d8d07f8c51267/gems/libtmux/lib/libtmux/operations.rb#L264
- **Page:** https://libtmux.org/en/ruby/v0.1.0.alpha.3/reference/libtmux-session-list_window_links/

```
def list_window_links: (
  ?timeout: ::Numeric,
  ?cancel: untyped
) -> ::Array[::LibTmux::WindowLink]
```

Behavior: Live acquisition.

Behavior contract: Live acquisition.

## Examples

Link one window at two more indexes of its session and list the three links that share one window ID. Use Ruby 4.0.7, Bundler, Git and tmux 3.3a or newer on Unix, with /bin/cat and /bin/sh available. In an empty directory, fetch the documented library revision:

```console
$ git clone https://github.com/libtmux/libtmux-ruby.git libtmux-source && \
  git -C libtmux-source checkout d8ce4bbee0ca7748a81929f81f7d8d07f8c51267
```

Save this dependency file as Gemfile:

```ruby
source "https://rubygems.org"

gem "libtmux", path: "libtmux-source/gems/libtmux"
```

Save this complete program as link_window.rb. Its Server.start block owns a private tmux server and stops it on exit, including after an error.

[Source example](https://github.com/libtmux/libtmux-ruby/blob/d8ce4bbee0ca7748a81929f81f7d8d07f8c51267/examples/api/link_window.rb).

```ruby
# frozen_string_literal: true

begin
  # docs:begin main
  require "libtmux"

  LibTmux::Server.start do |server|
    session = server.new_session(name: "links", command: ["/bin/cat"])
    window = session.list_windows.fetch(0)
    session.link_window(window.ref, index: 4)
    session.link_window(window.ref, index: 9)
    links = session.list_window_links
    puts "indexes: #{links.map(&:index).join(', ')}"
    puts "windows: #{links.map { |link| link.window.id }.uniq.join(', ')}"
  end
  # docs:end main
rescue StandardError => error
  warn "#{error.class}: #{error.message}"
  exit 1
end
```

Install the runtime dependencies and run the saved program. An operation or cleanup error makes it exit unsuccessfully:

```console
$ bundle config set --local path vendor/bundle && \
  bundle install --jobs 2 && \
  bundle exec ruby link_window.rb
```

Expected output:

```text
indexes: 0, 4, 9
windows: @0
```

## Parameters

- `timeout` (`::Numeric`)
- `cancel` (`untyped`)