This release renames the project to CodeWhale. The legacy
deepseekanddeepseek-tuibinaries continue to ship as
deprecation shims for one release cycle; they print a one-line
warning and forward tocodewhale/codewhale-tui. They will
be removed in v0.9.0. Seedocs/REBRAND.mdfor the full
migration story.
Install
Recommended — npm (one command, both binaries)
npm install -g codewhaleThe 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.47The 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 --lockedBoth 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.shWindows:
- Extract
codewhale-windows-x64.zip - Run
install.bat(copies to%USERPROFILE%\bin) - Add
%USERPROFILE%\binto 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.txtThe 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)