Metadata-Version: 2.4
Name: deepagents-cli
Version: 0.2.1
Summary: Deployment tooling for Deep Agents - bundle, run, and ship agents to LangGraph Platform.
Project-URL: Homepage, https://docs.langchain.com/oss/python/deepagents/overview
Project-URL: Documentation, https://reference.langchain.com/python/deepagents/
Project-URL: Repository, https://github.com/langchain-ai/deepagents
Project-URL: Issues, https://github.com/langchain-ai/deepagents/issues
Project-URL: Changelog, https://github.com/langchain-ai/deepagents/blob/main/libs/cli/CHANGELOG.md
Project-URL: Twitter, https://x.com/langchain_oss
Project-URL: Slack, https://www.langchain.com/join-community
Project-URL: Reddit, https://www.reddit.com/r/LangChain/
License: MIT
Keywords: agents,ai,cli,deep-agent,deploy,langchain,langgraph,llm
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <4.0,>=3.11
Requires-Dist: deepagents>=0.6.8
Requires-Dist: httpx<1.0.0,>=0.28.1
Requires-Dist: langchain<2.0.0,>=1.3.4
Requires-Dist: langgraph-sdk<1.0.0,>=0.4.2
Requires-Dist: langgraph<2.0.0,>=1.2.4
Requires-Dist: langsmith>=0.8.9
Requires-Dist: python-dotenv<2.0.0,>=1.2.2
Description-Content-Type: text/markdown

# Deep Agents CLI — Deployment Tooling

[![PyPI - Version](https://img.shields.io/pypi/v/deepagents-cli?label=%20)](https://pypi.org/project/deepagents-cli/#history)
[![PyPI - License](https://img.shields.io/pypi/l/deepagents-cli)](https://opensource.org/licenses/MIT)
[![PyPI - Downloads](https://img.shields.io/pepy/dt/deepagents-cli)](https://pypistats.org/packages/deepagents-cli)
[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/langchain_oss.svg?style=social&label=Follow%20%40LangChain)](https://x.com/langchain_oss)

> [!IMPORTANT]
> **The interactive coding agent moved.** As of `deepagents-cli==0.1.0`, this package contains only the deployment subcommands (`init`, `dev`, `deploy`). The interactive REPL — previously launched via `deepagents` — now ships as [`deepagents-code`](https://docs.langchain.com/deepagents-code) (`dcode`).
>
> ```bash
> curl -LsSf https://langch.in/dcode | bash
> dcode
> ```

## Install

```bash
uv tool install deepagents-cli
```

You'll need a LangSmith API key with access to the Managed Deep Agents private
preview ([waitlist](https://www.langchain.com/langsmith-managed-deep-agents-waitlist)).
Export it before running any command, or put it in a repo `.env` or
`~/.deepagents/.env`:

```bash
export LANGSMITH_API_KEY="..."
```

## Usage

```bash
# Scaffold a new project folder
deepagents init my-agent

# Register any MCP servers you intend to use (one-time, per workspace)
deepagents mcp-servers add --url https://tools.langchain.com \
                            --header X-Api-Key=$LANGSMITH_API_KEY \
                            --name Fleet

# init scaffolds an empty tools.json. Add tools that reference a registered
# MCP server's URL (otherwise the agent has no tools), e.g. the Fleet server
# registered above:
#   { "name": "read_url_content", "mcp_server_url": "https://tools.langchain.com",
#     "mcp_server_name": "Fleet", "display_name": "read_url_content" }

# Upsert the project as a managed agent on /v1/deepagents/*
cd my-agent && deepagents deploy
```

`deepagents init` scaffolds an empty `tools.json`, an example skill under
`skills/`, and an example subagent under `subagents/`; edit or remove them to
suit your agent. `tools.json` starts empty because every tool must reference an
MCP server that is already registered in the workspace
(`deepagents mcp-servers add`) — so a freshly scaffolded project deploys
without first registering a server.

New agents default to the `default` backend — switch `agent.json`'s
`backend.type` to `thread_scoped_sandbox` (or `agent_scoped_sandbox`) to opt
into a managed sandbox. The CLI does not create or run sandboxes locally;
sandbox lifecycle is handled by the Managed Deep Agents platform.

### Project layout

```text
my-agent/
  agent.json              # name, description, backend, runtime.model, permissions
  AGENTS.md               # system prompt
  tools.json              # tools the agent can call (optional)
  skills/<name>/SKILL.md  # frontmatter-tagged skills (optional)
  subagents/<name>/       # delegated subagent definitions (optional)
```

### Other commands

```bash
deepagents agents list                  # list workspace agents
deepagents agents get <agent_id>        # show one agent
deepagents agents delete <agent_id>     # delete an agent

deepagents mcp-servers list                  # list workspace MCP servers
deepagents mcp-servers add --url URL          # register a server
deepagents mcp-servers get <id|name|url>      # show one server
deepagents mcp-servers tools <id|name|url>    # list a server's tools
deepagents mcp-servers update <id|name|url>   # update server URL or headers
deepagents mcp-servers delete <id|name|url>   # remove a server
deepagents mcp-servers connect <id|name|url>  # start OAuth for a server
```

`get`, `update`, `delete`, and `connect` accept an MCP server's id, exact name,
or URL — a non-id value is resolved against `mcp-servers list` (URLs are matched
ignoring case and trailing slash).

## 📖 Resources

- **[CLI Documentation](https://docs.langchain.com/oss/python/deepagents/cli/overview)**
- **[Changelog](https://github.com/langchain-ai/deepagents/blob/main/libs/cli/CHANGELOG.md)**
- **[Source code](https://github.com/langchain-ai/deepagents/tree/main/libs/cli)**
- **[Deep Agents SDK](https://github.com/langchain-ai/deepagents)** — underlying agent harness
- **[Deep Agents Code](https://pypi.org/project/deepagents-code/)** — coding agent

## 📕 Releases & Versioning

See our [Releases](https://docs.langchain.com/oss/python/release-policy) and [Versioning](https://docs.langchain.com/oss/python/versioning) policies.

## 💁 Contributing

As an open-source project in a rapidly developing field, we are extremely open to contributions, whether it be in the form of a new feature, improved infrastructure, or better documentation.

For detailed information on how to contribute, see the [Contributing Guide](https://docs.langchain.com/oss/python/contributing/overview).
