macos_focus_app
Bring a running app to the front on macOS, switching to its Space and waiting until it is frontmost. Omit the app to return focus to the agent's terminal before asking the user anything.
Instructions
macOS only. Bring a running app to the front, switching to the Space its window is on (a full-screen window has a Space of its own), and wait until it is the frontmost app. Omit app to return to the terminal this agent runs in: do that when a stretch of work that brought another app forward (the tab_* browser tools, another macos_focus_app) is done, and before asking the user anything, so the conversation is back on their screen. Reports the app that was frontmost before, to pass back later. Needs no macOS permission.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "macos_focus_app"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | The app to bring to the front: its bundle id (com.apple.Terminal) or its name as macos_list_apps shows it (Terminal, Mail, Brave Browser), matched regardless of case. Omit it to return to the host, the terminal or app this agent runs in. |