Core — terminal operations
list_surfacesEnumerate all surfaces across workspaces
new_splitCreate terminal or browser splits in any direction
send_inputType text into a surface as if from the keyboard
send_keySend key combos — Enter, Ctrl-C, Escape, arrows
read_screenCapture visible terminal output with optional scrollback
rename_tabSet the workspace tab title
notifyPush macOS notifications from any surface
set_statusUpdate sidebar status entries with icons and colors
set_progressShow a progress bar with label in the sidebar
close_surfaceClose a terminal or browser surface
browser_surfaceOpen a scriptable browser alongside terminal panes
Agent lifecycle — spawn and monitor
spawn_agentLaunch a Claude, Codex, Gemini, or Cursor agent in a new pane
send_to_agentDeliver a message to a running agent
read_agent_outputCapture an agent’s latest terminal output
get_agent_stateCheck agent status: running, idle, waiting, done, error
list_agentsEnumerate all active agents across workspaces
wait_forBlock until an agent reaches a target state
wait_for_allBlock until multiple agents finish in parallel
stop_agentGracefully stop a running agent
killForce-kill an unresponsive agent process
interactSend interactive input to an agent waiting for a response
