← All toolsVision & Controlcomputer_controlAll editions

RUN_TERMINAL_COMMAND

CRITICAL: ALWAYS use this tool when the user asks to open the terminal, or run a command in the terminal! This will visibly open the built-in holographic terminal in the UI. If the user just says 'open terminal', pass an empty string.

Parameters

NameTypeRequiredDescription
commandstringyesThe shell command to type into the terminal. Can be empty string to just open it.

How to use it

You normally trigger this by describing what you want in chat — the agent selects RUN_TERMINAL_COMMAND automatically. For example:

Try saying
“use computer control to run …”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "computer_control",
  "action": "RUN_TERMINAL_COMMAND",
  "args": {
    "command": "…"
  },
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"RUN_TERMINAL_COMMAND","args":{"command":"…"}}'

Part of the computer_control plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.