Workspace commands

LibTmux.Workspace 0.0.0-alpha.20 · Source

shell_command_before adds setup for every affected pane. Setup is ordered from session to window to pane, followed by that pane’s shell_command entries.

session_name: commands-example
shell_command_before:
  - printf session-setup
windows:
  - window_name: shell
    shell_command_before:
      - printf window-setup
    panes:
      - shell_command_before:
          - printf pane-setup
        shell_command:
          - cmd: printf ready
            sleep_after: 0.01
          - cmd: printf waiting
            enter: false
            sleep_after: 0

The final command is typed without Enter. Delays are measured in seconds and pause delivery; they do not verify that an application is ready or that an earlier shell command succeeded.

Enter and timing¶

Pane-level enter, sleep_before and sleep_after establish defaults.

Command mappings can change those defaults. An override carries to following commands in that pane until another override. Set an explicit value when later commands need to restore Enter or remove a delay.

History and readiness¶

History suppression prefixes sent commands with a space. The shell still needs its own setting to ignore leading-space commands, such as Bash’s HISTCONTROL=ignorespace or zsh’s HIST_IGNORE_SPACE.

Prompt readiness delays initial input while a shell draws its prompt. It is separate from application readiness and command completion. Use a checked before script for bootstrap work whose exit status must stop the load on failure.

See environment before putting variable expressions in commands.

CLI source.