v0.8.46

> 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)

```bash
npm install -g codewhale
```

The wrapper downloads both binaries from this Release and places them in the same directory.

### Docker / GHCR

```bash
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)

```bash
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):**
```bash
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:

```bash
# 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](https://github.com/Hmbown/CodeWhale/blob/main/CHANGELOG.md) for the full notes for this release.