DeepSeek CLI

A full-featured command-line interface for the DeepSeek API, modeled after Codex CLI and Claude Code. Uses deepseek-v4-pro by default.

Features

• Interactive REPL with streaming responses and reasoning display
• Non-interactive exec mode for scripting (deepseek exec "...")
• Built-in tools: read_file, write_file, list_files, run_command, grep_search
• Goal system (/goal) for objective steering across turns
• Lightweight subagent system (spawn_agent / wait_agent) with full tool access
• Sandbox modes: read-only, workspace-write, danger-full-access
• Approval policies: never, suggest, always

Install

git clone https://github.com/samsontands/deepseek-cli.git
cd deepseek-cli
pipx install .

Configure

Set your API key:

export DEEPSEEK_API_KEY=sk-...

Or create ~/.config/deepseek-cli/config.toml:

api_key = "sk-..."
model = "deepseek-v4-pro"

Usage

# Interactive
deepseek

# One-shot
deepseek exec "list files in /tmp using list_files, then summarize"

# Override model / sandbox
deepseek --model deepseek-v4-pro --sandbox workspace-write

Slash commands

• /goal <objective> — set or view the current goal
• /agents — list active subagents
• /tools — list available tools
• /clear — clear conversation history
• /help — show all commands

License

MIT