Main Textual application for deepagents-code.
| Name | Type | Description |
|---|---|---|
agent | Pregel | None | Default: NonePre-configured LangGraph agent, or |
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 |
**kwargs | Any | Default: {} |
| Name | Type |
|---|---|
| agent | Pregel | None |
| assistant_id | str | None |
| backend | CompositeBackend | None |
| auto_approve | bool |
| cwd | str | Path | None |
| thread_id | str | None |
| resume_thread | str | None |
| initial_prompt | str | None |
| initial_skill | str | None |
| startup_cmd | str | None |
| launch_init | bool |
| mcp_server_info | list[MCPServerInfo] | None |
| profile_override | dict[str, Any] | None |
| server_proc | ServerProcess | None |
| server_kwargs | dict[str, Any] | None |
| mcp_preload_kwargs | dict[str, Any] | None |
| model_kwargs | dict[str, Any] | None |
| defer_server_start | bool |
| title | str | None |
| sub_title | str | None |
Handle ask_user menu cancellation - remove widget and refocus input.
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 (resolved 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 via _resolve_resume_thread
during _start_server_background.
Requires server_kwargs to be set; ignored otherwise.
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 onboarding setup flow 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.
When provided, server startup is deferred.
The app shows a "Connecting..." state and starts the server in
the background using these kwargs
for start_server_and_get_agent.
Kwargs for _preload_session_mcp_server_info,
run concurrently with server startup when server_kwargs is set.
Kwargs for deferred create_model().
When provided, model creation runs in a background worker after first paint instead of blocking startup.
Whether to keep app-owned server startup paused until the user configures credentials or explicitly picks a model.
Override the Textual App.title shown in the optional
header bar.
When None, the class-level TITLE is used.
Reassigning app.title at runtime updates the header live.
Override the Textual App.sub_title shown in the
optional header bar.
When None, the parent default is used.
Reassigning app.sub_title at runtime updates the header live.
Additional arguments passed to parent