procmux

TUI utility for running multiple commands in parallel with switchable terminals

TLDR

Launch procmux with default config

$ procmux

Launch with a specific config file

$ procmux --config [path/to/procmux.yaml]

Launch with a config and an override file

$ procmux --config [path/to/procmux.yaml] --config-override [path/to/override.yaml]

Stop a named process via signal

$ procmux signal-stop --name '[process-name]' --config [path/to/procmux.yaml]

Start a named process via signal

$ procmux signal-start --name '[process-name]' --config [path/to/procmux.yaml]

List all configured processes

$ procmux signal-list --config [path/to/procmux.yaml]

SYNOPSIS

procmux [options]procmux signal-command --name name --config file

procmux is a TUI utility for running multiple commands in parallel in easily switchable terminal panes. It is designed to help newcomers to a project browse and run necessary commands while reducing the need to manually manage multiple terminal sessions for long-running processes. Configuration is defined in YAML files.When the signal server is enabled in the configuration, procmux starts an HTTP server that allows processes to be controlled remotely via the signal subcommands. The app supports process filtering, autostart options, descriptions, and meta tags.

PARAMETERS

--config FILE

Path to the procmux YAML configuration file.

--config-override FILE

Path to a YAML file that overrides values in the main config.

signal-start --name NAME --config FILE

Start a named process.

signal-stop --name NAME --config FILE

Stop a named process.

signal-restart --name NAME --config FILE

Restart a named process.

signal-stop-running --config FILE

Stop all currently running processes.

signal-restart-running --config FILE

Restart all currently running processes.

signal-list --config FILE

List all configured processes.

CAVEATS

Processes that rely on interpolation (configured prompt inputs) cannot be started or restarted through the signal subcommands because the required input values are only available inside the interactive TUI.

HISTORY

procmux was created by napisani and is written in Python.