Computer tools. Tool names are exact: computer tools are prefixed computer_. All computer tools take an optional computer_id and fall back to the active computer.
Note
Governed tools fail closed if the control-plane action authority does not grant the capability. See Action authority .
Tool Description computer_createCreate a new MIOSA computer and wait until it is active. Returns the computer ID. The new computer becomes the active computer for subsequent calls. computer_listList all computers in the tenant. computer_getGet details and current status of a computer. computer_destroyPermanently destroy a computer. computer_startStart a stopped computer. computer_stopStop a running computer. computer_restartRestart a computer. computer_updateRename a computer or update its metadata. computer_waitPause execution inside the computer for N seconds. computer_logsGet recent VM-level logs from the computer. computer_viewer_passwordShow whether the raw external desktop viewer password is set. Authenticated platform desktop links do not need this password. computer_rotate_viewer_passwordRotate and return the raw external desktop viewer password once for sharing a raw *.computer.miosa.ai link. computer_list_regionsList available compute regions.
Tool Description computer_screenshotCapture a PNG screenshot of the computer desktop. Returns the image so you can see the current screen state. computer_get_screen_sizeGet the screen resolution (width and height in pixels). computer_get_cursor_positionGet the current mouse cursor position (x, y). computer_get_desktop_envGet desktop environment info (name, resolution, session type). computer_clickClick a mouse button at the given screen coordinates. computer_double_clickDouble-click at the given screen coordinates. computer_right_clickRight-click at the given screen coordinates. computer_move_cursorMove the mouse cursor to the given coordinates without clicking. computer_dragClick-and-drag from one screen position to another. computer_mouse_downPress and hold a mouse button at (x, y). Pair with computer_mouse_up to release. computer_mouse_upRelease a held mouse button at (x, y). computer_scrollScroll in a direction on the desktop.
Tool Description computer_typeType text into the currently focused field. computer_keyPress a single key. Use standard key names: Return, Tab, Escape, BackSpace, Delete, space, F1-F12, ctrl, shift, alt, super. computer_key_downPress and hold a key without releasing it. Pair with computer_key_up. computer_key_upRelease a previously held key. computer_hotkeyPress a keyboard shortcut (multiple keys simultaneously). Example: [‘ctrl’, ‘c’] for copy, [‘ctrl’, ‘alt’, ‘t’] for terminal. computer_get_clipboardRead the current clipboard text content. computer_set_clipboardSet the clipboard text content.
Tool Description computer_windowsList all open windows on the desktop with their IDs, titles, and positions. computer_focus_windowBring a window to the foreground by its window ID. computer_close_windowClose a window. computer_maximize_windowMaximize a window. computer_minimize_windowMinimize (iconify) a window. computer_set_window_positionMove a window to the given screen coordinates. computer_set_window_sizeResize a window to the given width and height in pixels. computer_launchLaunch an application by name (e.g. ‘firefox’, ‘gedit’, ‘xterm’). computer_accessibility_treeGet the AT-SPI accessibility tree for the current desktop state. Returns a nested JSON structure describing all visible UI elements with roles, names, bounding boxes, and parent/child relationships.
Tool Description computer_bashExecute a bash command on the computer and return stdout + stderr. Commands run as the default user inside the VM. computer_read_fileRead a file from inside the computer and return its content as text. computer_write_fileWrite text content to a file path inside the computer. computer_list_filesList directory contents on the computer. computer_stat_fileGet file/directory metadata (size, type, permissions, mtime) inside the computer. computer_mkdirCreate a directory (and any missing parents) inside the computer. computer_rename_fileRename or move a file/directory inside the computer. computer_copy_fileCopy a file or directory tree inside the computer. computer_delete_fileDelete a file or directory inside the computer. computer_upload_fileUpload a local file from the host machine into the computer at a given path.
Tool Description computer_service_createCreate and start a long-running background service on the computer (like systemd - process manager for your VM). computer_service_deleteDelete a background service (stops it first if running). computer_service_listList all background services registered on the computer. computer_service_logsRetrieve recent log output from a background service (last 100 lines). computer_service_restartRestart a background service (stop then start). computer_service_startStart a stopped background service. computer_service_stopStop a running background service (sends SIGTERM).
Tool Description computer_checkpoint_createSave the current state of the computer as a checkpoint (snapshot). computer_checkpoint_deleteDelete a saved checkpoint. computer_checkpoint_listList all saved checkpoints for the computer. computer_checkpoint_restoreRestore the computer to a previously saved checkpoint.
Tool Description computer_env_deleteDelete an environment variable from the computer. computer_env_listList all environment variables set on the computer. computer_env_setSet (create or update) an environment variable on the computer. computer_expose_portExpose a port on the computer and return the public URL. The URL follows the pattern https://PORT-SLUG.computer.miosa.ai . computer_list_portsList all currently exposed ports on the computer. computer_network_policy_getGet the current network policy (firewall rules) for the computer. computer_network_policy_resetReset the network policy for the computer to the platform default (allow all). computer_network_policy_setSet the network policy (firewall rules) for the computer. computer_preview_urlReturn the public preview URL for a given port on the computer. Format: https://PORT-SLUG.computer.miosa.ai
Tool Description computer_domain_addAdd a custom domain to the computer. Returns CNAME verification instructions to add to your DNS registrar. computer_domain_deleteDelete a custom domain mapping from the computer. computer_domain_listList all custom domains registered for the computer. computer_set_wallpaperSet the desktop wallpaper. Accepts an absolute path inside the VM (e.g. ‘/home/ubuntu/bg.png’) or an https:// URL. computer_template_createCreate a new computer template in a workspace. computer_template_listList computer templates available in a workspace.
