Hmbown/DeepSeek-TUI

DeepSeek V4 를 위한 터미널 코딩 에이전트. deepseek 명령어를 통해 실행되며, 추론 블록을 스트리밍하고 승인 게이트를 통한 로컬 워크스페이스 편집 및 턴당 모델과 사고 수준을 선택하는 자동 모드를 포함합니다.

deepseek 는 Rust 바이너리로 배포되며: 디스패처 명령어 (deepseek) 와 동반 TUI 런타임 (deepseek-tui). 이미 사용하고 있는 설치 경로를 선택하세요; 모두 PATH 에 동일한 명령어를 배치합니다.
npm 패키지는 릴리스 바이너리를 위한 설치기/랩퍼이며, 에이전트 런타임 자체는 아닙니다.

# 1. npm — Node 를 이미 사용 중이라면 가장 쉬운 방법. 패키지는 GitHub 릴리스에서 매칭된 미리 구축된 Rust 바이너리를 다운로드합니다.
npm install -g deepseek-tui
...

중국 본토에서는 --registry=https://registry.npmmirror.com 를 사용하여 npm 경로를 가속화하거나 아래 Cargo 미러를 사용하세요.

DeepSeek TUI 는 터미널에서 실행되는 코딩 에이전트입니다. 파일 읽기 및 편집, 셸 명령어 실행, 웹 검색, git 관리, 키보드 구동 TUI 에서 서브 에이전트를 조정할 수 있습니다.

DeepSeek V4 (deepseek-v4-pro / deepseek-v4-flash) 를 기반으로 구축되며, 1M 토큰 컨텍스트 윈도우, 스트리밍 추론 블록, 프록시 캐시 인식 비용 보고를 포함합니다.

자동 모드—--model auto //model auto: 턴당 모델과 사고 수준을 선택합니다.사고 모드 스트리밍— 모델을 작업하는 동안 DeepSeek 추론 블록을 확인합니다.완전 도구 세트— 파일 연산, 셸 실행, git, 웹 검색/탐색, 패치 적용, 서브 에이전트, MCP 서버.1M 토큰 컨텍스트— 컨텍스트 추적, 수동 또는 설정된 압축, 프록시 캐시 테lemetry세 가지 모드— Plan (읽기 전용 탐색), Agent (승인 있는 상호작용), YOLO (자동 승인)사고 노력 계급—Shift + Tab 으로 off → high → max 사이클을 수행합니다.세션 저장/재개— 체크포인트 및 장기 실행 세션 재개워크스페이스 롤백— /restore 와 revert_turn 을 사용하여 .git 을 만지지 않고 서드-git 전후 턴 스냅샷내구형 작업 큐— 재시작 후에도 배경 작업이 생존합니다.HTTP/SSE 런타임 API— 헤드리스 에이전트 워크플로우를 위한 deepseek serve --httpMCP 프로토콜— 확장된 도구 연결을 위해 Model Context Protocol 서버에 연결하세요; docs/MCP.md 를 참조하세요.네이티브 RLM(rlm_query) — 저렴한 deepseek-v4-flash 를 통한 배치 분석 실행

동일한 API 클라이언트를 사용하는 children using the same API clientLSP diagnostics— inline error/warning surfacing after every edit via rust-analyzer, pyright, typescript-language-server, gopls, clangdUser memory— optional persistent note file injected into the system prompt for cross-session preferencesLocalized UI—en, ja, zh-Hans, pt-BR with auto-detectionLive cost tracking— per-turn and session-level token usage and cost estimates; cache hit/miss breakdownSkills system— composable, installable instruction packs from GitHub with no backend service required

deepseek (dispatcher CLI) → deepseek-tui (companion binary) → ratatui interface ↔ async engine ↔ OpenAI-compatible streaming client. Tool calls route through a typed registry (shell, file ops, git, web, sub-agents, MCP, RLM) and results stream back into the transcript. The engine manages session state, turn tracking, the durable task queue, and an LSP subsystem that feeds post-edit diagnostics into the model's context before the next reasoning step.

See docs/ARCHITECTURE.md for the full walkthrough.

npm install -g deepseek-tui
deepseek --version
deepseek --model auto

Prebuilt binaries are published for Linux x64, Linux ARM64 (v0.8.8+), macOS x64, macOS ARM64, and Windows x64. For other targets (musl, riscv64, FreeBSD, etc.), see Install from source or docs/INSTALL.md.

