Skip to main content
All 17 tools for container execution, file management, and operations.

run

rsync

import_image

registry_token_obtain

registry_auth

list_images

get_image

set_tag

upload

download

list_files

read_file

get_operation

list_operations

wait_operations

cancel_operation

get_guide

​
Quick Reference

​
Command Execution

ToolDescriptionCost
runExecute command in containerSpawns microVM

​
File Transfer

ToolDescriptionCost
rsyncSync local files with cachingNo VM
uploadUpload single fileNo VM
downloadDownload file from imageNo VM

​
Image Management

ToolDescriptionCost
import_imageImport from registrySpawns microVM
registry_token_obtainOpen browser for PAT creationNo VM
registry_authValidate and store credentialsNo VM
list_imagesList available imagesNo VM
get_imageGet image by UUID/tagNo VM
set_tagSet or remove tagNo VM

​
Image Inspection

ToolDescriptionCost
list_filesList files in imageNo VM
read_fileRead file from imageNo VM

​
Operations

ToolDescriptionCost
get_operationGet operation statusNo VM
list_operationsList operationsNo VM
wait_operationsWait for multiple opsNo VM
cancel_operationCancel operationNo VM

​
Documentation

ToolDescriptionCost
get_guideGet guide sectionsNo VM

​
Common Patterns

​
Basic Execution

{"tool": "run", "args": {"command": "python -c 'print(1)'", "image": "img-uuid"}}

​
With Local Files

{"tool": "rsync", "args": {"source": "/project", "destination": "/app"}}
{"tool": "run", "args": {"command": "python /app/main.py", "image": "img-uuid", "directory_state_id": "ds-uuid"}}

​
Parallel Execution

{"tool": "run", "args": {"command": "test1.py", "image": "img", "wait": false}}
{"tool": "run", "args": {"command": "test2.py", "image": "img", "wait": false}}
{"tool": "wait_operations", "args": {"operation_ids": ["op-1", "op-2"]}}

​
Inspect Container (No VM)

{"tool": "list_files", "args": {"image": "img-uuid", "path": "/etc"}}
{"tool": "read_file", "args": {"image": "img-uuid", "path": "/etc/os-release"}}