CodeWhale is the canonical project, command, npm package, and
release-asset name. The legacy npm packagedeepseek-tuiis
deprecated and receives no further releases. Users coming from
v0.8.x legacydeepseek/deepseek-tuinames should migrate
withdocs/REBRAND.md.
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.60The image ships the codewhale dispatcher and codewhale-tui runtime. 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
|
| 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 (installer) | CodeWhaleSetup.exe
| NSIS setup |
| 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:
- For the installer path, run
CodeWhaleSetup.exe; it installs both binaries under%LOCALAPPDATA%\Programs\CodeWhale\binand adds that directory to the current-user PATH. - 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. The NSIS installer is currently unsigned and may trigger Windows SmartScreen until a signing certificate is wired into the release pipeline.
Individual binaries are also attached below for scripting and the npm wrapper. The legacy npm package deepseek-tui is deprecated and is not republished. For migration from v0.8.x legacy binary names, see docs/REBRAND.md.
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.txtWhat's in v0.8.60
Added
- Agent Fleet real-run cutover (#3154/#3096).
codewhale fleet runnow
launches durable workers through the headlesscodewhale exec --output-format stream-jsonpath instead of the local simulation interpreter, with terminal
worker events freeing leases so queued fleet tasks continue running. - Read-only shell parallelism (#2983). The engine can now run conservative
read-only shell calls in parallel, including strictbash/sh/zsh -c
wrappers for whitelisted commands, while writes, stdin, background TTY work,
redirects, pipes, command substitution, and follow-mode tails stay serial. - Declarative JS/TS WhaleFlow authoring (#3097). WhaleFlow now accepts a
compile-onlyworkflow({...})JavaScript/TypeScript authoring form that
lowers into the existingWorkflowSpecvalidator without executing user
JavaScript. - Slash-menu Ctrl+P/Ctrl+N navigation (#3196). The slash command menu now
supports Ctrl+P/Ctrl+N movement without letting the global file picker steal
focus while the menu is open. Thanks @1Git2Clone for the PR. - New models and first-party provider routes. This release adds
GLM-5.2 (selectable on the Z.ai Coding Plan and over OpenRouter as
z-ai/glm-5.2, alongside the existing GLM-5.1 default), a first-party
Z.ai provider route, a first-party StepFun / StepFlash route
(step-3.7-flash), and a first-party MiniMax route defaulting to
MiniMax-M3with the M2.7/M2.5/M2.1 family selectable (#3187/#3191).
Changed
- README and contributor credits. The README now has a shorter public
overview and moves the full contributor ledger todocs/CONTRIBUTORS.md,
preserving public thanks for DeepSeek,
DataWhale,
OpenWarp, and
Open Design. - Fleet-backed sub-agent direction. Runtime docs now state the intended
cutover clearly: "sub-agent" is role/UX vocabulary, while durable detached
work should converge on the fleet-backed worker lifecycle with retries,
receipts, and ledgered inspection.
Fixed
- Sub-agent eval no longer blocks by default.
agent_evalnow returns the
current projection immediately and delivers follow-up input without waiting
for a running child to finish its provider call. Passblock:truefor an
intentional terminal wait. - Z.ai GLM thinking traces. Direct Z.ai requests now use the documented
thinkingshape, preserve and replayreasoning_content, classify GLM
reasoning streams as thinking output, and acceptultracodeas a max-effort
alias. - Claude skill archive compatibility (#2743).
/skill installkeeps
portable Claude-style skill folders supported while rejecting multi-skill
Claude plugin archives clearly instead of silently installing only one skill
and dropping plugin semantics. Thanks @AiurArtanis for the ecosystem request.
Contributor credits for this release live in the changelog entry above —
thank you to everyone whose reports, PRs, reviews, and reproductions shaped it.
See CHANGELOG.md for full notes and docs/CHANGELOG_ARCHIVE.md for older releases.
Contributors
Thanks to the community members whose PRs and ecosystem reports shaped v0.8.60:
- @1Git2Clone — slash-menu Ctrl+P/Ctrl+N navigation (#3196)
- @AiurArtanis — Claude skill archive compatibility (#2743)
And thank you to everyone who filed issues, tested builds, reviewed PRs, and shared reproductions across the v0.8.58–v0.8.60 release train.