# libtmux.Session.attach

- **Module:** libtmux
- **Package:** libtmux
- **Language:** Python
- **Kind:** method
- **Source:** https://github.com/tmux-python/libtmux/blob/38e368c11117fb4aeb2f082d552cd4f210eae06a/src/libtmux/session.py#L618
- **Page:** https://libtmux.org/en/py/stable/reference/libtmux-session-attach/

tmux command: [`attach-session`](/en/tmux/latest/manual/attach-session/)

```
libtmux.Session.attach(
    self,
    exit_: bool | None = None,
    flags_: list[str] | None = None,
) -> Session
```

Return [`$ tmux attach-session`](/en/tmux/latest/manual/attach-session/) aka alias: [`$ tmux attach`](/en/tmux/latest/manual/attach-session/).

## Examples

```python
>>> session = server.new_session()
```

```python
>>> session not in server.attached_sessions
True
```

## Parameters

- `exit_` (`bool | None`)
- `flags_` (`list[str] | None`)

## In other ports

### Attach a client to a session

- Rust: [`control.ControlMode.attach`](/en/rs/latest/reference/control-controlmode-attach/) (method)
- Go: [`tmux.Server.AttachSession`](/en/go/latest/reference/tmux-server-attachsession/) (method)
- Java: [`io.github.libtmux.control.ControlClient.ControlClient.attach`](/en/java/latest/reference/io-github-libtmux-control-controlclient-controlclient-attach/) (method)
- C#: [`LibTmux.Server.AttachSessionAsync`](/en/csharp/latest/reference/libtmux-server-attachsessionasync/) (method)
- C++: [`libtmux::Session::attach_command`](/en/cxx/latest/reference/libtmux-session-attach_command/) (method)
