run_textual_cli_async

run_textual_cli_async(
  assistant_id: str,
  *,
  auto_approve: bool = False,

sandbox_snapshot_name

interpreter_ptc_acknowledge_unsafe

Parameters

Name	Type	Description
`assistant_id`*	`str`	Agent identifier for memory storage
`auto_approve`	`bool`	Default:`False` Whether to auto-approve tool usage
`sandbox_type`	`str`	Default:`'none'` Type of sandbox ("none", "agentcore", "modal", "runloop", "daytona", "langsmith")
`sandbox_id`	`str \| None`	Default:`None`
`sandbox_snapshot_name`	`str \| None`	Default:`None`
`sandbox_setup`	`str \| None`	Default:`None`
`model_name`	`str \| None`	Default:`None`
`model_params`	`dict[str, Any] \| None`	Default:`None`
`profile_override`	`dict[str, Any] \| None`	Default:`None`
`thread_id`	`str \| None`	Default:`None`
`resume_thread`	`str \| None`	Default:`None`
`initial_prompt`	`str \| None`	Default:`None`
`initial_skill`	`str \| None`	Default:`None`
`startup_cmd`	`str \| None`	Default:`None`
`mcp_config_path`	`str \| None`	Default:`None`
`no_mcp`	`bool`	Default:`False`
`trust_project_mcp`	`bool \| None`	Default:`None`
`enable_interpreter`	`bool`	Default:`False`
`interpreter_ptc`	`str \| list[str] \| None`	Default:`None`
`interpreter_ptc_acknowledge_unsafe`	`bool`	Default:`False`

Run the Textual TUI interface (async version).

Starts a LangGraph server in a subprocess and connects the TUI to it via the langgraph-sdk client.

Optional existing sandbox ID to reuse.

Snapshot (langsmith) or blueprint (runloop) name.

Optional path to setup script to run in the sandbox after creation.

Optional model name to use

Extra kwargs from --model-params to pass to the model.

These override config file values.

Extra profile fields from --profile-override.

Merged on top of config file profile overrides.

Thread ID for the session.

None when resume_thread is provided (the TUI resolves the final ID asynchronously).

Raw resume intent from -r flag.

'__MOST_RECENT__' for bare -r, a thread ID string for -r <id>, or None for new sessions.

Resolved asynchronously inside the TUI.

Optional prompt to auto-submit when session starts

Optional skill name to invoke when the session starts.

Shell command to run at startup before the first prompt.

Output is rendered in the transcript; non-zero exits warn but do not abort the session.

Optional path to MCP servers JSON configuration file.

Merged on top of auto-discovered configs (highest precedence).

Disable all MCP tool loading.

Controls project-level stdio server trust.

True to allow, False to deny, None to check trust store.

Enable CodeInterpreterMiddleware (js_eval) on the main agent. Local-mode only.

Override for settings.interpreter_ptc (PTC allowlist for js_eval).

Explicit acknowledgement for interpreter_ptc="all" outside of auto_approve.