Skip to content

Releases: Hmbown/CodeWhale

v0.8.47 — Verification Gate, Goal Tools, DuckDuckGo Default

27 May 03:59

Choose a tag to compare

This release renames the project to CodeWhale. The legacy
deepseek and deepseek-tui binaries continue to ship as
deprecation shims for one release cycle; they print a one-line
warning and forward to codewhale / codewhale-tui. They will
be removed in v0.9.0. See docs/REBRAND.md for the full
migration story.

Install

Recommended — npm (one command, both binaries)

npm install -g codewhale

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/codewhale/.deepseek \
  ghcr.io/hmbown/codewhale:v0.8.47

The image ships the codewhale dispatcher and codewhale-tui runtime (plus the legacy deepseek / deepseek-tui shims during the transition). The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install codewhale-cli codewhale-tui --locked

Both crates are required — codewhale-cli produces the codewhale dispatcher and codewhale-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 — platform archives (recommended)

Each archive below contains both the codewhale dispatcher and codewhale-tui runtime, plus an install script:

Platform Archive Install script
Linux x64 codewhale-linux-x64.tar.gz install.sh
Linux ARM64 codewhale-linux-arm64.tar.gz install.sh
macOS x64 codewhale-macos-x64.tar.gz install.sh
macOS ARM codewhale-macos-arm64.tar.gz install.sh
Windows x64 codewhale-windows-x64.zip install.bat
Windows x64 (portable) codewhale-windows-x64-portable.zip

Unix (Linux / macOS):

tar xzf codewhale-<platform>.tar.gz
cd codewhale-<platform>
./install.sh

Windows:

  • Extract codewhale-windows-x64.zip
  • Run install.bat (copies to %USERPROFILE%\bin)
  • Add %USERPROFILE%\bin to your PATH

The portable Windows archive skips the install script — extract and run from any directory.

Individual binaries are also attached below for scripting and the npm wrapper. Legacy deepseek-* and deepseek-tui-* assets ship for one release cycle so that existing deepseek update invocations on v0.8.40 keep working; they install the deprecation shims, which forward to the canonical binaries.

Verify (recommended)

Download the checksum manifests from this Release and verify:

# Linux — archive bundles
sha256sum -c codewhale-bundles-sha256.txt

# Linux — individual binaries
sha256sum -c codewhale-artifacts-sha256.txt

# macOS
shasum -a 256 -c codewhale-bundles-sha256.txt
shasum -a 256 -c codewhale-artifacts-sha256.txt

The legacy deepseek-artifacts-sha256.txt is also attached for backward compatibility and contains the same hashes as the canonical manifest.

Changelog

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

Contributors

Thanks to everyone whose PRs landed in this release:

