Function●Since v0.0

run_textual_cli_async

Run the Textual CLI interface (async version).

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

run_textual_cli_async(
  assistant_id: str,
  *,
  auto_approve: bool = False,
  sandbox_type: str = 'none',
  sandbox_id: str | None = None,
  sandbox_setup: str | None = None,
  model_name: str | None = None,
  model_params: dict[str, Any] | None = None,
  profile_override: dict[str, Any] | None = None,
  thread_id: str | None = None,
  resume_thread: str | None = None,
  initial_prompt: str | None = None,
  initial_skill: str | None = None,
  mcp_config_path: str | None = None,
  no_mcp: bool = False,
  trust_project_mcp: bool | None = None
) -> AppResult

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` Optional existing sandbox ID to reuse.
`sandbox_setup`	`str \| None`	Default:`None` Optional path to setup script to run in the sandbox after creation.
`model_name`	`str \| None`	Default:`None` Optional model name to use
`model_params`	`dict[str, Any] \| None`	Default:`None` Extra kwargs from `--model-params` to pass to the model. These override config file values.
`profile_override`	`dict[str, Any] \| None`	Default:`None` Extra profile fields from `--profile-override`. Merged on top of config file profile overrides.
`thread_id`	`str \| None`	Default:`None` Thread ID for the session. `None` when `resume_thread` is provided (the TUI resolves the final ID asynchronously).
`resume_thread`	`str \| None`	Default:`None` 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.
`initial_prompt`	`str \| None`	Default:`None` Optional prompt to auto-submit when session starts
`initial_skill`	`str \| None`	Default:`None` Optional skill name to invoke when the session starts.
`mcp_config_path`	`str \| None`	Default:`None` Optional path to MCP servers JSON configuration file. Merged on top of auto-discovered configs (highest precedence).
`no_mcp`	`bool`	Default:`False` Disable all MCP tool loading.
`trust_project_mcp`	`bool \| None`	Default:`None` Controls project-level stdio server trust. `True` to allow, `False` to deny, `None` to check trust store.

View source on GitHub

run_textual_cli_async( assistant_id: str, *, auto_approve: bool = False, sandbox_type: str = 'none', sandbox_id: str | None = None, sandbox_setup: str | None = None, model_name: str | None = None, model_params: dict[str, Any] | None = None, profile_override: dict[str, Any] | None = None, thread_id: str | None = None, resume_thread: str | None = None, initial_prompt: str | None = None, initial_skill: str | None = None, mcp_config_path: str | None = None, no_mcp: bool = False, trust_project_mcp: bool | None = None ) -> AppResult

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` Optional existing sandbox ID to reuse.
`sandbox_setup`	`str \| None`	Default:`None` Optional path to setup script to run in the sandbox after creation.
`model_name`	`str \| None`	Default:`None` Optional model name to use
`model_params`	`dict[str, Any] \| None`	Default:`None` Extra kwargs from `--model-params` to pass to the model. These override config file values.
`profile_override`	`dict[str, Any] \| None`	Default:`None` Extra profile fields from `--profile-override`. Merged on top of config file profile overrides.
`thread_id`	`str \| None`	Default:`None` Thread ID for the session. `None` when `resume_thread` is provided (the TUI resolves the final ID asynchronously).
`resume_thread`	`str \| None`	Default:`None` 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.
`initial_prompt`	`str \| None`	Default:`None` Optional prompt to auto-submit when session starts
`initial_skill`	`str \| None`	Default:`None` Optional skill name to invoke when the session starts.
`mcp_config_path`	`str \| None`	Default:`None` Optional path to MCP servers JSON configuration file. Merged on top of auto-discovered configs (highest precedence).
`no_mcp`	`bool`	Default:`False` Disable all MCP tool loading.
`trust_project_mcp`	`bool \| None`	Default:`None` Controls project-level stdio server trust. `True` to allow, `False` to deny, `None` to check trust store.

run_textual_cli_async

Parameters

LangChain Assistant

Menu

run_textual_cli_async

Parameters