v0.8.48

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 volume create codewhale-home
docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v codewhale-home:/home/codewhale/.codewhale \
  ghcr.io/hmbown/codewhale:v0.8.48

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
Linux RISC-V	codewhale-linux-riscv64.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.

Community

Thanks to contributors whose PRs landed or were harvested in this release:
@cy2311 (#1861),
@LING71671 (#1902, #2287, #2292),
@axobase001 (#1968, #2296, #2297, #2298),
@dzyuan (#1993),
@mvanhorn (#2107, #2236),
@malsony (#2129),
@gaord (#2133, #2265, #2285),
@yuanchenglu (#2149),
@idling11 (#2161, #2266, #2306),
@h3c-hexin (#2245, #2311, #2313, #2314, #2354, #2355, #2356),
@AdityaVG13 (#2246),
@Sskift (#2248),
@cyq1017 (#2252, #2332, #2375),
@HUQIANTAO (#2257, #2267, #2283, #2384, #2385, #2389, #2403, #2440-#2458, #2460),
@New2Niu (#2260),
@AiurArtanis (#2270),
@Lee-take (#2272),
@nightt5879 (#2274, #2344, #2347, #2373),
@AresNing (#2278, #2318/#2434),
@AccMoment (#2281),
@reidliu41 (#2291, #2316, #2324, #2357, #2366, #2386, #2431),
@aboimpinto (#2290, #2294, #2295, #2326, #2433),
@zhuangbiaowei (#2301),
@donglovejava (#2302, #2329, #2330, #2331),
@hongqitai (#2308, #2432),
@zlh124 (#2319, #2320, #2325),
@encyc (#2336, #2338),
@Implementist (#2426/#2429, #2439),
@lihuan215 (#2333/#2430),
@LeoAlex0 (#2388, #2395),
@jimmyzhuu (#2371),
@rockyzhang (#2383),
@mo-vic (#2387),
@hufanexplore (#2367),
@hoclaptrinh33 (#2358),
and @BryonGo (#2437).

Thanks also to reporters and verification helpers whose issues, patches,
screenshots, logs, or retest requests shaped this release: @buko (#2359,
#2360, #2369, #2469), @yyyCode, @gaslebinh-glitch, @Dr3259,
@lpeng1711694086-lang, @VerrPower, @yan-zay, @jretz,
@Neo-millunnium, @caeserchen, @T-Phuong-Nguyen, @zhyuzhyu,
@0gl20shk0sbt36, @hatakes, @goodvecn-dev, @bevis-wong,
@PurplePulse, and @nbiish.