Install

Recommended — npm (one command, both binaries)

npm install -g deepseek-tui

The wrapper downloads both binaries from this Release and places them in the same directory.

Docker / GHCR

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:v0.8.24

The image ships the deepseek dispatcher and deepseek-tui runtime. The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required — deepseek-tui-cli produces the deepseek dispatcher and deepseek-tui produces the interactive runtime that the dispatcher delegates to. Installing only one binary will fail at runtime with a MISSING_COMPANION_BINARY error.

Manual download

Both binaries below must be downloaded for your platform and dropped into the same directory (e.g. ~/.local/bin/):

Then chmod +x both (Unix) and run ./deepseek.

Verify (recommended)

Download deepseek-artifacts-sha256.txt from this Release and verify:

# Linux
sha256sum -c deepseek-artifacts-sha256.txt

# macOS
shasum -a 256 -c deepseek-artifacts-sha256.txt

Changelog

See CHANGELOG.md for the full notes for this release.

Install

Recommended — npm (one command, both binaries)

npm install -g deepseek-tui

The wrapper downloads both binaries from this Release and places them in the same directory.

Docker / GHCR

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:v0.8.23

The image ships the deepseek dispatcher and deepseek-tui runtime. The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required — deepseek-tui-cli produces the deepseek dispatcher and deepseek-tui produces the interactive runtime that the dispatcher delegates to. Installing only one binary will fail at runtime with a MISSING_COMPANION_BINARY error.

Manual download

Both binaries below must be downloaded for your platform and dropped into the same directory (e.g. ~/.local/bin/):

Then chmod +x both (Unix) and run ./deepseek.

Verify (recommended)

Download deepseek-artifacts-sha256.txt from this Release and verify:

# Linux
sha256sum -c deepseek-artifacts-sha256.txt

# macOS
shasum -a 256 -c deepseek-artifacts-sha256.txt

Changelog

See CHANGELOG.md for the full notes for this release.

Install

Recommended — npm (one command, both binaries)

npm install -g deepseek-tui

The wrapper downloads both binaries from this Release and places them in the same directory.

Docker / GHCR

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:v0.8.22

The image ships the deepseek dispatcher and deepseek-tui runtime. The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required — deepseek-tui-cli produces the deepseek dispatcher and deepseek-tui produces the interactive runtime that the dispatcher delegates to. Installing only one binary will fail at runtime with a MISSING_COMPANION_BINARY error.

Manual download

Both binaries below must be downloaded for your platform and dropped into the same directory (e.g. ~/.local/bin/):

Then chmod +x both (Unix) and run ./deepseek.

Verify (recommended)

Download deepseek-artifacts-sha256.txt from this Release and verify:

# Linux
sha256sum -c deepseek-artifacts-sha256.txt

# macOS
shasum -a 256 -c deepseek-artifacts-sha256.txt

Changelog

See CHANGELOG.md for the full notes for this release.

Install

Recommended — npm (one command, both binaries)

npm install -g deepseek-tui

The wrapper downloads both binaries from this Release and places them in the same directory.

Docker / GHCR

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:v0.8.21

The image ships the deepseek dispatcher and deepseek-tui runtime. The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required — deepseek-tui-cli produces the deepseek dispatcher and deepseek-tui produces the interactive runtime that the dispatcher delegates to. Installing only one binary will fail at runtime with a MISSING_COMPANION_BINARY error.

Manual download

Both binaries below must be downloaded for your platform and dropped into the same directory (e.g. ~/.local/bin/):

Then chmod +x both (Unix) and run ./deepseek.

Verify (recommended)

Download deepseek-artifacts-sha256.txt from this Release and verify:

# Linux
sha256sum -c deepseek-artifacts-sha256.txt

# macOS
shasum -a 256 -c deepseek-artifacts-sha256.txt

Changelog

See CHANGELOG.md for the full notes for this release.

Install

Recommended — npm (one command, both binaries)

npm install -g deepseek-tui

The wrapper downloads both binaries from this Release and places them in the same directory.

Docker / GHCR

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:v0.8.20

The image ships the deepseek dispatcher and deepseek-tui runtime. The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required — deepseek-tui-cli produces the deepseek dispatcher and deepseek-tui produces the interactive runtime that the dispatcher delegates to. Installing only one binary will fail at runtime with a MISSING_COMPANION_BINARY error.

Manual download

Both binaries below must be downloaded for your platform and dropped into the same directory (e.g. ~/.local/bin/):

Then chmod +x both (Unix) and run ./deepseek.

Verify (recommended)

Download deepseek-artifacts-sha256.txt from this Release and verify:

# Linux
sha256sum -c deepseek-artifacts-sha256.txt

# macOS
shasum -a 256 -c deepseek-artifacts-sha256.txt

Changelog

See CHANGELOG.md for the full notes for this release.

Install

Recommended — npm (one command, both binaries)

npm install -g deepseek-tui

The wrapper downloads both binaries from this Release and places them in the same directory.

Docker / GHCR

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:v0.8.19

