Deep Agents CLI

Deep Agents CLI

Terminal coding agent with persistent memory, skills, sandboxed execution, and 20+ LLM providers. Built on LangGraph. See the official overview and CLI guide.

Routing: This file covers quick start, core concepts, and common workflows. For deeper details, read the appropriate reference file: CLI flags and shortcuts → references/cli-reference.md | Models and providers → references/providers.md | Skills → references/skills-system.md | Memory → references/memory-and-persistence.md | Sandboxes → references/sandboxes.md | SDK/programmatic usage → references/sdk-customization.md | Automation/CI → references/workflows.md | Streaming → references/streaming.md | Editor integrations → references/acp.md

Note: All official documentation content is included in the local reference files. Only fetch external URLs if the local content appears inaccurate or incomplete.

Quick Start

# Interactive session (default agent, default model)
deepagents

# Interactive with specific agent and model
deepagents -a myagent -M anthropic:claude-sonnet-4-5

# Non-interactive one-shot task
deepagents -n "Summarize README.md"

# Non-interactive with shell access
deepagents -n "List Python files and count lines" --shell-allow-list ls,wc,find

# Resume last session
deepagents -r

Core Concepts

Agents = Isolated Personas

Each agent has its own memory, skills, and AGENTS.md context file (default agent shown; use -a <name> for named agents):

~/.deepagents/default/
├── AGENTS.md          # Always-loaded context (preferences, conventions)
├── memories/          # Auto-saved topic memories
└── skills/            # User-level skills