GitHub 'Hmbown/DeepSeek-TUI' 트렌딩… DeepSeek V4 1M 토큰·prefix cache 기반 터미널 코딩 에이전트, MCP·LSP·Plan/Agent/YOLO 3모드·rlm_query 1~16 병렬, 누적 1,787스타·당일 +564

DeepSeek V4의 1M 토큰 컨텍스트와 prefix cache를 기반으로 한 터미널 네이티브 코딩 에이전트 'DeepSeek TUI'(Hmbown/DeepSeek-TUI) 저장소가 GitHub 트렌딩에 올랐다. 누적 1,787스타에 당일 564스타를 추가했다. 단일 바이너리로 동작해 Node·Python 런타임이 필요 없고, MCP 클라이언트·샌드박스·내구성 있는 태스크 큐를 기본 탑재한다. 설치는 npm i -g deepseek-tui 다.

키보드 중심의 빠른 TUI를 통해 DeepSeek 프런티어 모델에 워크스페이스 직접 접근권을 부여한다. 파일 읽기·편집, 셸 명령 실행, 웹 검색·브라우징, git 관리, 서브 에이전트 오케스트레이션을 한 인터페이스에서 수행한다. 대상 모델은 1M 토큰 컨텍스트를 지원하는 deepseek-v4-pro와 deepseek-v4-flash이며, 모델이 작업을 풀어가는 추론(체인 오브 소트)이 실시간으로 스트리밍된다.

핵심 기능은 'rlm_query' 툴을 통한 네이티브 RLM(Recursive Language Model)이다. 기존 DeepSeek 클라이언트에 1~16개의 저렴한 deepseek-v4-flash 자식을 병렬로 분기시켜 일괄 분석·작업 분해·병렬 추론을 수행한다. 풀 툴 스위트로 파일 작업, 셸 실행, git, 웹 검색·브라우징, apply-patch, 서브 에이전트, MCP 서버를 지원하며 1M 토큰 컨텍스트가 가득 차면 자동 지능적 압축이 동작한다.

인터랙션 모드는 세 가지다. Plan(읽기 전용 탐색), Agent(승인 기반 인터랙티브), YOLO(자동 승인). 분해 우선 시스템 프롬프트로 모델이 행동에 앞서 checklist_write·update_plan을 호출하고 서브 에이전트를 스폰하도록 학습시킨다. 추론 강도는 Shift+Tab으로 off → high → max를 순환하며, 세션은 체크포인트로 저장·재개할 수 있다.

워크스페이스 롤백은 사이드 git의 턴 전·후 스냅샷 방식이다. /restore와 revert_turn으로 사용자의 .git을 건드리지 않고 변경을 되돌린다. 헤드리스 에이전트 워크플로용 HTTP/SSE 런타임 API(deepseek serve --http)와 MCP 프로토콜로 외부 툴을 확장할 수 있고, 라이브 비용 추적이 턴별·세션별 토큰 사용량과 비용 추정치를 보여준다. 다크 테마는 DeepSeek-블루 팔레트다.

아키텍처는 dispatcher → TUI → engine → tools 패턴이다. deepseek CLI 바이너리는 서브커맨드를 파싱해 deepseek-tui 컴패니언 바이너리에 인터랙티브 세션을 위임하는 경량 디스패처다. ratatui 기반 인터페이스가 비동기 엔진과 통신하며 OpenAI 호환 Chat Completions 스트리밍 클라이언트로 LLM에 사용자 입력을 보낸다. 응답에서 추출된 툴 호출은 타입드 툴 레지스트리(셸·파일·git·웹·서브 에이전트·MCP)로 디스패치되고 결과가 트랜스크립트로 스트리밍된다.

LSP 서브시스템(crates/tui/src/lsp/)은 편집 직후 진단을 수행한다. apply_patch·edit_file·write_file 후 엔진이 LSP 서버에 textDocument/didChange를 보내고 다음 추론 단계 전에 모델 컨텍스트에 오류·경고를 주입한다. 현재 rust-analyzer, pyright, typescript-language-server, gopls, clangd를 지원한다. RLM 서브시스템은 에이전트에 샌드박스화된 파이썬 REPL을 제공해 일괄 분류와 서브 LLM 오케스트레이션을 가능케 한다.

설치 옵션은 다양하다. cargo install deepseek-tui-cli --locked 로 deepseek 디스패처를, cargo install deepseek-tui --locked 로 컴패니언 TUI 바이너리를 설치할 수 있다(Rust 1.85+ 필요). 중국 본토에서 GitHub·npm 다운로드가 느릴 경우 칭화대 TUNA(sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/)를 Cargo 레지스트리 미러로 권장한다. DEEPSEEK_TUI_RELEASE_BASE_URL 환경변수로 TUNA·rsproxy·Tencent COS·Aliyun OSS 미러도 사용할 수 있다.

프로바이더는 DeepSeek 기본값 외에 NVIDIA NIM, Fireworks, 셀프 호스팅 SGLang을 지원한다. 중국 사용자용 ApiProvider::DeepseekCN은 api.deepseeki.com을 타깃으로 하며 첫 실행 시 zh-* 시스템 로케일을 자동 감지한다. v0.8.7은 v0.8.6에서 사용자·어시스턴트 메시지 본문에만 한정됐던 복사·선택을 시스템 노트·thinking 블록·툴 출력까지 다시 활성화한 패치다. 다만 v0.8.7에는 자체 업데이터의 플랫폼 매핑이 'aarch64'·'x86_64' 대신 릴리즈 산출물의 'arm64'·'x64'를 사용하지 못해 deepseek update 가 'no asset found for platform …'으로 실패하는 알려진 이슈(#503)가 있다. v0.8.8 수정 전까지는 npm i -g deepseek-tui 또는 cargo install deepseek-tui-cli --locked 로 업데이트하라고 안내한다.

v0.8.5에는 fetch_url의 SSRF 보호(루프백 전용 HTTP, 원격 호스트 DNS 핀, 내부 IP 대역 차단)가 들어갔으며 Hafeez Pizofreude(#261)와 Jason이 기여했다. Unic(YuniqueUnic)이 #365로 schemaui 기반 폼 스타일 설정 에디터를 추가해 /config tui로 호출할 수 있고, /config web은 web 피처가 활성화되어 있으면 브라우저 인터페이스를 띄운다. ~/.deepseek/에 대한 모든 쓰기는 write_atomic(tempfile + fsync + rename)을 통해 처리해 중간 크래시 시 손상을 막고, spawn_supervised는 태스크 패닉을 잡아 크래시 덤프와 함께 로깅한다. /init은 워크스페이스를 탐색해 Cargo.toml·package.json·pyproject.toml로 프로젝트 타입을 자동 감지하고 빌드·테스트 명령과 git log 기반 컨벤션을 담은 시작용 AGENTS.md를 작성한다.