computer-action.mdx

title	Computer Action
description	Mouse, keyboard, clipboard, and screenshot controls for browser sessions

Use computer_action when an agent needs to interact with the browser like a user: click, type, scroll, drag, copy, paste, or inspect the screen. Pass one action for a simple operation, or batch several actions into one call to reduce latency.

Include a screenshot as the last action when you need to see the result. screenshot, read_clipboard, and get_mouse_position return data, so they must be the last action if included.

Parameters

Parameter	Description
session_id	Browser session ID. Required.
actions	Ordered list of one or more actions to perform. Required.

Action types

Type	Description
click_mouse	Click at x, y. Supports button, click_type, num_clicks, hold_keys.
move_mouse	Move the cursor to x, y.
type_text	Type text, with optional inter-key delay.
press_key	Press keys (X11 keysym names or combos like Ctrl+t, Return).
scroll	Scroll at x, y by delta_x/delta_y (positive = right/down).
drag_mouse	Drag along a path of [x, y] points.
set_cursor	Show or hide the cursor (hidden).
sleep	Wait duration_ms between steps when the page needs time to react.
write_clipboard	Write text to the browser session clipboard.
read_clipboard	Read the browser session clipboard. Must be the last action if included.
screenshot	Capture the page, optionally limited to a region.
get_mouse_position	Return the current cursor position.

Recommended flow

1. Start with screenshot so the agent can see the viewport and coordinate space.
2. Batch related pointer and keyboard actions together.
3. Add sleep between actions that trigger navigation, animation, or async UI updates.
4. End with screenshot, read_clipboard, or get_mouse_position only when you need returned data.

Search from the page

{
  "session_id": "browser_abc123",
  "actions": [
    { "type": "click_mouse", "click_mouse": { "x": 420, "y": 300 } },
    { "type": "type_text", "type_text": { "text": "kernel browsers" } },
    { "type": "press_key", "press_key": { "keys": ["Return"] } },
    { "type": "sleep", "sleep": { "duration_ms": 1000 } },
    { "type": "screenshot" }
  ]
}

Clipboard example

{
  "session_id": "browser_2vDb5kRmZ4nP8xQ1cA7",
  "actions": [
    { "type": "write_clipboard", "write_clipboard": { "text": "https://kernel.sh/docs" } },
    { "type": "press_key", "press_key": { "keys": ["Ctrl+l"] } },
    { "type": "press_key", "press_key": { "keys": ["Ctrl+v"] } },
    { "type": "press_key", "press_key": { "keys": ["Return"] } },
    { "type": "screenshot" }
  ]
}