← All toolsVision & Controlscreen_readerAll editions

READ_SCREEN

Capture the current screen as a screenshot and get active application info. Returns base64 image, screen dimensions, and app info.

Parameters

This tool takes no parameters.

How to use it

You normally trigger this by describing what you want in chat — the agent selects READ_SCREEN automatically. For example:

Try saying
“read my screen reader”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "screen_reader",
  "action": "READ_SCREEN",
  "args": {},
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"READ_SCREEN","args":{}}'

Part of the screen_reader plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.