Repository navigation
What's in v0.10.3
Codewhale v0.10.3 brings a unified Plugins surface with Creator mode ([features] plugin_creator) and unmodified DeepSeek Harness (@deepseek-ai/dsh-*) plugin compatibility, an upgraded Auto-Review guardian with workspace boundaries, soft rules, sub-agent return review, and one-use retry approvals, and a single Shift+Tab permission dial defaulting to Accept Edits (Ask → Accept Edits → Plan → Auto-Review → Full Access). It moves the ACP server and external-agent sessions (including Qwen Code and GitHub Copilot CLI) onto the official Agent Client Protocol SDK, publishes native signed HarmonyOS ARM64 release assets, adds a verified signed model-and-provider registry channel alongside unified model-ID resolution and managed /v1/models pricing, updates design tokens to 5.4.0 with a docked single-line approval strip, folded turn activity, live working-row light sweeps and 13 hex-lattice dot-whale forms, adds claude-org billing auth, show_data transcript charts, codewhale sessions migrate, DeepSeek Chatbot web search and speech tools, receipted self-updates and codewhale uninstall, and lands reliability, CJK/Unicode, Windows, and sandbox security fixes.
Install
Recommended — official GitHub release
New macOS/Linux install (checksummed binaries from this release):
curl -fsSL https://codewhale.net/install.sh | CODEWHALE_VERSION="v0.10.3" sh
"$HOME/.local/bin/codewhale" --versionFor Windows, use the matching installer or archive below. For an existing
direct install, run codewhale update; it prints the executable path and
keeps newer builds. If the install directory is occupied by a different build,
use the fresh-directory migration in the installation guide.
Secondary packaging — npm and Cargo
npm install -g codewhale
# or build from source
cargo install codewhale-cli --lockedThe 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/codewhale-hq/codewhale:v0.10.3The 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 --lockedThe 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 |
| HarmonyOS ARM64 (native) | codewhale-ohos-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.shWindows:
- For the installer path, run
CodeWhaleSetup.exe; it installs
codewhale.exe,codew.exe, andcodewhale.batunder
%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.zipor
codewhale-windows-arm64.zip - Double-click
codewhale.bat(not the raw.exe) to launch - Run
install.batto copy the binaries and launcher to%USERPROFILE%\bin - Add
%USERPROFILE%\binto 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-missingFull release notes
The full notes exceed GitHub's release-description limit. Read the complete changelog for v0.10.3.
Contributors
-
@knowhycodata — added the LLMTR gateway descriptor and provider documentation (#7450).
-
@swf1996120 — reported that the PR review prompt discouraged checking callers with the available source tools (issue 7435).
-
@NieZhuZhu — hardened shell-command policy expansion: classified local read-only deferred tools as safe for Auto-Review (#7431), scanned bounded AWK and sed programs for embedded shell commands (#7430), kept each command's stdin source under group redirection and
numactl --strict(#7429), failed closed on dynamically resolved flag and verb names (#7427), modeled additional tmux execution verbs within a shared work budget (#7428), modeled theoc,vagrant,op,opamandhelmlaunchers (#7425), and propagated the dynamic flag-word bit throughnixand launcher flags (#7424). -
@BX166 — clarified the AICraft provider setup for mainland China and international users (#7421).
-
@donglovejava — covered large raw and bracketed terminal paste, individual chunk flushes, and the Enter-key append path, fixed fallback tool-call IDs in streaming chat completions, and preserved usage records when compacting diagnostic receipts (#7422, #7423, #7444, #7449).
-
@gabsferreira added the SearchApi web search provider (#7410).
-
@cmdcorp6534 — reported the Chinese input-method candidate window appearing away from the field being typed into (#2323).
-
@Asteria1028 — reported pasted clipboard images piling up with no way to remove them (#7221).
-
@zhuowp (git author
z27014) — added bounded HTTP rate-limit recovery and corrected retry deadlines, quota guidance and recovery receipts (#7220). Allowed an optional host policy on model HTTP clients (#7251). -
@printf033 — enabled exclusive rename on Android so Fleet publication does not fall back to SELinux-denied hard links (
fbe9f24ee). -
@liuyy2 — diagnosed case-sensitive model selection collisions in the provider picker (#7214).
-
@isaacs — upstream minimatch preprocessing and glob cancellation fixes reused in compatible web build dependency backports.
-
@Gabriel-Degret — reported that a hosted output limit truncated reasoning on a custom endpoint (#7179), and measured background shell idle wakeups (#6728).
-
@soarkit — reported that
/patch-undoignoredturn_idand undid the latest turn (#7216), and traced named-turn undo reading the history twice (#7355). -
@mickey1204 — reported ChatGPT sign-in failing token verification on Windows after a successful browser sign-in, with clock and endpoint checks that narrowed it to local verification (#7203).
-
@Felixkw12 — added Opper as a bundled provider (#7131).
-
@7jrxt42BxFZo4iAnN4CX — per-scope instruction budgets with visible truncation (#7086, #6526), durability and repeated-goal measurements (#6555, #7172), and provider-failure log analysis (#7328).
-
@Lstarsky0 — kept the
/diffpager's place across a resize (#7087), said "Goal cleared." only when there was a goal (#7089), and stopped printing an unpriced session cost as$0.0000in/status(#7090), kept Normal-mode keys out of the draft on terminals without bracketed paste (#7126) and let shifted keys such asGreach Normal mode (#7130), kept the quote rail on every wrapped row of a blockquote (#7144), kept a nested list paragraph's indent (#7146), rendered~~~fences as code (#7156), left asterisks that do not open emphasis literal (#7157), ended bare URLs at full-width punctuation (#7158), kept a link target's own parentheses (#7170), rendered code and links inside emphasis (#7171) and stopped the engine's fleet-roster and stream-timeout statuses from taking over the footer (#7152, #7169). Preserved indentation and space-only inline code in table cells (#7184). Reportedfile_searchmatches relative to the workspace (#7213). Matched brace and nested-directory globs ingrep_files(#7215). Kept the draft when the command palette inserts a command (#7205). Bounded nested brace expansion and repeated globstars ingrep_files(#7254) and kept a typed draft when a failed send comes back (#7255), restored context percentages after session loads (#7256), preserved untouched characters on fuzzy edits (#7257), recognized@mentions after CJK text and repeated file ranges (#7258, #7259), accepted full-width spaces and newlines after custom commands (#7260), aligned/configdetail values across locales (#7267), and kept Markdown character references literal in code and argv (#7192). -
@gaord — a running turn's cost and context in the Runtime (#7074) forks that measure the history they carry (#7147), and private state on a HarmonyOS mount that cannot express ownership (#7168). Capped WeCom reply chunks by UTF-8 bytes (#7209). Accepted media and voice messages on the WeCom bridge (#7212). Steered a running turn from the WeCom bridge (#7211). Surfaced WeCom API error details in bridge replies (#7208) and rotated WeCom stream replies before the ten-minute expiry (#7210); both were harvested with the original commits kept. Stopped provider timeouts reporting "after 0ns" (#7253), exposed read-only
/system,/tokensand/costbuiltins over the Runtime API (#7277), and carried reviewed session memory and hygiene guidance into sub-agents (#7359). -
@luochen211 — one form per term in the Simplified Chinese pack (#7150) and dropped blanket dead-code allows in fleet alerts and the pet worker (#7149). Added a Chinese provider setup page (#7266) and translated the Receipts (#7264), Claude plugin compatibility (#7263) and GitHub review bot (#7265) pages; fixed CJK column widths, slash-command whitespace, negative retry delays, linear-time search globs, short patch hunk headers,
env -Sscript shebangs, timeline summaries, non-ASCII RLM context names, single-pass HTML entity decoding, worktree rename status, skill archive wrapper detection, declarative workflow keyword checks, escape stripping, zh-Hans/routerand/statusalignment, blank env-var alias fallback, crash-safe session index newlines, non-ASCII diff paths, CJK secret redaction, mid-call MCP/LSP server requests, IDN network rules, rebound command deny rules, and CJK session-title character counts (#7269, #7273, #7275, #7276, #7287–#7291, #7310–#7322), and translated the last English tool labels,/help,/diff, composer and/statuscatalog text in every locale pack (#7367). -
@gannp — reported vLLM effort values that ignored the local model template and fixed it with a reviewed template registry (#7124, #7125).
-
Sh1Zuku / @SparkofSpike — resolved a relocated state root before session-side state opens (#7097) and made a goal pause to ask instead of inventing the answer (#7175), and gave the model a way back into the transcript compaction replaced (#7173). Also preserved journal history when a provisional input receives its Engine metadata (#7180). Added the bare DeepSeek V4.1 Flash catalog entry (#7183). Stopped a home-directory workspace from refusing its own state (#7207), preserved exact-first model selection (#7214), reported proxy diagnostic privacy (#7233), surfaced worktree-side rename sources in Runtime git routes (#7325), and selected
reasoning_effortfor DeepSeek models behind OpenAI-compatible gateways (#7349). -
@ddlw — repaired main for the 0.10.3 batch: clippy
-D warningsacross protocol, runtime, util and tui (boxed review and MCP-add payloads, scoped dead-code expectations, cfg-gated platform test helpers), rustfmt, split extension-host imports, the provider-registry identity check, Windows-stable DSH receipt bytes, and the first-party marketplace receipt (#7108, #7109). -
@laozidabo — localized
/difffeedback (#7101), flushed queued saves before signal exit (#7122) and kept/rcstart failures visible (#7127), logged redacted provider failure causes (#7353), stopped named-turn undo from rereading the session history (#7362), and rolled back partial file-scoped undo restores from the safety snapshot (#7366). -
Boyce / @Aboysky — refreshed the README translation source stamps (#7104) and localized
/undofeedback (#7121), formatted context-window labels and UTF-8 REPL output limits (#7295, #7296), and added GitHub Copilot CLI to the external ACP agent registry (#7326, #7279). -
@Ricardo-M-L — opened
.tsxdocuments with thetypescriptreactlanguage ID (#7140), preserved multiline XML tool arguments (#7341), and kept CLI argument assignments literal in the fallback tool-call parser (#7342). -
@M-Maciej — reported answerless output-limit stops in long Fleet proofs (#6990).
-
@asto18089 — diagnosed the NoNewPrivs child-matrix failure on hardened containers (#7021). Dropped the false sandbox claim from the
fetch_urldescription (#7222) and limited nested-repository discovery to the sub-agent worktree anchor (#7224). Accepted absolute in-workspace paths in sub-agent write claims (#7227). Repaired pre-0.10.0 topology checkpoint placement on session restore (#7229). Pointed theverifydescription at the Run tool instead of a retired name (#7223). Swept stale mode-jump and rail copy from the non-English packs (#7225), accepted absolute image paths that resolve inside the workspace (#7226) and reported follow-up delivery truthfully (#7228); all three were harvested with the original commits kept. Paused the durable task wall clock while an answerable prompt waits (#7230). -
@Statter — reported black-on-black text on terminals that do not report their background (#7043).
-
@eugenicum — asked for a visible Full Access flag for
serve --acp(#6992). -
@luestr — reported file and conversation rollback diverging (#6970), the Linux multiline send key (#7093) and session export guidance (#6996).
-
@ychu824 — reported every Anthropic request failing with a 400 once
tool_searchadded a tool whose name contains a dot, such asweb.run(#7252). -
@MannXo — added Qwen Code to the external agent registry so an installed Qwen Code CLI runs as a session over ACP (#7293).
-
@SamhandsomeLee — drove Responses request, URL and stream behavior from one checked dialect profile table (#7261).
-
@Gyuke — kept the exact named custom route in the web client's new-thread provider picker so models load and threads start on the route chosen (#7352).
-
@vshulcz — documented a hybrid Claude bundle that installs declaratively with
/plugin installand keeps its lifecycle hooks inconfig.toml(#7346). -
@deosiree — bounded the terminal's wait for the session snapshot at turn end so a newly started turn no longer freezes the UI, and exposed request transmission in terminal provider errors (#7360, #7448).
-
@ruanchaves — kept MCP tools whose optional parameters carry a Pydantic
default: nullin Moonshot (Kimi) requests instead of dropping them (#7364).
See CHANGELOG.md for full notes and docs/CHANGELOG_ARCHIVE.md for older releases.