deepagent-code 0.3.0

A Claude Code-style CLI for running LangGraph agents from the terminal

deepagent-code

A Claude Code-style CLI for running LangGraph agents from the terminal.

One agent, every surface

deepagent-code is the terminal surface of the deep-agent family: write your agent once — any LangGraph CompiledGraph — and run it on every surface with the same spec string (module:attr or path/to/file.py:attr), the same deepagents.toml config file, and the same DEEPAGENT_* environment variables.

Surface	Package	Try it
Web app	cowork-dash	cowork-dash run --agent my_agent.py:graph
JupyterLab	deepagent-lab	pip install deepagent-lab, then the chat sidebar in jupyter lab
Terminal	deepagent-code	you are here
VS Code	deepagent-vscode	chat participant + stdio sidecar
Reference agent	deepagent-hermes	DEEPAGENT_AGENT_SPEC=deepagent_hermes.agent:graph on any surface
Shared core	langgraph-stream-parser	typed events + config resolver behind every surface

Installation

pip install deepagent-code

Or install directly from GitHub:

pip install git+https://github.com/dkedar7/deepagent-code.git

Quick Start

No agent or API key yet? See the CLI working in one command:

deepagent-code --demo "hello"

Run with the default agent (requires ANTHROPIC_API_KEY):

export ANTHROPIC_API_KEY="your_api_key"
deepagent-code

Or specify your own agent:

deepagent-code -a path/to/your_agent.py:graph

This launches an interactive conversation loop with your agent.

Usage

# Use the default agent
deepagent-code

# Send a message directly
deepagent-code "Hello, agent!"

# Specify a custom agent file
deepagent-code -a my_agent.py:graph

# Use a module path
deepagent-code -a mypackage.agents:chatbot

# Read message from a file
deepagent-code -f ./prompt.md

# Non-interactive mode (auto-approve tool calls)
deepagent-code --no-interactive

# Verbose output
deepagent-code -v

# Keyless demo agent (no API key needed)
deepagent-code --demo

# Print the resolved configuration: each value, its source, and the
# env var / deepagents.toml key that sets it
deepagent-code --show-config

Commands

In the interactive loop:

• /q or /quit - Exit
• /c - Clear conversation history
• /h or /help - Show help

Environment Variables

# Agent location (path/to/file.py:variable_name or module:variable)
# (DEEPAGENT_SPEC is still accepted as a deprecated alias)
export DEEPAGENT_AGENT_SPEC="my_agent.py:graph"
deepagent-code

# Working directory
export DEEPAGENT_WORKSPACE_ROOT="/path/to/workspace"

# Stream mode (updates or values)
export DEEPAGENT_STREAM_MODE="updates"

Configuration Files

deepagent-code reads TOML config from two locations and merges them (project overrides global):

• Global: ~/.deepagents/config.toml (shared with the upstream deepagents CLI)
• Project: deepagents.toml in the current directory or any ancestor

Precedence: CLI args > env vars > project TOML > global TOML > defaults.

Example deepagents.toml:

[agent]
spec = "my_agent.py:graph"
workspace_root = "."

[ui]
verbose = true
async_mode = false
stream_mode = "updates"

[configurable]
# seeds LangGraph RunnableConfig.configurable
thread_id = "my-thread"

CLI Options

Usage: deepagent-code [OPTIONS] [MESSAGE]

Arguments:
  MESSAGE  Optional input to send to the agent immediately

Options:
  -a, --agent TEXT                Agent spec (path/to/file.py:graph or module:graph)
  -g, --graph-name TEXT           Graph variable name (default: "graph")
  -f, --file PATH                 Read message from a file (any extension)
  --interactive/--no-interactive  Handle interrupts (default: interactive)
  --async-mode/--sync-mode        Async streaming (default: sync)
  --stream-mode TEXT              Stream mode (updates or values)
  -v, --verbose                   Verbose output

Creating Your Own Agent

Your agent file should export a compiled LangGraph graph:

# my_agent.py
from deepagents import create_deep_agent
from langgraph.checkpoint.memory import MemorySaver

agent = create_deep_agent(
    name="My Agent",
    model="anthropic:claude-sonnet-4-20250514",
    checkpointer=MemorySaver(),
)

Then run it:

deepagent-code -a my_agent.py:agent

Programmatic Use

from deepagent_code import stream_graph_updates, prepare_agent_input

input_data = prepare_agent_input(message="Hello!")

for chunk in stream_graph_updates(graph, input_data):
    if chunk.get("chunk"):
        print(chunk["chunk"], end="")

License

MIT License - see LICENSE file for details.