Deep Agents CLI - Interactive AI coding assistant.
Utilities for project root detection and project-specific configuration.
Agent management and creation for the CLI.
Helpers for tracking file operations and computing diffs for CLI display.
Thread management using LangGraph's built-in checkpoint persistence.
Subagent loader for CLI.
Loads custom subagent definitions from the filesystem. Subagents are defined as markdown files with YAML frontmatter in the agents/ directory.
Textual UI adapter for agent execution.
Model configuration management.
Handles loading and saving model configuration from TOML files, providing a structured way to define available models and providers.
Main entry point and CLI loop for deepagents.
Utilities for handling image paste from clipboard.
Non-interactive execution mode for deepagents CLI.
Provides run_non_interactive which runs a single user task against the
agent graph, streams results to stdout, and exits with an appropriate code.
Shell commands are gated by an optional allow-list. When no allow-list is
set, shell is disabled and all other tool calls are auto-approved via the
auto_approve flag. When an allow-list is provided, shell is enabled and
all tool calls (shell and non-shell) pass through HITL, where non-shell
tools are approved unconditionally and shell commands are validated against
the list.
An optional quiet mode (--quiet / -q) redirects all console output to
stderr, leaving stdout exclusively for the agent's response text.
Note: in non-interactive mode (-n), auto-approval is determined solely by
whether a --shell-allow-list is present, not by the --auto-approve CLI
flag. See run_non_interactive for details.
Clipboard utilities for deepagents-cli.
Middleware for injecting local context into system prompt.
Detects git state, project structure, package managers, runtimes, and directory layout by running a bash script via the backend. Because the script executes inside the backend (local shell or remote sandbox), the same detection logic works regardless of where the agent runs.
Input handling utilities including image tracking and file mention parsing.
Help screens and argparse utilities for the CLI.
This module is imported at CLI startup to wire -h actions into the
argparse tree. It must stay lightweight — no SDK or langchain imports.
Formatting utilities for tool call display in the CLI.
This module handles rendering tool calls and tool messages for the TUI.
Imported at runtime (not at CLI startup), so it can safely depend
on heavier modules like backends.
Configuration, constants, and model creation for the CLI.
Textual UI application for deepagents-cli.
Custom tools for the CLI agent.
Built-in skills that ship with the Deep Agents CLI.
These skills are always available at the lowest precedence level. User and project skills with the same name will override them.
Integrations for external systems used by the deepagents CLI.
Textual widgets for deepagents-cli.
Import directly from submodules, e.g.:
from deepagents_cli.widgets.chat_input import ChatInput
from deepagents_cli.widgets.messages import AssistantMessageSkills module for deepagents CLI.
Public API:
All other components are internal implementation details.