hypr
Control Hyprland windows and workspaces via IPC: focus, move, close, fullscreen, toggle floating. For AI agents managing Wayland desktop without vision.
Instructions
Window/workspace ops over IPC (instant, no vision).
action='workspace' (workspace: number/name/'special:name') |
'focus_window' (target: address) | 'move_window' (target + workspace,
silent) | 'close_window' (target) | 'fullscreen' (target?) |
'toggle_floating' (target?). then ('desktop'|'screenshot'|'ui'|'none')
appends the result to this call. While the background guarantee is on
(HYPRUSE_BACKGROUND=1), workspace, focus_window and fullscreen are
refused because they change the human's view, and move_window moves
only to the agent's own workspaces.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "hypr"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| then | No | none | |
| action | Yes | ||
| target | No | ||
| workspace | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |