Hunter Bown
cf45efa07b
- Bump workspace.package.version 0.8.33 -> 0.8.34 across all 14 crates - Bump npm wrapper version + deepseekBinaryVersion pin - Update docs/TOOL_SURFACE.md "Current surface" + docs/ARCHITECTURE.md current-surface references; historical "removed_in"/"v0.8.33 began moving" wording stays as fact - Update web/lib/facts.generated.ts version pin - Draft [0.8.34] CHANGELOG section covering the 135 commits since 0.8.33 (prefix-cache stability, bundled skills, Kitty/Ghostty notifications, theme picker, chunked tool dispatch, MCP session-id persistence, cost-calc reasoning tokens, and the in-flight internal cleanup) - Remove stale repo-root development artifacts: * TAKEOVER_PROMPT.md (v0.8.6 handoff, 3 minors stale) * PROMPT_ANALYSIS.md (v0.8.13-era prompt audit doc) * DEPENDENCY_GRAPH.md (claimed monolith layout, predates 14-crate split) docs/ARCHITECTURE.md already contains the live crate map. - Update CONTRIBUTING.md to reference docs/ARCHITECTURE.md for build ordering instead of the removed DEPENDENCY_GRAPH.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
deepseek-tui
Install and run the deepseek and deepseek-tui binaries from GitHub release artifacts.
Install
npm install -g deepseek-tui
# or
pnpm add -g deepseek-tui
For project-local usage:
npm install deepseek-tui
npx deepseek-tui --help
postinstall tries to download platform binaries into bin/downloads/ and
exposes deepseek and deepseek-tui commands. If GitHub release assets are
temporarily unreachable, install continues and the wrapper retries the download
on first run.
First run
deepseek login --api-key "YOUR_DEEPSEEK_API_KEY"
deepseek doctor
deepseek
The deepseek facade and deepseek-tui binary share ~/.deepseek/config.toml
for DeepSeek auth and default model settings. Common TUI commands are available
directly through the facade, including deepseek doctor, deepseek models,
deepseek sessions, and deepseek resume --last.
The app talks to DeepSeek's documented OpenAI-compatible Chat Completions API.
Set DEEPSEEK_BASE_URL only if you need the China endpoint or DeepSeek beta
features such as strict tool mode, chat prefix completion, or FIM completion.
NVIDIA NIM-hosted DeepSeek V4 Pro is also supported:
deepseek auth set --provider nvidia-nim --api-key "YOUR_NVIDIA_API_KEY"
deepseek --provider nvidia-nim
For a single process, set DEEPSEEK_PROVIDER=nvidia-nim and NVIDIA_API_KEY
or NVIDIA_NIM_API_KEY (with DEEPSEEK_API_KEY as a compatibility fallback).
The NIM default model is deepseek-ai/deepseek-v4-pro and the default base URL
is https://integrate.api.nvidia.com/v1. With --provider nvidia-nim,
--model deepseek-v4-flash maps to deepseek-ai/deepseek-v4-flash.
Supported platforms
Prebuilt binaries for the GitHub release are downloaded automatically:
- Linux x64
- Linux arm64 (v0.8.8+)
- macOS x64 / arm64
- Windows x64
Other platform/architecture combinations (musl, riscv64, FreeBSD, …) aren't
shipped as prebuilts. Unsupported platforms, checksum failures, and glibc
compatibility problems still fail with a clear error pointing you at
cargo install deepseek-tui-cli deepseek-tui --locked and the full
docs/INSTALL.md
build-from-source guide.
Configuration
- Default binary version comes from
deepseekBinaryVersioninpackage.json. - Set
DEEPSEEK_TUI_VERSIONorDEEPSEEK_VERSIONto override the release version. - Set
DEEPSEEK_TUI_GITHUB_REPOorDEEPSEEK_GITHUB_REPOto override the source repo (defaults toHmbown/DeepSeek-TUI). - Set
DEEPSEEK_TUI_RELEASE_BASE_URLto use an internal or mirrored release-asset directory when GitHub Releases is unavailable. The directory must containdeepseek-artifacts-sha256.txtand the platform binaries. - Set
DEEPSEEK_TUI_FORCE_DOWNLOAD=1to force download even when the cached binary is already present. - Set
DEEPSEEK_TUI_DISABLE_INSTALL=1to skip install-time download. - Set
DEEPSEEK_TUI_OPTIONAL_INSTALL=1to make install-time retryable download failures warn and exit0instead of failingnpm install.
Release integrity
npm publishruns a release-asset check to ensure all required binary assets exist for the target GitHub release before publishing.- Install-time downloads are verified against the release checksum manifest before the wrapper marks them executable.