run-shell - Nebius Token Factory documentation

Run a shell command in an isolated container.

Description

The run-shell prompt provides a simple way to execute shell commands in a container with a specified base image.

Parameter	Type	Required	Default	Description
`command`	string	Yes	-	Shell command to execute
`image`	string	No	`ubuntu:22.04`	Base image to use

When invoked with:

{
  "command": "uname -a && cat /etc/os-release",
  "image": "alpine:latest"
}

Returns:

Run this command in a container:

```bash
uname -a && cat /etc/os-release

Use image tag:alpine:latest. If the image doesn’t exist, import it first with import_image.

## Example Usage

### Basic Command

```json
{
  "prompt": "run-shell",
  "args": {
    "command": "ls -la /etc"
  }
}

{
  "prompt": "run-shell",
  "args": {
    "command": "go version",
    "image": "golang:1.21"
  }
}

{
  "prompt": "run-shell",
  "args": {
    "command": "df -h && free -m && nproc"
  }
}

The agent should:

Execute the command with run:

{
  "command": "<shell_command>",
  "image": "tag:<image>"
}