For the complete documentation index, see llms.txt. This page is also available as Markdown.

Bash Execute Action

Bash Execute Action

The Bash Execute Action node executes a Unix Bash command on the system running the stream.

It can be used for command-line operations such as retrieving system information, running scripts, managing files and folders, starting external tools, or calling other Unix-compatible applications.

This node is intended for Unix-based systems such as Linux and macOS.

Bash Execute Action

Configurable Settings

Async

Enables or disables asynchronous execution.

Command

The Bash command to execute.

Helmut wildcards can be used within the command.

Example:

Another example:

Paths containing spaces or special characters should be enclosed in quotation marks.

Multiple commands can be combined using standard shell operators.

Example:


Node Result

The command output is returned as the node result and can be accessed using {node.result.?} or {stream.last_result}

For example, when executing:

the result contains the hostname returned by the system.

The returned value can be used by subsequent nodes for conditions, logging, temporary variables, or further processing.


Typical Usage

Another example:

This returns the calculated size of the specified project directory.


Important Notes

  • The command must be compatible with the Bash environment on the executing system.

  • Required command-line tools must be installed and available to the executing user.

  • The executing user must have the necessary permissions for all referenced files, folders, and applications.

  • Quote paths that contain spaces or special characters.

  • Be careful when inserting wildcards containing user-provided values into shell commands.

  • The node does not automatically escape or validate command arguments.

  • Use the Bash Execute With Progress Action instead when a long-running command should update the related job with progress information.

Last updated