LibTmux.Invoke-TmuxPaneCommand

Description#

Run Command in a subshell in the selected pane and return a native LibTmux.PaneRunResult . The result records the pane ID, authenticated shell exit status, whether the wait timed out, elapsed time and effective timeout. A nonzero exit status is a result, not a cmdlet error. The command does not change the parent shell's working directory or environment.

A timeout returns TimedOut = True and a null ExitStatus ; the command may still be running. Cancellation after dispatch can leave it running too. Inspect the pane before retrying either case. Output contains bounded rendered command output, which may include stdout and stderr together. It is not a byte-exact process stream. Inspect LinesMissed, AnchorLost and omission counts before treating it as complete. Started = False means no start marker was confirmed; it does not prove the command never ran. The default view omits output text. Get-TmuxPaneContent reads the current screen separately.

The pane must be a live, writable POSIX-compatible shell. -WhatIf performs no tmux I/O or input operation. Confirmation identifies the endpoint and pane without displaying Command. A leading space is added to shell input by default; shells configured to ignore space-prefixed history entries may omit it from history. This is best effort.

Notes

Tmux.PaneCommandFailed retains the pane as its target. The core reserves one active command per pane in this process. A timed-out run keeps its reservation until completion or an authenticated pane/server end; a second run is refused while that command may still be active. A borrowed server is never removed.