Hunter BownDeepSeek TUI
npm i -g deepseek-tui
A coding agent for DeepSeek models that runs in your terminal.
Quickstart
npm install -g deepseek-tui
Start the TUI:
deepseek-tui
On first launch, it will prompt for your API key if one is not already configured.
You can also set auth ahead of time with either of these:
deepseek-tui login
DEEPSEEK_API_KEY="YOUR_DEEPSEEK_API_KEY" deepseek-tui
Other install methods
# From crates.io (requires Rust 1.85+)
cargo install deepseek-tui --locked # TUI
cargo install deepseek-tui-cli --locked # deepseek CLI facade
# From source
git clone https://github.com/Hmbown/DeepSeek-TUI.git
cd DeepSeek-TUI
cargo install --path crates/tui --locked
The canonical crates.io packages for this repository are deepseek-tui and
deepseek-tui-cli. The unrelated deepseek-cli crate is not part of this
project.
What it does
A terminal coding agent for DeepSeek models with file editing, shell execution, web.run browsing, git operations, session resume, and MCP server integration.
Three visible modes (Tab / Shift+Tab to cycle):
| Mode | Behavior |
|---|---|
| Plan | Review a plan before the agent starts making changes |
| Agent | Default interactive mode with multi-step tool use |
| YOLO | Auto-approve tools in a trusted workspace |
Usage
deepseek-tui # interactive TUI
deepseek-tui -p "explain this in 2 sentences" # one-shot prompt
deepseek-tui --yolo # YOLO mode
deepseek-tui login # save API key to config
deepseek-tui doctor # check setup
deepseek-tui models # list available models
deepseek-tui serve --http # HTTP/SSE API server
Controls: F1 help, Esc backs out of the current action, Ctrl+K command palette.
Configuration
~/.deepseek/config.toml — see config.example.toml for all options.
Key environment overrides: DEEPSEEK_API_KEY, DEEPSEEK_BASE_URL, DEEPSEEK_PROFILE.
Full reference: docs/CONFIGURATION.md.
Docs
docs/ — configuration, modes, MCP integration, runtime API, and release runbooks.
Contributing
See CONTRIBUTING.md. Not affiliated with DeepSeek Inc.