Pane configuration

LibTmux.Workspace 0.0.0-alpha.20 · Source

Each entry in a window’s panes list describes one pane. A string is a command; null leaves a blank shell pane. A mapping provides launch and command settings.

session_name: panes-example
windows:
  - window_name: work
    layout: even-horizontal
    panes:
      - null
      - shell: /bin/sh
        focus: true
        shell_command:
          - printf ready
          - printf second

The second pane launches /bin/sh, receives both commands in order and becomes the active pane. A command list inside one pane does not create extra panes.

Overrides¶

• start_directory overrides the inherited working directory.
• shell overrides the window’s launch command.
• environment supplies the pane’s launch environment map.
• shell_command_before adds setup after session and window setup.
• enter, sleep_before and sleep_after supply command defaults.
• suppress_history overrides the inherited history policy.

Set focus explicitly when automation depends on which pane is selected. Use returned pane IDs for later operations instead of assuming that creation order is a stable tmux ID.

Read commands for Enter and delay behavior and environment for variable handling.

CLI source.