🐳 DeepSeek TUI

このターミナルネイティブのコーディングエージェントは、DeepSeek V4 の 100 万トークンのコンテキストウィンドウとプレフィックスキャッシュ機能を中心に構築されています。単一のバイナリとして配布され、Node.js や Python のランタイムは不要です。MCP クライアント、サンドボックス、永続的なタスクキューも標準で同梱されています。

English README 简体中文 README

deepseek は自己完結型の Rust バイナリとして提供されており、実行に Node.js や Python のランタイムは必要ありません。 すでにマシンにインストールされているものを選んでください。いずれの方法でも同じバイナリが PATH に配置されます。

# 1. npm — すでに Node を使っているなら最も簡単。npm パッケージは
#    GitHub Releases から対応するビルド済みバイナリをダウンロードする
#    薄いインストーラーであり、deepseek 本体に Node ランタイム依存を加えるものではありません。
npm install -g deepseek-tui

# 2. Cargo — Node 不要。
cargo install deepseek-tui-cli --locked   # `deepseek` (エントリーポイント)
cargo install deepseek-tui     --locked   # `deepseek-tui` (TUI バイナリ)

# 3. 直接ダウンロード — Node もツールチェーンも不要。
#    https://github.com/Hmbown/DeepSeek-TUI/releases
#    Linux x64/ARM64、macOS x64/ARM64、Windows x64 向けのビルド済みバイナリがあります。

中国本土では、--registry=https://registry.npmmirror.com を指定して npm 経由のダウンロードを高速化するか、下記のCargo ミラーを利用してください。

DeepSeek TUI は、ターミナル内で完結するコーディングエージェントです。DeepSeek のフロンティアモデルがあなたのワークスペースに直接アクセスできるようにし、ファイルの読み取り・編集、シェルコマンドの実行、Web 検索、Git 管理、サブエージェントの統制などを、すべて高速でキーボード駆動の TUI を通じて行えます。

DeepSeek V4 向けに構築 (deepseek-v4-pro / deepseek-v4-flash)。100 万トークンのコンテキストウィンドウとネイティブの thinking-mode（思考連鎖）ストリーミングをサポートします。

• ネイティブ RLM (rlm_query) — 1〜16 個の安価な deepseek-v4-flash 子プロセスを並列に起動し、既存の API クライアントに対してバッチ解析と並列推論を実行
• Thinking-mode ストリーミング — モデルがタスクに取り組む様子をリアルタイムで観察し、思考連鎖の展開を追える
• 完全なツールスイート — ファイル操作、シェル実行、Git、Web 検索／ブラウズ、apply-patch、サブエージェント、MCP サーバー
• 100 万トークンコンテキスト — コンテキストが満杯になると自動でインテリジェントにコンパクション。プレフィックスキャッシュを意識したコスト効率
• 3 つのモード — Plan（読み取り専用の探索）、Agent（承認ありのインタラクティブ）、YOLO（自動承認）
• 推論努力ティア — Shift + Tab で off → high → max を切り替え
• セッション保存／再開 — 長時間実行のセッションをチェックポイント化して再開可能
• ワークスペースのロールバック — リポジトリの .git には触れずに、サイド Git によるターン前後のスナップショットを /restore と revert_turn で扱える
• 永続的タスクキュー — 再起動を超えて生き残るバックグラウンドタスク。スケジュール自動化や長時間レビューなどに
• HTTP/SSE ランタイム API — deepseek serve --http でヘッドレスエージェントワークフローを実現
• MCP プロトコル — Model Context Protocol サーバーに接続して拡張ツールを利用可能。詳細は docs/MCP.md を参照
• LSP 診断 — rust-analyzer、pyright、typescript-language-server、gopls、clangd により、編集ごとにエラー／警告をインライン表示
• ユーザーメモリ — クロスセッションの嗜好をシステムプロンプトに注入できる、オプションの永続メモファイル
• ローカライズ済み UI — en、ja、zh-Hans、pt-BR を自動検出
• ライブコスト追跡 — ターンごと／セッションごとのトークン使用量とコスト見積もり、キャッシュヒット／ミスの内訳
• スキルシステム — GitHub から取得できる、合成・インストール可能な命令パック。バックエンドサービス不要

deepseek（ディスパッチャー CLI）→ deepseek-tui（コンパニオンバイナリ）→ ratatui インターフェース ↔ 非同期エンジン ↔ OpenAI 互換のストリーミングクライアント。ツール呼び出しは型付きレジストリ（シェル、ファイル操作、Git、Web、サブエージェント、MCP、RLM）を経由してルーティングされ、結果はトランスクリプトへとストリーム返送されます。エンジンはセッション状態、ターン管理、永続タスクキューを管理し、LSP サブシステムは編集後の診断を次の推論ステップ前にモデルのコンテキストへ供給します。

