Hmbown/CodeWhale v0.8.46 on GitHub

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).
@ousamabenyounes — thread 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.