Workspace commands

TmuxWorkspace 0.1.1 · 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
        sleep_after: 0.01
        shell_command:
          - cmd: printf ready
          - cmd: printf waiting
            enter: false

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 penter, sleep_before and sleep_after establish defaults.

Command mappings can override Enter, and that override carries to following commands. Set delays on the pane; timing fields inside command mappings are refused.

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.