| Name | Type | Description |
|---|---|---|
agent | Any | Default: NonePre-configured LangGraph agent (optional). |
assistant_id | str | None | Default: NoneAgent identifier for memory storage. |
backend | CompositeBackend | None | Default: None |
auto_approve | bool | Default: False |
cwd | str | Path | 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 |
launch_init | bool | Default: False |
mcp_server_info | list[MCPServerInfo] | None | Default: None |
profile_override | dict[str, Any] | None | Default: None |
server_proc | ServerProcess | None | Default: None |
server_kwargs | dict[str, Any] | None | Default: None |
mcp_preload_kwargs | dict[str, Any] | None | Default: None |
model_kwargs | dict[str, Any] | None | Default: None |
defer_server_start | bool | Default: False |
title | str | None | Default: None |
sub_title | str | None | Default: None |
Run the Textual application.
When server_kwargs is provided (and agent is None), the app starts
immediately with a "Connecting..." banner and launches the server in the
background. Server cleanup is handled automatically after the app exits.
Backend for file operations.
Whether to start with auto-approve enabled.
Current working directory to display.
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 during TUI startup.
Optional prompt to auto-submit when session starts.
Optional skill name to invoke when session starts.
Optional shell command to run at startup before the first prompt is accepted. Output is rendered in the transcript and non-zero exits warn but do not abort the session.
Whether to run the first-run onboarding setup flow (name entry, dependency summary, model picker) before accepting the first prompt.
MCP server metadata for the /mcp viewer.
Extra profile fields from --profile-override,
retained so later profile-aware behavior stays consistent with
the app override, including model selection details, offload
budget display, and on-demand create_model() calls such
as /offload.
LangGraph server process for the interactive session.
Kwargs for deferred start_server_and_get_agent call.
Kwargs for concurrent MCP metadata preload.
Kwargs for deferred create_model() call.
When provided, model creation runs in a background worker after first paint so the splash screen appears immediately.
Whether to keep app-owned server startup paused until credentials or a model are configured from inside the TUI.
Override the Textual App.title shown in the optional header
bar (gated on DEEPAGENTS_CODE_SHOW_HEADER). When None, the
default "Deep Agents" is used.
Override the Textual App.sub_title shown in the optional
header bar.