Core Library0.xAPI Reference

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

method libtmux-ts latest

Server.runShell

Run a shell command through tmux and return whatever it printed.

Source and package
Qualified name
Server.runShell
Module
server
Declared in
Server
Package
libtmux
Source
packages/libtmux/src/server.ts
Other languages
Perl Erlang PowerShell Julia Elixir Haskell Common Lisp PythonRuby Lua RustGoJavaC#C++ Swift Kotlin Scala OCaml F# Clojure
runShell( command: string, options?: RunShellOptions, ): Promise<readonly string[]>

Description#

signal and timeoutMs bound this call's own wait; the tmux server owns and runs run-shell itself, decoupled from this client, so neither one stops the command - only this call's own promise settling early.

Requires tmux 3.5 or newer. tmux 3.3a and 3.4 print a clientless run-shell's output to a view-mode pane, so they raise VersionTooLowError; cmd("run-shell", …) runs the command there without its output.

Examples#

const lines = await server.runShell("echo hello");
lines[0]; // "hello"

tmux command#

The tmux commands behind runShell.

tmux C API#

The C declarations in tmux that implement these commands.

In other ports#

Run a shell command through tmux

Equivalents of Run a shell command through tmux in other languages
Language Equivalent
Python libtmux.Server.run_shell
Ruby LibTmux::Server#run
Haskell No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing.
Rust server.Server.run_shell
Go tmux.Server.RunShell
Java io.github.libtmux.Shell.run
C# LibTmux.Server.RunShellAsync
C++ libtmux::Server::run_shell
Swift Server.run(_:in:) types a command into a pane rather than running it on the host
OCaml No direct public OCaml equivalent is recorded for this operation.
Perl No dedicated equivalent in the selected Perl surface. Explicit Server::cmd remains available for native tmux commands.

No equivalent is recorded in Lua, PowerShell, Julia, Erlang, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.

Esc

Type to search.

Reference previewOpen reference