GitHub: v0.9.5

Codewhale is the public product from Shannon Labs. The codewhale

command, npm package, and release-asset names remain lowercase technical

identifiers. The legacy npm package deepseek-tui is deprecated and

receives no further releases. Users coming from v0.8.x legacy deepseek /

deepseek-tui names should migrate with docs/REBRAND.md.

Install

Recommended — npm (one command, both entrypoints)

npm install -g codewhale

The wrapper downloads the matched codewhale and codew command assets

from this Release. Both contain the same compiled runtime.

Docker / GHCR

docker run --rm -it \

  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \

  -v codewhale-home:/home/codewhale/.codewhale \

  ghcr.io/hmbown/codewhale:v0.9.5

The image exposes the same runtime as both codewhale and codew. The

latest tag is also updated on release.

Cargo (Linux / macOS)

cargo install codewhale-cli --locked

The Cargo package installs codewhale. Cargo cannot create a second command

alias from one binary target; users who want the shorter spelling can add a

codew symlink to that installed executable. The npm, Homebrew, archive,

shell-installer, and container channels install both command names directly.

Manual download — platform archives (recommended)

Each archive below contains the same runtime under the codewhale and

codew command names, 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


Android ARM64 (Termux)
codewhale-android-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 (installer)
CodeWhaleSetup.exe
NSIS setup


Windows x64
codewhale-windows-x64.zip
install.bat


Windows x64 (portable)
codewhale-windows-x64-portable.zip
—


Windows ARM64
codewhale-windows-arm64.zip
install.bat


Windows ARM64 (portable)
codewhale-windows-arm64-portable.zip
—

Unix (Linux / macOS):

tar xzf codewhale-<platform>.tar.gz

cd codewhale-<platform>

./install.sh

Windows:

• For the installer path, run CodeWhaleSetup.exe; it installs
  
  codewhale.exe and codew.exe under
  
  %LOCALAPPDATA%\Programs\CodeWhale\bin and adds that directory to the
  
  current-user PATH.


• Extract the archive for your machine: codewhale-windows-x64.zip or
  
  codewhale-windows-arm64.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. The NSIS installer is currently unsigned and may trigger Windows SmartScreen until a signing certificate is wired into the release pipeline.

Each platform also has bare, unarchived codewhale-<platform> and

codew-<platform> assets. The seven codewhale-tui-<platform> filenames

attached to v0.9.5 are byte-identical compatibility copies used only to let

already-installed v0.9.4 clients discover and cross this single-binary

transition; current installers do not expose a third runtime. 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 --ignore-missing



# Linux — individual binaries

sha256sum -c codewhale-artifacts-sha256.txt --ignore-missing



# macOS

shasum -a 256 -c codewhale-bundles-sha256.txt --ignore-missing

shasum -a 256 -c codewhale-artifacts-sha256.txt --ignore-missing

What's in v0.9.5

Codewhale v0.9.5 consolidates the terminal application into one compiled

runtime while preserving the familiar codewhale and codew commands. It

also expands the managed Runtime API, makes session and Fleet work easier to

inspect and resume, and removes the hidden local continuation backstop that

could end productive work without a final assistant response.

Added

• model = "auto" for prompt-based tier selection: When set, the
  
  dispatcher analyses the user's prompt before delegating to the TUI and
  
  selects deepseek-v4-pro for complex tasks or deepseek-v4-flash for simple
  
  tasks (PR (@SparkofSpike) fixed stale
  
  cached session titles that could pin the New Session placeholder.


• (@bistack) contributed the
  
  background incremental MCP Registry refresh.


• .

See for older releases.