On first launch you'll be prompted for your DeepSeek API key. The key is saved to ~/.deepseek/config.toml so it works from any directory without OS credential prompts.

You can also set it ahead of time:

deepseek auth set --provider deepseek # saves to ~/.deepseek/config.toml
export DEEPSEEK_API_KEY="YOUR_KEY" # env var alternative; use ~/.zshenv for non-interactive shells
deepseek
...

If deepseek doctor says the rejected key came from DEEPSEEK_API_KEY, remove the stale export from your shell startup file, open a fresh shell, then run deepseek auth set --provider deepseek. Saved config keys take precedence over the environment and are easier to rotate.

To rotate or remove a saved key:
deepseek auth clear --provider deepseek.

Use deepseek --model auto or /model auto when you want DeepSeek TUI to decide how much model and reasoning power a turn needs.

Auto mode controls two settings together:

• Model:
  deepseek-v4-flash
  ordeepseek-v4-pro
• Thinking:
  off, high, ormax

Before the real turn is sent, the app makes a small deepseek-v4-flash

routing call with thinking off. That router looks at the latest request and recent context, then selects a concrete model and thinking level for the real request. Short/simple turns can stay on Flash with thinking off; coding, debugging, release work, architecture, security review, or ambiguous multi-step tasks can move up to Pro and/or higher thinking.

auto

is local to DeepSeek TUI. The upstream API never receives model: "auto"
; it receives the concrete model and thinking setting chosen for that turn. The TUI shows the selected route, and cost tracking is charged against the model that actually ran. If the router call fails or returns an invalid answer, the app falls back to a local heuristic. Sub-agents inherit auto mode unless you assign them an explicit model.

Use a fixed model or fixed thinking level when you want repeatable benchmarking, a strict cost ceiling, or a specific provider/model mapping.

npm i -g deepseek-tui

works on glibc-based ARM64 Linux from v0.8.8 onward. You can also download prebuilt binaries from the Releases page and place them side by side on your PATH
.

If GitHub or npm downloads are slow from mainland China, use a Cargo registry mirror:

# ~/.cargo/config.toml
[source.crates-io]
replace-with = "tuna"
...

Then install both binaries (the dispatcher delegates to the TUI at runtime):

cargo install deepseek-tui-cli --locked # provides `deepseek`
cargo install deepseek-tui --locked # provides `deepseek-tui`
deepseek --version

Prebuilt binaries can also be downloaded from GitHub Releases. Use DEEPSEEK_TUI_RELEASE_BASE_URL
for mirrored release assets.

Scoop is a Windows package manager. Once installed, run:

scoop install deepseek-tui

Install from source

Works on any Tier-1 Rust target — including musl, riscv64, FreeBSD, and older ARM64 distros.

# Linux build deps (Debian/Ubuntu/RHEL):
# sudo apt-get install -y build-essential pkg-config libdbus-1-dev
# sudo dnf install -y gcc make pkgconf-pkg-config dbus-devel
...

Both binaries are required. Cross-compilation and platform-specific notes: docs/INSTALL.md.

# NVIDIA NIM
deepseek auth set --provider nvidia-nim --api-key "YOUR_NVIDIA_API_KEY"
deepseek --provider nvidia-nim
...

A community-driven stabilization release focused on auth recovery, Windows terminals, Zed/ACP compatibility, setup friction, and clearer cost display. Full changelog.

친근한 인증 복구— 런타임 API 키 실패 시 활성 키가 오직 DEEPSEEK_API_KEY 에서만 온 경우에만 설명합니다

저장된 설정 키는 존재하지 않습니다Zed / ACP 어댑터—deepseek serve --acp

Zed 및 다른 호환 편집기를 위한 로컬 stdio Agent Client Protocol 서버를 노출합니다Windows 터미널 수정— UTF-8 콘솔 설정, 디스패처 재개 처리, 클립보드 대안, Ctrl+E 컴포저터 동작, 그리고 안전한 Windows 마우스 기본값Yuan 비용 표시— cost_currency = "cny"

(또는yuan

/rmb

)를 설정하여 푸터, /cost

, /tokens

, 및 알림 요약에서 CNY 를 표시합니다설정 및 스킬 다듬기— 워크스페이스 신뢰가 전역적으로 유지되며, 평문 Markdown SKILL.md

파일이 올바르게 로드되고, 전역 에이전트/커서 스킬 경로가 발견되며, TUI 는 슬래시 자동 완성에서 스킬을 표시합니다신뢰성 수정— 워크스페이스 범위 resume --last, API max_tokens 제한, deepseek doctor 에서 엔드포인트 진단, npm --version

