ui.push

Since next

[editor (test session)] Push a registered screen (ui.screens lists them) with optional props, as ctx.ui.push does, to look at it without a behaviour.

replace swaps the top instead.


Title	Open a screen
Mode
Token cost	about 143 tokens (listed only when its toolset is enabled)
Toolset	`ui`

Arguments

Argument	Type	Required	Default	Description
`agent`	`string`	no		The name of the agent making the call, when several agents share one connection: each named agent is its own actor and plays its own game. Leave it out when there is one agent.
`props`	`object`	no		Set on its root as data-*; ui.screens reports them
`replace`	`boolean`	no	`false`
`screen`	`string`	yes		A registered screen's name

An MCP tools/call with the required arguments (placeholders in angle brackets).

{
  "name": "ui.push",
  "arguments": {
    "screen": "<screen>"
  }
}