Hunter Bown
ac1332565c
Highlights: - fix(client): SSE idle-timeout so a stalled stream surfaces a clear error instead of hanging the active cell (#76) - fix(tui): sidebar Agents panel reads live engine progress, not just the cached snapshot — matches the footer chip in real time (#63) - fix(tui): generic tool result preview preserves newlines for diff stats / file lists / todo snapshots (#80) - fix(tui): slash-menu scroll viewport now exercises center-tracking past the first 6 entries (#64) - feat(mcp): connect-failure errors include URL, status, body excerpt, transport — credentials masked (#71) - feat(tools): mark alias tools (spawn_agent, close_agent, send_input, delegate_to_agent) with _deprecation metadata; removal slated 0.8.0 (#72) - feat(capacity): V4 model priors (deepseek-v4-pro/flash) + key normalization, plus DEEPSEEK_CAPACITY_PRIOR_V4_* env overrides (#73) - feat(tools): explain parallel fan-out caps in agent_spawn vs rlm_query descriptions and error messages — cost-class table in TOOL_SURFACE.md (#81) - chore(errors): partial wiring of the error taxonomy — classify_error_message helper used in capacity controller, audit log fields pending (#66) - chore(providers): scaffold OpenRouter and Novita variants end-to-end (env keys, default base URLs, model normalization). Modal /provider picker UI still pending (#52) Build hygiene: - cargo fmt clean, cargo clippy --workspace -- -D warnings clean - cargo test --workspace passes (979+ tests across crates) - pre-existing dead-code warnings gated per-item with TODO refs to #61/#66 EOF )
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 downloads platform binaries into bin/downloads/ and exposes
deepseek and deepseek-tui commands.
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
- Linux x64
- macOS x64 / arm64
- Windows x64
Other platform/architecture combinations are not supported and will fail during install.
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_FORCE_DOWNLOAD=1to force download even when the cached binary is already present. - Set
DEEPSEEK_TUI_DISABLE_INSTALL=1to skip install-time download.
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.
- Set
DEEPSEEK_TUI_RELEASE_BASE_URLto point the installer at a local or staged release-asset directory for smoke tests.