Hunter Bown
9b87804057
- engine: apply elevated sandbox policy (network + workspace write) in YOLO mode - shell: pass policy override to interactive execution - ui: remove duplicate subagent list logging (already logged individually) - ui: remove unused format_subagent_list and format_subagent_status functions - prompts: add yolo.txt prompt file
DeepSeek CLI
A terminal-native TUI and CLI for DeepSeek models, built in Rust.
For DeepSeek models (current and future model IDs). Not affiliated with DeepSeek Inc.
What is this
A terminal-native agent loop that gives DeepSeek the tools it needs to actually write code: file editing, shell execution, web search, git operations, task tracking, and MCP server integration. Coherence-aware memory compaction keeps long sessions on track without blowing up the context window.
Three modes:
- Plan — design-first, proposes before acting
- Agent — multi-step autonomous tool use
- YOLO — full auto-approve, no guardrails (preloads tools by default)
Recent highlights: sub‑agent orchestration (background workers, parallel tool calls, dependency‑aware swarms), parallel tool execution (multi_tool_use.parallel), runtime HTTP/SSE API (deepseek serve --http), background task queue (/task), interactive configuration (/config), model discovery (/models), command palette (Ctrl+K), expandable tool payloads (v), persistent sidebar for live plan/todo/sub‑agent state, and model context‑window suffix hints (-32k, -256k).
Install
# From crates.io (requires Rust 1.85+)
cargo install deepseek-tui --locked
# Or from source
git clone https://github.com/Hmbown/DeepSeek-TUI.git
cd DeepSeek-TUI && cargo install --path . --locked
Setup
Create ~/.deepseek/config.toml:
api_key = "YOUR_DEEPSEEK_API_KEY"
Then run:
deepseek
Tab switches modes, F1 opens help, Esc cancels a running request.
Usage
deepseek # interactive TUI
deepseek -p "explain this in 2 sentences" # one-shot prompt
deepseek --yolo # agent mode, all tools auto-approved
deepseek doctor # check your setup
deepseek models # list available models
deepseek serve --http # start HTTP/SSE API server
Within the TUI, use /config, /models, /task, and Ctrl+K command palette.
Model IDs
Common model IDs: deepseek-chat, deepseek-reasoner.
Any valid deepseek-* model ID is accepted (including future releases). Model IDs can include context‑window suffix hints (-32k, -256k). To see live IDs from your configured endpoint:
deepseek models
Configuration
Everything lives in ~/.deepseek/config.toml. See config.example.toml for the full set of options.
Common environment overrides: DEEPSEEK_API_KEY, DEEPSEEK_BASE_URL, DEEPSEEK_CONFIG_PATH, DEEPSEEK_PROFILE, DEEPSEEK_ALLOW_SHELL, DEEPSEEK_TRUST_MODE, and DEEPSEEK_CAPACITY_*.
For the full config/env matrix (profiles, feature flags, capacity tuning, sandbox controls), see docs/CONFIGURATION.md.
Docs
Detailed docs are in the docs/ folder — architecture, modes, MCP integration, runtime API, etc.
License
MIT