Knowledge Base

Command Line

Runs a shell command on the Nodlyn host and captures stdout, stderr, and exit code. Supports PowerShell on Windows and bash/sh on Linux.

When to use

  • Invoke existing CLI tools (git, ffmpeg, python scripts).
  • Run maintenance scripts on the host.
  • Bridge to legacy batch jobs not yet modeled as nodes.

Properties

PropertyTypeDescription
CommandtextExecutable name, e.g. ping, dotnet, python. Required.
ArgumentstextCommand-line args. Supports {{field}} and {{$var.key}} placeholders.
Working DirectorytextProcess start directory, e.g. C:/projects/myapp.
Timeout (seconds)numberKill the process after this limit. Default: 60.
Run via ShelltoggleExecute through the system shell (required for pipes and redirects). Default: on.

Outputs

FieldDescription
exitCodeProcess exit code (0 = success).
stdoutStandard output text.
stderrStandard error text.
timedOuttrue if killed due to timeout.
durationMsExecution time in milliseconds.

Notes

  • Marked Dangerous — validate inputs and use Approval Gates for production writes.
  • On-prem / runtime agent only when the command needs local OS access.
  • Parse stdout with Transform or Condition on exitCode.

See also

Nodlyn Assistant
Ask me anything about Nodlyn
Hi! 👋 I'm the Nodlyn assistant. Ask me about the product, workflow components, connectors, agent runtime, agent capabilities, deployment, and more. If I don't know an answer, I'll point you to our contact form.