main

Check if optional dependencies are installed.

Check for recommended external tools and return missing tool names.

Skips tools that the user has suppressed via [warnings].suppress in config.toml.

Build a PendingNotification for a missing optional tool.

The returned entry carries the install hint (or URL) in a typed payload so the notification center action handler can copy it / open it without re-running platform detection.

Format a missing-tool warning for non-interactive console output.

Parse command line arguments.

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.

Read piped stdin and merge it into the parsed CLI arguments.

When stdin is not a TTY (i.e. input is piped), reads all available text and applies it to the argument namespace. If stdin is a TTY or the piped input is empty/whitespace-only, the function returns without modifying args. Leading and trailing whitespace is stripped from piped input.

• If non_interactive_message is already set (-n), prepends the piped text to it (the CLI still runs non-interactively):

cat context.txt | deepagents -n "summarize this"
# non_interactive_message = "{contents of context.txt}\n\nsummarize this"

• If initial_prompt is already set (-m, but not -n), prepends the piped text to it (the CLI still runs interactively):

cat error.log | deepagents -m "explain this"
# initial_prompt = "{contents of error.log}\n\nexplain this"

• If initial_skill is already set (--skill, but not -n), stores the piped text in initial_prompt so the skill receives it as the startup request:

cat diff.txt | deepagents --skill code-review
# initial_prompt = "{contents of diff.txt}"

• Otherwise, sets non_interactive_message to the piped text, causing the CLI to run non-interactively with it as the prompt:

echo "fix the typo in README.md" | deepagents
# non_interactive_message = "fix the typo in README.md"

Entry point for console script.

Result from running the Textual application.

Metadata for a configured MCP server and its tools.

A single notice waiting for user action.

Immutable value object: the registry owns the key-to-toast-identity binding (see NotificationRegistry) so external callers cannot corrupt click-routing indices by mutating notifications after construction.