← All toolsSystem & Hardwarewindow_watcherAll editions

GET_ACTIVE_WINDOW

Get the title and application name of the currently focused window.

Parameters

This tool takes no parameters.

How to use it

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

Try saying
“get my window watcher”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "window_watcher",
  "action": "GET_ACTIVE_WINDOW",
  "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":"GET_ACTIVE_WINDOW","args":{}}'

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