詳しくは docs/ARCHITECTURE.md を参照してください。

npm install -g deepseek-tui
deepseek --version
deepseek

ビルド済みバイナリは Linux x64、Linux ARM64（v0.8.8 以降）、macOS x64、macOS ARM64、Windows x64 向けに公開されています。その他のターゲット（musl、riscv64、FreeBSD など）は ソースからのインストール または docs/INSTALL.md を参照してください。

初回起動時に DeepSeek API キー の入力を求められます。キーは ~/.deepseek/config.toml に保存されるため、OS のクレデンシャルプロンプトなしに任意のディレクトリから利用できます。

事前に設定することもできます:

deepseek auth set --provider deepseek   # ~/.deepseek/config.toml に保存

export DEEPSEEK_API_KEY="YOUR_KEY"      # 環境変数による代替方法。非対話シェルでは ~/.zshenv を使用
deepseek

deepseek doctor                         # セットアップを検証

保存済みキーをローテーション／削除するには: deepseek auth clear --provider deepseek。

npm i -g deepseek-tui は v0.8.8 以降、glibc ベースの ARM64 Linux で動作します。Releases ページ からビルド済みバイナリをダウンロードし、PATH 上に並べて配置することもできます。

中国本土から GitHub または npm のダウンロードが遅い場合は、Cargo レジストリのミラーを利用してください:

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

[source.tuna]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

その後、両方のバイナリをインストールしてください（ディスパッチャーは実行時に TUI へ委譲します）:

cargo install deepseek-tui-cli --locked   # `deepseek` を提供
cargo install deepseek-tui     --locked   # `deepseek-tui` を提供
deepseek --version

ビルド済みバイナリは GitHub Releases からもダウンロードできます。ミラーされたリリースアセットには DEEPSEEK_TUI_RELEASE_BASE_URL を使ってください。

Scoop は Windows のパッケージマネージャです。インストール後、次を実行してください:

scoop install deepseek-tui

# Linux のビルド依存関係 (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

git clone https://github.com/Hmbown/DeepSeek-TUI.git
cd DeepSeek-TUI

cargo install --path crates/cli --locked   # Rust 1.85+ が必要。`deepseek` を提供
cargo install --path crates/tui --locked   # `deepseek-tui` を提供

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

# Fireworks
deepseek auth set --provider fireworks --api-key "YOUR_FIREWORKS_API_KEY"
deepseek --provider fireworks --model deepseek-v4-pro

# セルフホスト SGLang
SGLANG_BASE_URL="http://localhost:30000/v1" deepseek --provider sglang --model deepseek-v4-flash

v0.8.11 のキャッシュ最適化基盤の上に、コミュニティから 20 件の PR を加えた機能リリースです。完全な変更履歴。