@Fire-dtx (#1856) • @imkingjh999 (#2228) • @harvey2011888 (#1859) • @victorcheng2333 (#1870) • @IIzzaya (#1935) • @PurplePulse (#1837) • @cyq1017 (#1967) • @knqiufan (#1906) • @Colorful-glassblock (#1937) • @hongqitai (#2237) • @EmiyaKiritsugu3 (#1852) • @aboimpinto (#1910) • @HUQIANTAO (#2240) • @mvanhorn (#2156) • @LING71671 (#1797) • @reidliu41 (#2241, #2235)

v0.8.46

26 May 17:59

Choose a tag to compare

This release renames the project to CodeWhale. The legacy
deepseek and deepseek-tui binaries continue to ship as
deprecation shims for one release cycle; they print a one-line
warning and forward to codewhale / codewhale-tui. They will
be removed in v0.9.0. See docs/REBRAND.md for the full
migration story.

Install

Recommended — npm (one command, both binaries)

npm install -g codewhale

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/codewhale/.deepseek \
  ghcr.io/hmbown/codewhale:v0.8.46

The image ships the codewhale dispatcher and codewhale-tui runtime (plus the legacy deepseek / deepseek-tui shims during the transition). The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install codewhale-cli codewhale-tui --locked

Both crates are required — codewhale-cli produces the codewhale dispatcher and codewhale-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 — platform archives (recommended)

Each archive below contains both the codewhale dispatcher and codewhale-tui runtime, plus an install script:

Platform Archive Install script
Linux x64 codewhale-linux-x64.tar.gz install.sh
Linux ARM64 codewhale-linux-arm64.tar.gz install.sh
macOS x64 codewhale-macos-x64.tar.gz install.sh
macOS ARM codewhale-macos-arm64.tar.gz install.sh
Windows x64 codewhale-windows-x64.zip install.bat
Windows x64 (portable) codewhale-windows-x64-portable.zip

Unix (Linux / macOS):

tar xzf codewhale-<platform>.tar.gz
cd codewhale-<platform>
./install.sh

Windows:

  • Extract codewhale-windows-x64.zip
  • Run install.bat (copies to %USERPROFILE%\bin)
  • Add %USERPROFILE%\bin to your PATH

The portable Windows archive skips the install script — extract and run from any directory.

Individual binaries are also attached below for scripting and the npm wrapper. Legacy deepseek-* and deepseek-tui-* assets ship for one release cycle so that existing deepseek update invocations on v0.8.40 keep working; they install the deprecation shims, which forward to the canonical binaries.

Verify (recommended)

Download the checksum manifests from this Release and verify:

# Linux — archive bundles
sha256sum -c codewhale-bundles-sha256.txt

# Linux — individual binaries
sha256sum -c codewhale-artifacts-sha256.txt

# macOS
shasum -a 256 -c codewhale-bundles-sha256.txt
shasum -a 256 -c codewhale-artifacts-sha256.txt

The legacy deepseek-artifacts-sha256.txt is also attached for backward compatibility and contains the same hashes as the canonical manifest.

Contributors

Backfilled into the GitHub Release body from the v0.8.46 changelog, merged PRs, and the v0.8.45...v0.8.46 compare range.

  • @donglovejava — paste @file consolidation, CJK panic fix, user feedback, RLM output routing, and edit_file retry fixes (#2154, #2163, #2166, #2167, #2168).
  • @encyc — session token breakdown in the footer and /status (#2152).
  • @saieswar237 — review pipeline documentation (#2178).
  • @sximelon — paste Enter suppression and file-tree key-handler extraction (#2174, #2042).
  • @nanookclaw — search provider visibility in doctor output (#2135).
  • @Sskift — profile-safe CLI environment override handling (#2119).
  • @xin1104 — Homebrew formula fix for canonical CodeWhale binaries and legacy shims (#2105).
  • @mrluanma — Metaso web search provider support (#2059).
  • @Lellansin — project-scope config guardrail for home-directory workspaces (#2055).
  • @zhuangbiaowei — update release channel improvements (#2145).
  • @aboimpinto — taskbar progress, animated title spinner, and configurable completion sound (#1872).
  • @reidliu41 — approval confirmation flow and model picker Esc behavior (#2143, #2056).
  • @cyq1017 — actionable goal prompts and sub-agent completion handoff fixes (#2097, #2120).
  • @idling11 — readable /restore snapshot labels, sidebar hover tooltips, and vLLM reasoning-effort pass-through (#2111, #2110, #2170).
  • @h3c-hexin — sub-agent runtime message compatibility, tight-context budgeting, grep_files timeout hardening, and max-output-token override support (#2057, #2060, #2146, #2147).
  • @wdw8276 — composer session title display (#2108).
  • @zlh124 — SKILL.md YAML block-scalar parsing (#1908).
  • @jeoor — continuing contributor credit preserved in the public Thanks list and release changelog.
  • @hongqitai — TERM_PROGRAM-aware no-animation test coverage (#2171).
  • @yuanchenglu — Feishu topic/thread reply handling (#2148).
  • @New2Niu — fuzzy command support (#2043).
  • @quentin-lian — portable-pty upgrade for LoongArch64 support (#1992).
  • @kunpeng-ai-lab — apply_patch preflight metadata and Cargo failure summaries (#1971, #1973).
  • @ousamabenyounesthread clear-name command support (#1939).
  • @Hmbown — release engineering, platform archive bundles, sandbox hardening, install-page updates, docs refresh, and release-lane fixes.

Changelog

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

v0.8.45 — DeepSeek-first harness framing

26 May 11:47

Choose a tag to compare

This release renames the project to CodeWhale. The legacy
deepseek and deepseek-tui binaries continue to ship as
deprecation shims for one release cycle; they print a one-line
warning and forward to codewhale / codewhale-tui. They will
be removed in v0.9.0. See docs/REBRAND.md for the full
migration story.

Install

Recommended — npm (one command, both binaries)

npm install -g codewhale

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/codewhale/.deepseek \
  ghcr.io/hmbown/codewhale:v0.8.45

The image ships the codewhale dispatcher and codewhale-tui runtime (plus the legacy deepseek / deepseek-tui shims during the transition). The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install codewhale-cli codewhale-tui --locked

Both crates are required — codewhale-cli produces the codewhale dispatcher and codewhale-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/):

Platform Dispatcher TUI runtime
Linux x64 codewhale-linux-x64 codewhale-tui-linux-x64
Linux ARM64 codewhale-linux-arm64 codewhale-tui-linux-arm64
macOS x64 codewhale-macos-x64 codewhale-tui-macos-x64
macOS ARM codewhale-macos-arm64 codewhale-tui-macos-arm64
Windows x64 codewhale-windows-x64.exe codewhale-tui-windows-x64.exe

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

Legacy deepseek-* and deepseek-tui-* assets are also attached for one release cycle so that existing deepseek update invocations on v0.8.40 keep working; they install the deprecation shims, which forward to the canonical binaries.

Verify (recommended)

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

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

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

The legacy deepseek-artifacts-sha256.txt is also attached for backward compatibility and contains the same hashes.

Changelog

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

v0.8.44

24 May 23:27

Choose a tag to compare

This release renames the project to CodeWhale. The legacy
deepseek and deepseek-tui binaries continue to ship as
deprecation shims for one release cycle; they print a one-line
warning and forward to codewhale / codewhale-tui. They will
be removed in v0.9.0. See docs/REBRAND.md for the full
migration story.

Install

Recommended — npm (one command, both binaries)

npm install -g codewhale

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/codewhale/.deepseek \
  ghcr.io/hmbown/codewhale:v0.8.44

The image ships the codewhale dispatcher and codewhale-tui runtime (plus the legacy deepseek / deepseek-tui shims during the transition). The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install codewhale-cli codewhale-tui --locked

Both crates are required — codewhale-cli produces the codewhale dispatcher and codewhale-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/):

Platform Dispatcher TUI runtime
Linux x64 codewhale-linux-x64 codewhale-tui-linux-x64
Linux ARM64 codewhale-linux-arm64 codewhale-tui-linux-arm64
macOS x64 codewhale-macos-x64 codewhale-tui-macos-x64
macOS ARM codewhale-macos-arm64 codewhale-tui-macos-arm64
Windows x64 codewhale-windows-x64.exe codewhale-tui-windows-x64.exe

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

Legacy deepseek-* and deepseek-tui-* assets are also attached for one release cycle so that existing deepseek update invocations on v0.8.40 keep working; they install the deprecation shims, which forward to the canonical binaries.

Verify (recommended)

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

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

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

The legacy deepseek-artifacts-sha256.txt is also attached for backward compatibility and contains the same hashes.

Changelog

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

v0.8.43

24 May 16:09

Choose a tag to compare

This release renames the project to CodeWhale. The legacy
deepseek and deepseek-tui binaries continue to ship as
deprecation shims for one release cycle; they print a one-line
warning and forward to codewhale / codewhale-tui. They will
be removed in v0.9.0. See docs/REBRAND.md for the full
migration story.

Install

Recommended — npm (one command, both binaries)

npm install -g codewhale

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/codewhale/.deepseek \
  ghcr.io/hmbown/codewhale:v0.8.43

The image ships the codewhale dispatcher and codewhale-tui runtime (plus the legacy deepseek / deepseek-tui shims during the transition). The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install codewhale-cli codewhale-tui --locked

Both crates are required — codewhale-cli produces the codewhale dispatcher and codewhale-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/):

Platform Dispatcher TUI runtime
Linux x64 codewhale-linux-x64 codewhale-tui-linux-x64
Linux ARM64 codewhale-linux-arm64 codewhale-tui-linux-arm64
macOS x64 codewhale-macos-x64 codewhale-tui-macos-x64
macOS ARM codewhale-macos-arm64 codewhale-tui-macos-arm64
Windows x64 codewhale-windows-x64.exe codewhale-tui-windows-x64.exe

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

Legacy deepseek-* and deepseek-tui-* assets are also attached for one release cycle so that existing deepseek update invocations on v0.8.40 keep working; they install the deprecation shims, which forward to the canonical binaries.

Verify (recommended)

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

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

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

The legacy deepseek-artifacts-sha256.txt is also attached for backward compatibility and contains the same hashes.

Changelog

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

v0.8.42

24 May 07:19

Choose a tag to compare

This release renames the project to CodeWhale. The legacy
deepseek and deepseek-tui binaries continue to ship as
deprecation shims for one release cycle; they print a one-line
warning and forward to codewhale / codewhale-tui. They will
be removed in v0.9.0. See docs/REBRAND.md for the full
migration story.

Install

Recommended — npm (one command, both binaries)

npm install -g codewhale

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/codewhale/.deepseek \
  ghcr.io/hmbown/codewhale:v0.8.42

The image ships the codewhale dispatcher and codewhale-tui runtime (plus the legacy deepseek / deepseek-tui shims during the transition). The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install codewhale-cli codewhale-tui --locked

Both crates are required — codewhale-cli produces the codewhale dispatcher and codewhale-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/):

Platform Dispatcher TUI runtime
Linux x64 codewhale-linux-x64 codewhale-tui-linux-x64
Linux ARM64 codewhale-linux-arm64 codewhale-tui-linux-arm64
macOS x64 codewhale-macos-x64 codewhale-tui-macos-x64
macOS ARM codewhale-macos-arm64 codewhale-tui-macos-arm64
Windows x64 codewhale-windows-x64.exe codewhale-tui-windows-x64.exe

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

Legacy deepseek-* and deepseek-tui-* assets are also attached for one release cycle so that existing deepseek update invocations on v0.8.40 keep working; they install the deprecation shims, which forward to the canonical binaries.

Verify (recommended)

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

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

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

The legacy deepseek-artifacts-sha256.txt is also attached for backward compatibility and contains the same hashes.

Changelog

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

v0.8.41

23 May 19:53

Choose a tag to compare

This release renames the project to CodeWhale. The legacy
deepseek and deepseek-tui binaries continue to ship as
deprecation shims for one release cycle; they print a one-line
warning and forward to codewhale / codewhale-tui. They will
be removed in v0.9.0. See docs/REBRAND.md for the full
migration story.

Install

Recommended — npm (one command, both binaries)

npm install -g codewhale

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/codewhale/.deepseek \
  ghcr.io/hmbown/codewhale:v0.8.41

The image ships the codewhale dispatcher and codewhale-tui runtime (plus the legacy deepseek / deepseek-tui shims during the transition). The latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install codewhale-cli codewhale-tui --locked

Both crates are required — codewhale-cli produces the codewhale dispatcher and codewhale-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/):

Platform Dispatcher TUI runtime
Linux x64 codewhale-linux-x64 codewhale-tui-linux-x64
Linux ARM64 codewhale-linux-arm64 codewhale-tui-linux-arm64
macOS x64 codewhale-macos-x64 codewhale-tui-macos-x64
macOS ARM codewhale-macos-arm64 codewhale-tui-macos-arm64
Windows x64 codewhale-windows-x64.exe codewhale-tui-windows-x64.exe

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

Legacy deepseek-* and deepseek-tui-* assets are also attached for one release cycle so that existing deepseek update invocations on v0.8.40 keep working; they install the deprecation shims, which forward to the canonical binaries.

Verify (recommended)

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

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

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

The legacy deepseek-artifacts-sha256.txt is also attached for backward compatibility and contains the same hashes.

Changelog

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

v0.8.40

21 May 03:57

Choose a tag to compare

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.40

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/):

Platform Dispatcher TUI runtime
Linux x64 deepseek-linux-x64 deepseek-tui-linux-x64
Linux ARM64 deepseek-linux-arm64 deepseek-tui-linux-arm64
macOS x64 deepseek-macos-x64 deepseek-tui-macos-x64
macOS ARM deepseek-macos-arm64 deepseek-tui-macos-arm64
Windows x64 deepseek-windows-x64.exe deepseek-tui-windows-x64.exe

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.39

17 May 09:17
eeccf7d

Choose a tag to compare

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.39

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/):

Platform Dispatcher TUI runtime
Linux x64 deepseek-linux-x64 deepseek-tui-linux-x64
Linux ARM64 deepseek-linux-arm64 deepseek-tui-linux-arm64
macOS x64 deepseek-macos-x64 deepseek-tui-macos-x64
macOS ARM deepseek-macos-arm64 deepseek-tui-macos-arm64
Windows x64 deepseek-windows-x64.exe deepseek-tui-windows-x64.exe

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.38

15 May 23:39
5401eaa

Choose a tag to compare

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.38

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/):

Platform Dispatcher TUI runtime
Linux x64 deepseek-linux-x64 deepseek-tui-linux-x64
Linux ARM64 deepseek-linux-arm64 deepseek-tui-linux-arm64
macOS x64 deepseek-macos-x64 deepseek-tui-macos-x64
macOS ARM deepseek-macos-arm64 deepseek-tui-macos-arm64
Windows x64 deepseek-windows-x64.exe deepseek-tui-windows-x64.exe

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.