The image ships the deepseek dispatcher and deepseek-tui runtime. The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required — deepseek-tui-cli produces the deepseek dispatcher and deepseek-tui produces the interactive runtime that the dispatcher delegates to. Installing only one binary will fail at runtime with a MISSING_COMPANION_BINARY error.

Manual download

Both binaries below must be downloaded for your platform and dropped into the same directory (e.g. ~/.local/bin/):

Then chmod +x both (Unix) and run ./deepseek.

Verify (recommended)

Download deepseek-artifacts-sha256.txt from this Release and verify:

# Linux
sha256sum -c deepseek-artifacts-sha256.txt

# macOS
shasum -a 256 -c deepseek-artifacts-sha256.txt

Changelog

See CHANGELOG.md for the full notes for this release.

v0.8.18

This is the v0.8.17 follow-up release: a tighter TUI/runtime/install pass with safer session startup semantics, Docker images promoted to a supported install path, and several community PRs harvested into the release branch. VS Code and Feishu/Lark/mobile companion work remain out of scope for this release.

Install

Recommended: npm

npm install -g deepseek-tui

The npm wrapper installs both binaries: deepseek and deepseek-tui.

Docker / GHCR

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:v0.8.18

The image is published for linux/amd64 and linux/arm64. The latest tag is also updated.

Cargo

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required: deepseek-tui-cli provides the deepseek dispatcher, and deepseek-tui provides the interactive runtime.

Highlights

• Plain deepseek now starts a fresh session when opened again in the same folder; interrupted sessions are recovered explicitly with deepseek --continue.
• Docker release builds now publish ghcr.io/hmbown/deepseek-tui as a supported install path.
• Added draggable transcript scrollbar support when mouse capture is enabled.
• Fixed viewport drift / blank top rows after long turns and interactive subprocess handoff.
• Fixed light-theme readability regressions after /theme light.
• Made npm postinstall resilient to transient GitHub download/extract failures while keeping checksum, unsupported-platform, glibc, and wrapper failures fatal.
• Localized Chinese destructive approval dialogs while preserving explicit destructive-risk wording.
• Fixed FreeBSD compile fallback for the secrets crate.

Contributors

Thanks @Oliver-ZPLiu, @Fire-dtx, @bevis-wong, @oooyuy92, @wuwuzhijing, @qinxianyuzou, @axobase001, and @avysk for reports and contributions included in this release.

Install

Recommended — npm (one command, both binaries)

npm install -g deepseek-tui

The wrapper downloads both binaries from this Release and places them in the same directory.

Cargo (Linux / macOS)

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required — deepseek-tui-cli produces the deepseek dispatcher and deepseek-tui produces the interactive runtime that the dispatcher delegates to. Installing only one binary will fail at runtime with a MISSING_COMPANION_BINARY error.

Manual download

Both binaries below must be downloaded for your platform and dropped into the same directory (e.g. ~/.local/bin/):

Then chmod +x both (Unix) and run ./deepseek.

Verify (recommended)

Download deepseek-artifacts-sha256.txt from this Release and verify:

# Linux
sha256sum -c deepseek-artifacts-sha256.txt

# macOS
shasum -a 256 -c deepseek-artifacts-sha256.txt

Changelog

See CHANGELOG.md for the full notes for this release.

Install

Recommended — npm (one command, both binaries)

npm install -g deepseek-tui

The wrapper downloads both binaries from this Release and places them in the same directory.

Cargo (Linux / macOS)

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required — deepseek-tui-cli produces the deepseek dispatcher and deepseek-tui produces the interactive runtime that the dispatcher delegates to. Installing only one binary will fail at runtime with a MISSING_COMPANION_BINARY error.

Manual download

Both binaries below must be downloaded for your platform and dropped into the same directory (e.g. ~/.local/bin/):

Then chmod +x both (Unix) and run ./deepseek.

Verify (recommended)

Download deepseek-artifacts-sha256.txt from this Release and verify:

# Linux
sha256sum -c deepseek-artifacts-sha256.txt

# macOS
shasum -a 256 -c deepseek-artifacts-sha256.txt

Changelog

See CHANGELOG.md for the full notes for this release.

Install

Recommended — npm (one command, both binaries)

npm install -g deepseek-tui

The wrapper downloads both binaries from this Release and places them in the same directory.

Cargo (Linux / macOS)

cargo install deepseek-tui-cli deepseek-tui --locked

Both crates are required — deepseek-tui-cli produces the deepseek dispatcher and deepseek-tui produces the interactive runtime that the dispatcher delegates to. Installing only one binary will fail at runtime with a MISSING_COMPANION_BINARY error.

Manual download

Both binaries below must be downloaded for your platform and dropped into the same directory (e.g. ~/.local/bin/):

Then chmod +x both (Unix) and run ./deepseek.

Verify (recommended)

Download deepseek-artifacts-sha256.txt from this Release and verify:

# Linux
sha256sum -c deepseek-artifacts-sha256.txt

# macOS
shasum -a 256 -c deepseek-artifacts-sha256.txt

Changelog

See CHANGELOG.md for the full notes for this release.