Terminal (StackAI Computer)
Run commands in a separate StackAI computing environment. Use Terminal to process files, run scripts, or prepare an artifact for another step.
Before you start
StackAI Computer must be available in your environment. Commands run in its sandbox, not on your own computer.
Run a command
Select Terminal from StackAI Computer. Enter Command and a short Description of its purpose.
Leave Terminal Sandbox ID empty for a new environment, or pass the ID returned by an earlier Terminal call to reuse its files and installed packages.
Run the command and check Exit Code and Success. Read Standard Output for results and Standard Error for diagnostic messages.
Use New Files Created to pass generated files onward. Keep Enable New Files enabled when downstream steps need those files.
Result: Exit code 0 indicates successful command execution. Returned file entries include download links for generated files.
Behavior and troubleshooting
A command can change files before it fails. Check existing files before retrying a command with side effects. Reuse the terminal sandbox ID for related operations; a browser sandbox ID identifies a different environment. If a file is rewritten, use its latest returned download link.
Use Terminal with interface uploads
For a file assistant, connect a Files input to the AI Agent, insert its File URLs reference in the Prompt, and enable File Access. The builder may offer a shortcut that also adds Terminal. Configure the interface to pass that Files input.
Use AI auto-fill for Command when the agent should decide how to inspect or process each request. Tell the agent to read the actual upload before answering and to return real file links. Workflow files are available under /home/user/; save generated files there and keep Enable New Files on for downloads. Commands run in the separate StackAI environment.
Follow Let an agent work with uploaded files for the illustrated setup and use Troubleshoot uploaded files and downloads for practical checks.
Inputs
Description
description
Short description of what this command does.
Command (required)
command
The terminal command to execute.
Terminal Sandbox ID
terminal_sandbox_id
Optional terminal sandbox ID to reuse an existing sandbox.
Configuration
Enable New Files
download_files
Download files created in the sandbox so downstream nodes can use them. Default: true.
Outputs
Standard Output
stdout
The standard output from the command.
Standard Error
stderr
The standard error output from the command.
Exit Code
exit_code
The exit code of the command.
Success
success
Whether the command executed successfully (exit code 0).
Terminal Sandbox ID
terminal_sandbox_id
The ID of the terminal sandbox used for this operation.
New Files Created
new_files
List of new files created during command execution.
Image Data
image_data
Base64-encoded image data from files created during execution.
Related guidance
Was this helpful?