# libtmux::NewSessionOptions

- **Module:** libtmux
- **Package:** libtmux-cxx
- **Language:** C++
- **Kind:** struct
- **Source:** https://github.com/libtmux/libtmux-cxx/blob/393d4b0ad666f18a6581f1eb281741a75a7503f0/include/libtmux/entities.hpp#L124
- **Page:** https://libtmux.org/en/cxx/latest/reference/libtmux-newsessionoptions/

What a new session is created as, including its first window.

tmux always creates a first window, so the fields naming one are not optional in effect — leaving them empty takes tmux's defaults rather than creating nothing.

## Members

- `name` (attribute)
- `start_directory` (attribute)
- `first_window_name` (attribute): The name of the window the session starts with.
- `shell_command` (attribute)
- `width` (attribute): The size tmux gives the session while no client is attached.
- `height` (attribute)
- `environment` (attribute): Variables the new process starts with, on top of what tmux passes down.
