DeepSeek TUI
DeepSeek TUI: A Terminal-native Coding Agent for Your Workspace
In the rapidly evolving world of AI-assisted development, DeepSeek TUI stands out as a terminal-native coding agent that brings the power of DeepSeek’s frontier models directly into your workspace. Built around DeepSeek V4’s 1M-token context window and prefix cache, this tool ships as a single binary and requires no Node.js or Python runtime. It also bundles an MCP client, a sandbox, and a durable task queue out of the box. This blog post walks you through what DeepSeek TUI is, what it can do, how it is wired, and how to get started—plus tips for advanced usage, deployment, and contribution.
Badges and visuals to set the scene:
- CI status:
- npm package:
- Crates.io:
- DeepWiki integration badge:
- Visual: DeepSeek TUI screenshot:

What Is It? DeepSeek TUI is a coding agent that runs entirely inside your terminal. It gives DeepSeek’s frontier models direct access to your workspace—reading and editing files, running shell commands, searching the web, managing git, and orchestrating sub-agents—all through a fast, keyboard-driven text user interface. It’s built for DeepSeek V4 variants (deepseek-v4-pro and deepseek-v4-flash) with a 1,000,000-token context window and native thinking-mode streaming, which means you can observe the model’s reasoning unfold in real time as it works through your tasks.
Key capabilities in short:
- Native running language model management (RLM) with parallel reasoning across multiple child analyses.
- Thinking-mode streaming to watch the model’s chain-of-thought as it reasons through problems.
- A full tool suite that covers file operations, shell execution, git commands, web search/browse, patch application, sub-agents, and MCP servers.
- An expansive 1M-token context with automatic compaction and prefix-cache awareness for cost efficiency.
- Three modes to suit different work styles: Plan (read-only exploration), Agent (interactive with approvals), and YOLO (auto-approved in trusted spaces).
- Reasoning-effort tiers you can cycle through (off → high → max) to tune how hard the model thinks before acting.
- Session save and resume, plus workspace rollback features that offer pre/post-turn snapshots without touching your repository’s .git folder.
- A durable task queue for background tasks that survive restarts, enabling long-running reviews and automation.
- An HTTP/SSE runtime API for headless workflows and a Model Context Protocol (MCP) ecosystem for extended tooling.
- Inline LSP diagnostics surfaced after edits, using engines like rust-analyzer, pyright, typescript-language-server, gopls, and clangd.
- Optional user memory for cross-session preferences, localized UI languages, live cost tracking, and a modular skills system that supports community-provided instruction packs with no backend service required.
Images and visuals give you a quick sense of the polish and the command surface you’ll be interacting with as you navigate your codebase in the terminal.
How It’s Wired At the core of DeepSeek TUI lies a layered, modular architecture that couples a dispatcher with a terminal UI and a streaming reasoning engine:
- The dispatcher (deepseek) orchestrates the flow, calling into the deepseek-tui companion binary.
- The TUI (ratatui-based interface) provides the keyboard-driven canvas for prompts, tool usage, and results.
- An asynchronous reasoning engine streams outputs that plumb back into the transcript, so you can see both the plan and the evolving solution.
- Tool calls pass through a typed registry to reach the right subsystem: shell, file ops, git, web, sub-agents, MCP, and the RLM interfaces.
- The engine handles session state, turn tracking, the durable task queue, and an LSP subsystem that injects post-edit diagnostics into the model’s context before the next reasoning step.
- For full details, see the architecture notes in docs/ARCHITECTURE.md.
This flow ensures you have continuous storytelling from planning to execution, with the ability to pause, approve, or adapt as needed between steps.
Quickstart Getting up and running is straightforward, and the distribution model makes it possible to avoid runtime bloat:
- Install the TUI: npm install -g deepseek-tui (the npm package is a thin installer that fetches the matching prebuilt binary; it does not bring Node runtime with it).
- Or install via Cargo if you prefer not to use Node: cargo install deepseek-tui-cli --locked for the dispatcher, and cargo install deepseek-tui --locked for the TUI binary.
- You can also download prebuilt binaries directly from GitHub Releases for Linux x64/ARM64, macOS x64/ARM64, and Windows x64.
- On first run, you’ll be prompted for your DeepSeek API key; it will be saved to ~/.deepseek/config.toml for seamless future use.
Sample quickstart commands:
- npm install -g deepseek-tui
- deepseek --version
- deepseek
- deepseek "explain this function" (one-shot prompt)
- deepseek --model deepseek-v4-flash "summarize" (model override)
- deepseek serve --http (start HTTP/SSE API server)
For users in China or dealing with network latency, there are mirror-friendly installation paths, such as replacing crates.io with a Tsinghua mirror and using a registry mirror. See the China/mirror-friendly section for details, including an example cargo config:
- [source.crates-io] replace-with = "tuna"
- [source.tuna] registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"
Images and visuals included here reflect the real-world UI you’ll interact with, including the screenshot to anchor your expectations of the terminal experience.
China / Mirror-friendly Installation If GitHub or npm downloads lag behind, you can speed things up with a Cargo registry mirror and side-by-side binaries on your PATH. A typical setup uses:
- A cargo config that points crates-io to a local fork or a university mirror.
- Then you’ll install both binaries (the dispatcher and the TUI) so the runtime can hand off to the TUI at execution time.
Windows users can leverage Scoop for a smooth install on Windows environments. The Scoop command is simple:
- scoop install deepseek-tui
What’s New In v0.8.12 This release brings a bundle of improvements, driven by community contributions. Notable items include:
- Reasoning-effort auto mode: reasoning_effort = "auto" selects the appropriate tier (debug/error → Max, search/lookup → Low, default → High) based on the prompt dynamics.
- Bash arity dictionary: auto_allow supports matching common command variants (e.g., git status vs. git status -s) and recognizes widely-used tools like git, cargo, npm, docker, and kubectl.
- Vim modal editing: a Vim-like modal editing experience in the composer, with normal and insert modes.
- Skill registry sync: /skills sync fetches and updates the community registry, helping you stay current.
- FIM edit tool: surgical code edits via DeepSeek’s /beta fill-in-the-middle capability.
- Large-tool-output routing improvements: outsized tool results get truncated previews with spillover handling to preserve context.
- Pluggable sandbox backends: exec_shell can route to remote sandboxes or other backends (e.g., Alibaba OpenSandbox).
- Layered permission rulesets: built-in, agent, and user priority layers for execpolicies (deny/allow).
- Cache-aware resident sub-agents: content prepended for 1M-token V4 prefix-cache locality; improved global lease table.
- Unified slash-command namespace: standardized command templates with $1/$2/$ARGUMENTS.
- Color::Reset migration: improved color handling for light terminals.
- Documentation updates: SECURITY.md, CODEOFCONDUCT.md, zh-Hans locale activation.
Usage DeepSeek TUI supports both interactive sessions and one-shot prompts. Here’s what you’ll typically do:
- Start an interactive TUI session with deepseek, then issue natural language prompts like “explain this function” or “optimize this module.”
- Use the Model Context Protocol (MCP) to connect to extended tooling ecosystems.
- Benefit from inline LSP diagnostics after edits, which helps you iteratively refine your code with real-time feedback.
- Save and resume sessions so long-running analyses aren’t lost in the event of a terminal or system restart.
- Switch modes (Plan, Agent, YOLO) based on how much automation you want versus hands-on control.
Modes
- Plan: Read-only, investigative mode where the model outlines a plan and a checklist before making changes.
- Agent: Default interactive mode where tools are used with approval gates; the model lays out work via a checklist write.
- YOLO: Auto-approve all tools within a trusted workspace; still maintains a plan and visibility through a checklist.
Configuration Your configuration is designed to be flexible, with a clear separation between user and project scopes:
- User config: ~/.deepseek/config.toml
- Project overlay: /.deepseek/config.toml (certain keys are denied in overlays: apikey, baseurl, provider, mcpconfigpath) Core environment variables you might set:
- DEEPSEEKAPIKEY: API key for authentication
- DEEPSEEKBASEURL: API base URL
- DEEPSEEK_MODEL: Default model
- DEEPSEEK_PROVIDER: Provider (default), or nvidia-nim, fireworks, sglang
- DEEPSEEK_MEMORY: Enable user memory
- NVIDIAAPIKEY / FIREWORKSAPIKEY / SGLANGAPIKEY: Provider auth
- SGLANGBASEURL: Self-hosted SGLang endpoint
- NO_ANIMATIONS: Force accessibility mode at startup
- SSLCERTFILE: Custom CA bundle for proxies Note: UI language is independent of the model language; you can set locale via settings or environment, and the docs provide guidance on matching UI and model language.
Models & Pricing DeepSeek TUI offers models with varying context windows and cost structures. Here are the key points in a concise, non-table format:
- deepseek-v4-pro: 1M context, pricing per 1M tokens (input with cache hit, input with cache miss, and output), with a current promotional discount that reduces Pro rates through a May 31, 2026 cutoff. This model is designed for high-quality reasoning with large context windows and robust memory.
- Example costs (illustrative): 1M input with cache hit around $0.003625, cache miss about $0.435, output around $0.87 per 1M tokens.
- deepseek-v4-flash: 1M context, lower base costs with different scaling, offering a faster, lighter-weight option for reactive tasks.
- Legacy aliases: deepseek-chat and deepseek-reasoner map to deepseek-v4-flash.
- NVIDIA NIM variants: These are tied to your NVIDIA account terms and possibly integrated hardware-accelerated pipelines.
- General pricing note: The figures above reflect current published rates; pro-level access may include promotional discounts, and you should consult the latest changelog and pricing pages for exact numbers.
Publishing Your Own Skill DeepSeek TUI ships with a scalable skills mechanism that lets you customize behavior and workflows without backend services. Skills are discovered from workspace directories in a chain of locations:
- .agents/skills → skills → .opencode/skills → .claude/skills, plus a global ~/.deepseek/skills directory. Each skill is a directory with a SKILL.md front-matter file, followed by content that describes how to use it. A minimal structure looks like:
- ~/.deepseek/skills/my-skill/
- SKILL.md The frontmatter in SKILL.md should include at least:
- name: my-skill
- description: Use this when DeepSeek should follow my custom workflow. Then the body contains Instructions for the agent:
- Commands: /skills (list), /skill (activate), /skill new (scaffold), /skill install github:/ (community), /skill update / uninstall / trust Community-installed skills from GitHub require no backend service. Installed skills appear in the model-visible session context, and the agent can auto-load relevant skills via load_skill when tasks align with a skill’s description.
Documentation A robust set of documents supports both new users and advanced integrators. Core references include:
- ARCHITECTURE.md: Codebase internals
- CONFIGURATION.md: Full configuration reference
- MODES.md: Plan / Agent / YOLO modes
- MCP.md: Model Context Protocol integration
- RUNTIME_API.md: HTTP/SSE API server
- INSTALL.md: Platform-specific install guide
- MEMORY.md: User memory feature guide
- SUBAGENTS.md: Sub-agent taxonomy and lifecycle
- KEYBINDINGS.md: Full shortcut catalog
- RELEASE_RUNBOOK.md and OPS RUNBOOK: Release and operations guides There is also a changelog to track progression over time.
Thanks and Community The project is a living, community-driven effort. Acknowledgments highlight contributors across features, fixes, and documentation refinement. The list includes individuals who submitted PRs, improved Markdown rendering, improved Windows-China install docs, memory documentation, glibc compatibility work, and more. The community-driven spirit is central to the project’s ongoing advancement, with many contributors recognized for their exacting improvements.
Contributing and License Contributions are welcome via the project’s CONTRIBUTING.md. The repository is MIT-licensed, inviting broad experimentation and adaptation. The project is not formally affiliated with DeepSeek Inc., though it leverages DeepSeek’s models and ecosystem.
Star History If you’re curious about the project’s momentum over time, you can view its star history chart here: https://www.star-history.com/?repos=Hmbown/DeepSeek-TUI&type=date&logscale=&legend=top-left And you can interact with the project on GitHub to see ongoing activity and community engagement.
Usage Scenarios and Practical Tips
- Local development: Use the TUI to scaffold code, run local linters and formatters, and patch your code with memory-backed context. The plan/agent/YOLO modes let you tailor the degree of automation to your risk tolerance.
- Complex builds: Chunk large tasks into staged prompts, use the 1M-token context to keep context across long refactors, and rely on session save/resume to checkpoint progress.
- Cross-team collaboration: Leverage MCP servers to bring standardized tooling into your workflows, enabling distributed teams to share context and tooling in a consistent way.
Key Shortcuts and Ergonomics (Summary)
- Tab: Auto-complete entries and queue follow-ups; cycle modes when not actively editing.
- Shift+Tab: Cycle reasoning effort levels (off → high → max).
- F1: Open the help overlay.
- Esc: Dismiss dialogs.
- Ctrl+K: Open the command palette.
- Ctrl+R: Resume an earlier session.
- Alt+R: Search prompt history and recover drafts.
- Ctrl+S: Stash the current draft for later recovery.
- @path: Attach a file or directory context to the composer.
- Arrow keys: Navigate within the composer context to manage attachments.
Closing Thoughts DeepSeek TUI represents a thoughtful blend of AI-powered capabilities with the pragmatics of terminal-based workflows. By delivering a self-contained binary that couples a robust model context window with a durable task queue, an integrated MCP ecosystem, and a rich set of tooling, it enables developers to work more intelligently inside their normal editor workflows. The combination of Plan/Agent/YOLO modes, live cost tracking, local UI localization, and extensible skills makes it possible to adapt the system to countless coding situations—from quick one-shot explanations to full-fledged, long-running code reviews and refactors.
If you’re intrigued by the potential of a terminal-native AI coding assistant, DeepSeek TUI is worth trying. Install, authenticate with your API key, and begin exploring the capability to read, modify, and reason about your codebase in a way that’s integrated with your current workspace. The project’s ongoing improvements—driven by a diverse set of contributors—promise a future where your terminal becomes an even more capable partner in software development.
Images and visuals included in this post reflect the API-driven, app-in-the-wild reality of the DeepSeek TUI experience, from the initial setup prompts to the live, streaming reasoning that unfolds as you work. For a deeper dive, consult the docs and changelogs linked throughout the sections above, and consider contributing your own skills to help extend the tool’s reach. The Star History link at the end provides a snapshot of community momentum and continued interest in this ambitious, terminal-first AI assistant.
Enjoying this project?
Discover more amazing open-source projects on TechLogHub. We curate the best developer tools and projects.
Repository:https://github.com/Hmbown/DeepSeek-TUI
GitHub - Hmbown/DeepSeek-TUI: DeepSeek TUI
DeepSeek TUI: Terminal-Native Coding Agent with 1M-Token Context...
github - hmbown/deepseek-tui