v0.8.45 available now

The most agentic harness
for DeepSeek V4

Rules, tools, evidence, and feedback loops that help the model keep working until the task is done. 1M-token context, thinking-mode streaming, OS-level sandboxing — single binary, zero dependencies.

bash — zsh

$ npm i -g codewhale

View on GitHub Sponsor

▸How the harness works

Constitutional hierarchy

User intent outranks stale memory. Live evidence outranks assumptions. A clear chain of authority every turn.

Structured trust

Plan (read-only), Agent (approval-gated), YOLO (auto-approved). OS-level sandboxing backs every boundary.

Feedback beats

Failed commands and failing tests are not dead ends — they're signals the model can tune against, turn after turn.

Continuity

Memory persists across sessions. Handoffs survive compaction. Save, resume, and fork conversations.

Distributed work

Sub-agents run concurrently, up to 20 at a time. Results arrive as structured completion events.

Right-size intelligence

Fin handles routing and summaries. Pro engages for architecture and debugging. The right amount of intelligence for each problem.

◎China / mirror-friendly install

If downloads from GitHub or npm are slow from mainland China, use one of these paths:

npm via 淘宝镜像 (fastest)

npm config set registry https://registry.npmmirror.com
npm install -g deepseek-tui

The npm wrapper itself will still download the binary from GitHub Releases during postinstall. If that step is slow, set a mirror for the binary download:

DEEPSEEK_TUI_RELEASE_BASE_URL=https://your-mirror.example.com \
  npm install -g deepseek-tui

Cargo via 清华 TUNA mirror

Add to ~/.cargo/config.toml:

[source.crates-io]
replace-with = "tuna"

[source.tuna]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

Then install both binaries:

cargo install deepseek-tui-cli --locked   # provides `deepseek`
cargo install deepseek-tui     --locked   # provides `deepseek-tui`
deepseek --version

Rustup mirror (for building from source)

export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Full platform guide: docs/INSTALL.md · 简体中文 README

The most agentic harnessfor DeepSeek V4