• 推論努力の自動モード — reasoning_effort = "auto" がプロンプトから適切なティアを選択。debug/error → Max、search/lookup → Low、デフォルト → High
• Bash arity 辞書 — auto_allow = ["git status"] は git status -s にマッチし、git push にはマッチしない。git、cargo、npm、docker、kubectl ほかを認識
• Vim モーダル編集 — 標準的な Vim キーバインディングによる normal/insert モードをコンポーザーで利用可能
• スキルレジストリ同期 — /skills sync でコミュニティレジストリを取得・インストール／更新
• FIM 編集ツール — DeepSeek の /beta fill-in-the-middle エンドポイントによる外科的なコード編集
• 大型ツール出力のルーティング — 巨大なツール結果は切り詰められたプレビューとスピルオーバーになり、親コンテキストを保護
• プラガブルなサンドボックスバックエンド — exec_shell を Alibaba OpenSandbox やその他のリモートバックエンドへルーティング可能
• 階層化された権限ルールセット — execpolicy の deny/allow ルールに builtin/agent/user の優先度レイヤーを導入
• キャッシュ対応の常駐サブエージェント — V4 のプレフィックスキャッシュ局所性のためにファイル内容を先頭付加。グローバルなリーステーブル
• 統一されたスラッシュコマンド名前空間 — $1/$2/$ARGUMENTS テンプレートに対応したユーザーコマンド
• Color::Reset への移行 — ハードコードされた背景色をすべて Color::Reset に置き換え、ライトターミナルに対応
• 新しいドキュメント: SECURITY.md (#648)、CODE_OF_CONDUCT.md (#686)、zh-Hans ロケールの有効化 (#652)

@merchloubna70-dot によるコミュニティ PR 28 件。初回コントリビューターは @zichen0116 (#686)。

deepseek                                         # インタラクティブ TUI
deepseek "explain this function"                 # ワンショットプロンプト
deepseek --model deepseek-v4-flash "summarize"   # モデルの上書き
deepseek --yolo                                  # ツールを自動承認
deepseek auth set --provider deepseek            # API キーの保存
deepseek doctor                                  # セットアップと接続性のチェック
deepseek doctor --json                           # 機械可読の診断
deepseek setup --status                          # 読み取り専用のセットアップ状態
deepseek setup --tools --plugins                 # ツール／プラグインディレクトリの雛形作成
deepseek models                                  # ライブ API モデル一覧
deepseek sessions                                # 保存済みセッション一覧
deepseek resume --last                           # 最新セッションを再開
deepseek resume <SESSION_ID>                     # UUID 指定で特定セッションを再開
deepseek fork <SESSION_ID>                       # 任意のターンでセッションを fork
deepseek serve --http                            # HTTP/SSE API サーバー
deepseek pr <N>                                  # PR を取得しレビュープロンプトに先行投入
deepseek mcp list                                # 設定された MCP サーバー一覧
deepseek mcp validate                            # MCP の設定／接続性を検証
deepseek mcp-server                              # ディスパッチャー MCP stdio サーバーを実行

ショートカット完全版: docs/KEYBINDINGS.md。

ユーザー設定: ~/.deepseek/config.toml。プロジェクトオーバーレイ: <workspace>/.deepseek/config.toml（拒否される項目: api_key、base_url、provider、mcp_config_path）。すべてのオプションは config.example.toml にあります。

主な環境変数:

UI のロケールはモデルの言語とは別です。settings.toml で locale を設定するか、/config locale zh-Hans を使うか、LC_ALL/LANG に依存させてください。詳しくは docs/CONFIGURATION.md と docs/MCP.md を参照してください。

レガシーエイリアス deepseek-chat / deepseek-reasoner は deepseek-v4-flash にマップされます。NVIDIA NIM のバリアントはあなたの NVIDIA アカウント条件に従います。

DeepSeek Pro の料金は現在、期間限定で 75% の割引が適用されており、2026 年 5 月 31 日 15:59 UTC まで有効です。それ以降、TUI のコスト見積もりは Pro の通常料金に戻ります。

DeepSeek TUI はワークスペースのディレクトリ（.agents/skills → skills → .opencode/skills → .claude/skills）とグローバルな ~/.deepseek/skills からスキルを発見します。各スキルは SKILL.md ファイルを持つディレクトリです:

~/.deepseek/skills/my-skill/
└── SKILL.md

必要なフロントマター:

---
name: my-skill
description: DeepSeek にカスタムワークフローを実行させたいときに利用する。
---

# My Skill
ここにエージェント向けの指示を記述します。

コマンド: /skills（一覧）、/skill <name>（有効化）、/skill new（雛形）、/skill install github:<owner>/<repo>（コミュニティ）、/skill update / uninstall / trust。GitHub からのコミュニティインストールにバックエンドサービスは不要です。インストール済みのスキルはモデルに見えるセッションコンテキストに表示され、タスクが説明文にマッチした場合はエージェントが load_skill ツールを通じて関連スキルを自動選択できます。

完全な変更履歴: CHANGELOG.md。

このプロジェクトは、増え続けるコントリビューターのコミュニティから助けを得て出荷されています:

• merchloubna70-dot — 機能、修正、VS Code 拡張のスキャフォールドにまたがる 28 件の PR (#645–#681)
• WyxBUPT-22 — 表、太字／斜体、水平線の Markdown レンダリング (#579)
• loongmiaow-pixel — Windows と中国向けインストールドキュメント (#578)
• 20bytes — ユーザーメモリのドキュメントとヘルプの磨き込み (#569)
• staryxchen — glibc 互換性のプリフライト (#556)
• Vishnu1837 — glibc 互換性の改善 (#565)
• shentoumengxin — シェル cwd の境界バリデーション (#524)
• toi500 — Windows 貼り付け修正の報告
• xsstomy — ターミナル起動時の再描画報告
• melody0709 — スラッシュ接頭辞の Enter アクティベーション報告
• lloydzhou と jeoor — コンパクションコストの報告
• Agent-Skill-007 — README の明瞭化対応 (#685)
• woyxiang — Windows Scoop インストールドキュメント (#696)
• wangfeng — 料金／割引情報の更新 (#692)
• zichen0116 — CODE_OF_CONDUCT.md (#686)
• Hafeez Pizofreude — fetch_url の SSRF 保護と Star History チャート
• Unic (YuniqueUnic) — スキーマ駆動の設定 UI（TUI + Web）
• Jason — SSRF セキュリティの強化

CONTRIBUTING.md を参照してください。プルリクエストを歓迎します。良い初コントリビューションは Open Issues を確認してください。

MIT