deepagents-cli

DeepAgents CLI - An AI coding assistant that runs in your terminal, powered by DeepAgents.

This package wraps the Python deepagents-cli as platform-specific binaries, allowing you to use the full-featured CLI without installing Python.

Installation

# Using npm
npm install -g deepagents-cli

# Using pnpm
pnpm add -g deepagents-cli

# Using yarn
yarn global add deepagents-cli

# Or run directly with npx (no installation required)
npx deepagents-cli

Quick Start

# Start the interactive CLI
deepagents

# Get help
deepagents help

# List available agents
deepagents list

Features

• Built-in Tools: File operations (read, write, edit, glob, grep), shell commands, web search, and subagent delegation
• Customizable Skills: Add domain-specific capabilities through a progressive disclosure skill system
• Persistent Memory: Agent remembers your preferences, coding style, and project context across sessions
• Project-Aware: Automatically detects project roots and loads project-specific configurations

Usage

Basic Commands

# Start the CLI (default agent)
deepagents

# Use a specific agent configuration
deepagents --agent mybot

# Use a specific model (auto-detects provider)
deepagents --model claude-sonnet-4-5-20250929
deepagents --model gpt-4o

# Auto-approve tool usage (skip human-in-the-loop prompts)
deepagents --auto-approve

# Execute code in a remote sandbox
deepagents --sandbox modal        # or runloop, daytona
deepagents --sandbox-id dbx_123   # reuse existing sandbox

Skills Management

# List all skills (global + project)
deepagents skills list

# Create a new skill
deepagents skills create my-skill

# View skill information
deepagents skills info web-research

Environment Variables

Set your API keys:

# Model providers (at least one required)
export ANTHROPIC_API_KEY="your-key"
export OPENAI_API_KEY="your-key"
export GOOGLE_API_KEY="your-key"

# Optional: Web search
export TAVILY_API_KEY="your-key"

# Optional: LangSmith tracing
export LANGCHAIN_TRACING_V2=true
export LANGCHAIN_API_KEY="your-key"

Supported Platforms

| Platform | Architecture | Package | | -------- | --------------------- | ------------------------------ | | Linux | x64 | @deepagents-cli/linux-x64 | | Linux | ARM64 | @deepagents-cli/linux-arm64 | | macOS | Intel (x64) | @deepagents-cli/darwin-x64 | | macOS | Apple Silicon (ARM64) | @deepagents-cli/darwin-arm64 | | Windows | x64 | @deepagents-cli/win32-x64 |

The appropriate platform package is automatically installed based on your system.

Troubleshooting

Binary not found

If you see an error about the binary not being found:

# Reinstall the package
npm uninstall -g deepagents-cli
npm install -g deepagents-cli

Unsupported platform

If your platform is not supported, please open an issue.

Version Synchronization

This package automatically mirrors the version of the Python deepagents-cli. New versions are typically available within 24 hours of a PyPI release.

Programmatic API

You can also use this package programmatically:

import { getBinaryPath, isAvailable, getVersion } from "deepagents-cli";

// Check if CLI is available for this platform
if (isAvailable()) {
  const binaryPath = getBinaryPath();
  console.log(`CLI binary at: ${binaryPath}`);
}

// Get installed version
const version = getVersion();
console.log(`Version: ${version}`);

License

MIT - see LICENSE

Related

• deepagents - The core DeepAgents library for building AI agents
• deepagents-cli (PyPI) - The Python version of this CLI
• LangGraph - Framework for building stateful agents