GitHub Release: Hmbown/Codewhale v0.9.10 (20.08.2026)

$ git clone https://github.com/Hmbown/Codewhale.git Clone

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.10

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:

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, codew.exe, and codewhale.bat under
  
  %LOCALAPPDATA%\Programs\CodeWhale\bin, adds that directory to the
  
  current-user PATH, and creates a Start Menu shortcut that prefers
  
  Windows Terminal (wt.exe) when it is installed.


• Extract the archive for your machine: codewhale-windows-x64.zip or
  
  codewhale-windows-arm64.zip


• Double-click codewhale.bat (not the raw .exe) to launch


• Run install.bat to copy the binaries and launcher to %USERPROFILE%\bin


• Add %USERPROFILE%\bin to your PATH

The portable Windows archive skips the install script — extract and run codewhale.bat 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.10

• Show the full slash-command or /model completion row in a bounded, wrapping hover popover whenever narrow terminals truncate it, closing the remaining scoped gap from and ), and three $HOME disk leaks are
  
  reclaimed. Extension surfaces now name their real state and act only
  
  through the reviewed install and trust flows, and sub-agent, shell, task,
  
  and workflow state is owned by the session that created it ( failure class reported by
  
  , ).


• Pre-header HTTP/2/SSE transport failures get one bounded HTTP/1.1 retry;
  
  authentication, provider-semantic, response-body, and already-pinned HTTP/1
  
  failures remain fail-closed (demian-welt, by
  
  ).


• Windows default launch prefers Windows Terminal: zip archives ship
  
  codewhale.bat (CRLF, wt.exe then the exe), install.bat copies that
  
  launcher, and the NSIS Start Menu shortcut opens it instead of the raw
  
  binary ().


• fix(tui): rebase active-cell tool bindings on every mid-turn history insert — /rename mid-turn left the running tool row spinning forever
  
  ().


• fix(tui): reclaim the three $HOME disk leaks — orphaned session dirs,
  
  the unbounded audit.log, and stranded writer temp files.


• fix(tui): persist approval outcomes before execution (cyq1017) —
  
  approval receipts are committed to a session-owned log before execution
  
  proceeds; unpersistable evidence blocks the tool; resume reconstructs
  
  closed and interrupted approvals ().


• Short CLI no longer waits up to three seconds for a telemetry POST on
  
  exit; session_end is recorded and the buffer ships on the next
  
  interactive session.


• Bare / now opens a deliberately small starter set: /help, /setup,
  
  /model, /settings, /resume, and /rc. The full command inventory
  
  remains searchable through /help, the command palette, and direct prefix
  
  typing, without front-loading the entire control surface ().


• First run now asks only for decisions needed to become usable, keeps the
  
  offline route explicit, and leaves optional provider, tools, policy, and
  
  appearance work in the progressive /setup repair guide. The idle aquarium
  
  asks one task-oriented question instead of advertising a tutorial or command
  
  billboard, and the localized telemetry choice appears after the workspace is
  
  ready without blocking the composer.


• Provider, active model, and reasoning effort moved out of the crowded header
  
  into a quiet, width-aware footer identity. Compact layouts keep model and
  
  effort before provider detail and shed whole low-priority groups instead of
  
  clipping the composer or control hints.


• The model picker no longer re-parses ~/.codewhale/config.toml once per
  
  provider when deciding who has a saved key.

Added

• /workflows opens a live run dashboard over this workspace's durable
  
  workflow journal: every retained run with status, phases, child roster,
  
  progress, and host-side cancel — observation only, it never launches a run.


• Repository instructions now assemble from the actual containing checkout:
  
  applicable AGENTS.md files resolve repository-root to current-directory in
  
  order under one aggregate budget, a linked worktree is its own root, and
  
  scope is never inferred from path mentions or whichever branch is named
  
  main.


• /goal is a codex-style control plane: setting an objective dispatches it
  
  to the engine, which owns the goal and starts the first goal turn itself —
  
  the objective is never echoed back as the user's own message, pause/resume
  
  are real control ops, and the hunt-era vocabulary and trophy cards are
  
  gone.