대안, 및 현재 날짜 변환 메타데이터

depseek # 인터랙티브 TUI
depseek "이 함수 설명" # 한 번 프롬프트
depseek --model deepseek-v4-flash "요약" # 모델 오버라이드
...

DeepSeek 는 stdio 를 통해 로컬 ACP 에이전트를 생성하는 편집자를 위한 커스텀 Agent Client Protocol 서버로 실행할 수 있습니다. Zed 에서 커스텀 에이전트 서버를 추가합니다:

{
"agent_servers": {
"DeepSeek": {
...

첫 번째 ACP 슬라이스는 기존 DeepSeek 설정/API 키를 통해 새 세션 및 프롬프트 응답을 지원합니다. 도구 기반 편집 및 체크포인트 재생은 아직 ACP 를 통해 노출되지 않습니다.

키	동작
Tab
Complete / 또는 @ 항목; 실행 중에는 초안을 후속으로 큐에 대기시키며, 그렇지 않으면 사이클 모드
Shift+Tab
리asoning-effort 사이클: off → high → max
F1
검색 가능한 도움말 오버레이
Esc
백 / 무시
Ctrl+K
명령 팔레트
Ctrl+R
이전에 세션 재개
Alt+R
프롬프트 역사 검색 및 지워진 초안 복구
Ctrl+S
현재 초안 저장 (/stash list, /stash pop 으로 복구)
@path
컴포저터에서 파일/디렉토리 컨텍스트 연결
↑ (컴포저터 시작 시)
연결 행 선택 및 제거

완전 단축키 카탈로그: docs/KEYBINDINGS.md.

Mode	Behavior
Plan 🔍
Read-only investigation — model explores and proposes a plan (update_plan + checklist_write ) before making changes
Agent 🤖
Default interactive mode — multi-step tool use with approval gates; model outlines work via checklist_write
YOLO ⚡
Auto-approve all tools in a trusted workspace; still maintains plan and checklist for visibility

User config: ~/.deepseek/config.toml

. Project overlay: <workspace>/.deepseek/config.toml

(denied: api_key
, base_url
, provider
, mcp_config_path
). config.example.toml has every option.

Key environment variables:

Variable	Purpose
DEEPSEEK_API_KEY
API key
DEEPSEEK_BASE_URL
API base URL
DEEPSEEK_MODEL
Default model
DEEPSEEK_PROVIDER
deepseek (default), nvidia-nim , fireworks , sglang , vllm
DEEPSEEK_PROFILE
Config profile name
DEEPSEEK_MEMORY
Set to on to enable user memory
NVIDIA_API_KEY / FIREWORKS_API_KEY / SGLANG_API_KEY / VLLM_API_KEY
Provider auth
SGLANG_BASE_URL
Self-hosted SGLang endpoint
VLLM_BASE_URL
Self-hosted vLLM endpoint
NO_ANIMATIONS=1
Force accessibility mode at startup
SSL_CERT_FILE
Custom CA bundle for corporate proxies

UI locale is separate from model language — set locale
in settings.toml
, use /config locale zh-Hans
, or rely on LC_ALL
/LANG
. See docs/CONFIGURATION.md and docs/MCP.md.

| Model | Context | Input (cache hit) | Input (cache miss) | Output |
|---|---|
$0.003625 / 1M* |
$0.435 / 1M* |
$0.87 / 1M* |
deepseek-v4-flash |
1M |
$0.0028 / 1M |
$0.14 / 1M |
$0.28 / 1M |

Legacy aliases deepseek-chat
/ deepseek-reasoner
map to deepseek-v4-flash
. NVIDIA NIM variants use your NVIDIA account terms.

DeepSeek Pro rates currently reflect a limited-time 75% discount, which remains valid until 15:59 UTC on 31 May 2026. After that time, the TUI cost estimator will revert to the base Pro rates.

Note

For the latest DeepSeek-V4-Pro pricing, including the current 75% discount valid until 15:59 UTC on 31 May 2026, please consult the official DeepSeek pricing page. All rates listed in the README correspond to the officially published values.

DeepSeek TUI discovers skills from workspace directories (.agents/skills
→ skills
→ .opencode/skills
→ .claude/skills
→ .cursor/skills
) and global directories (~/.agents/skills
→ ~/.claude/skills)