agent-zero/plugins/_code_execution/prompts/agent.system.tool.code_exe.md

code_execution_tool

run terminal, python, or nodejs commands args:

• runtime: terminal, python, nodejs, or output
• code: command or script code
• session: terminal session id; default 0
• reset: kill a session before running; true or false rules:
• place the command or script in code
• use runtime=output to poll running work
• use input for interactive terminal prompts
• if a session is stuck, call again with the same session and reset=true
• check dependencies before running code
• replace placeholder or demo data with real values before execution
• use print() or console.log() when you need explicit output
• do not interleave other tools while waiting
• treat trailing framework [SYSTEM: ...] info as execution status, not command output; use it to decide whether to wait, reset, rerun, or continue
• probe cwd files tools and dependencies before expensive commands
• split long work into small commands: inspect, prepare, run, verify
• for builds installs servers training and long tests, redirect logs and poll with runtime=output
• after timeout or pause, inspect logs and processes before deciding wait reset or stop
• never claim success from timeout partial output or a still-running command
• stop stale background processes you started before final response
• when exact output matters, verify file path line count bytes and content with commands examples: 1 terminal command

{
    "thoughts": [
        "Need to do...",
        "Need to install...",
    ],
    "headline": "Installing zip package via terminal",
    "tool_name": "code_execution_tool",
    "tool_args": {
        "runtime": "terminal",
        "session": 0,
        "reset": false,
        "code": "apt-get install zip",
    }
}

2 execute python code

{
    "thoughts": [
        "Need to do...",
        "I can use...",
        "Then I can...",
    ],
    "headline": "Executing Python code to check current directory",
    "tool_name": "code_execution_tool",
    "tool_args": {
        "runtime": "python",
        "session": 0,
        "reset": false,
        "code": "import os\nprint(os.getcwd())",
    }
}

3 execute nodejs code

{
    "thoughts": [
        "Need to do...",
        "I can use...",
        "Then I can...",
    ],
    "headline": "Executing Javascript code to check current directory",
    "tool_name": "code_execution_tool",
    "tool_args": {
        "runtime": "nodejs",
        "session": 0,
        "reset": false,
        "code": "console.log(process.cwd());",
    }
}

4 wait for output with long-running scripts

{
    "thoughts": [
        "Waiting for program to finish...",
    ],
    "headline": "Waiting for long-running program to complete",
    "tool_name": "code_execution_tool",
    "tool_args": {
        "runtime": "output",
        "session": 0,
    }
}

2 python snippet

{
  "thoughts": ["A short Python check is faster than using the shell."],
  "headline": "Running Python snippet",
  "tool_name": "code_execution_tool",
  "tool_args": {
    "runtime": "python",
    "session": 0,
    "reset": false,
    "code": "import os\nprint(os.getcwd())"
  }
}

3 wait for running output

{
  "thoughts": ["The previous command is still running, so I should poll for output."],
  "headline": "Waiting for command output",
  "tool_name": "code_execution_tool",
  "tool_args": {
    "runtime": "output",
    "session": 0
  }
}