• /extensions and /plugins open one localized inventory for Hooks,
  
  Plugins, local Marketplace catalogs, Skills, and MCP. Reviewed suggestions
  
  include Playwright, Chrome DevTools, Cua Computer Use, Browser Use, and the
  
  sandbox runtime without granting trust or installing anything on open.


• Turn Inspector now opens the newest turn and pages across complete recorded
  
  user, reasoning, tool/subagent, and assistant output with page-scoped search,
  
  copy, and export (sky-sun-moon, , by ).


• codewhale auth status --diagnostic reports canonical paths, isolation
  
  source, backend class, and value-free provider-source presence without
  
  opening credential stores or creating/migrating state ().


• The safe deferred read_media tool is available to supported read-only
  
  roles, and history receipts distinguish localized tool execution outcomes
  
  without exposing raw payloads ().


• feat(tui): add cancellable cadence to continuous goals (M-Maciej) —
  
  [goal] continuation_delay_seconds gives coordinator goals a visible quiet
  
  period between successful turns while reusing the existing coalesced goal
  
  continuation token; Esc, Ctrl+C, pause/done/blocked/clear cancel before the
  
  next provider request, and failures never continue ().


• feat(web): move docs/hooks and docs/troubleshooting onto the dictionary spine (Lstarsky0) — both pages now read copy from the locale dictionaries
  
  instead of inline bilingual literals (,
  
  not completion of the full epic ().


• feat(tui): show repository context in git chrome (wuisabel-gif) — the TUI
  
  header now identifies the active repository or linked worktree before the
  
  branch and dirty marker, so operators can see where the agent is working
  
  without opening the worktree manager ().


• feat(tui): first slice of the agents roster — every agent that ran this
  
  session, receipts-only, via /agents list and the sidebar fan-out rows
  
  ().


• chore(scripts): dev-cache warns before it fills a disk ( (@SparkofSpike) — restored
  
  /title as an independent, persistent terminal-window title in PR (@bistack) — extracted the
  
  turn-loop stream processor in PR (@OctoBored) — supplied the
  
  working no-token Star History mirror used across the localized README set
  
  after the canonical chart endpoint began returning a restricted placeholder
  
  ( (@cacdcaecawae) — added
  
  provider-neutral typed MCP image forwarding in PR (@DingYong4223) — reported
  
  the narrow-terminal completion truncation closed by the bounded hover reveal
  
  ( and (@sky-sun-moon) — reported
  
  the missing full per-turn input, reasoning, tool, and assistant pages that
  
  shaped Turn Inspector navigation ( (@cy2311) — reported the Windows launch
  
  path that now ships and installs a Windows Terminal-aware batch launcher
  
  ( (@demian-welt) — provided the
  
  reproducible pre-header SSE transport failure behind the bounded HTTP/1.1
  
  retry ( (@BrathonBai) — reported the
  
  Tabby/CJK IME candidate-window jump that led to the hide-diff-position-show
  
  cursor transaction () — the real-world organization-coordinator use case and
  
  5–30 minute cadence requirement behind cancellable cross-turn goal delays
  
  () — approval outcomes are persisted before execution can
  
  proceed: receipts commit to a session-owned log first, unpersistable
  
  evidence blocks the tool, stale decisions are rejected, and resume
  
  reconstructs closed and interrupted approvals ().


• aboimpinto (, EPIC-005/FEAT-015 under ) — the TUI header now names the active
  
  repository or linked worktree before the branch and dirty marker, derived
  
  from Git's common directory and capped by shell density tier ().


• SparkofSpike (, epic ) — docs/hooks and docs/troubleshooting move onto
  
  the dictionary spine, retiring their inline bilingual literals in favor of
  
  locale dictionaries with token-aware code spans (, which
  
  they also filed).


• Lstarsky0 (, a further phase of — the header status-indicator report that pinned the
  
  regression to a specific setting, with every value, theme, and
  
  fancy_animations combination already ruled out () — reported the deterministic cross-session contamination
  
  class behind this release's session-ownership boundary, plus route
  
  budgeting evidence () — reported the route budgeting root causes that exact
  
  route-limit propagation now closes ( for full notes and docs/CHANGELOG_ARCHIVE.md for older releases.
  Vollständiger Original-Bericht

  Ausführliche Details, Code-Beispiele & Hersteller-Stellungnahme auf github.com.

  ↗ Original-Artikel auf github.com lesen