Home/Install
Install Hub

How to install CodeWhale now that DeepSeek TUI is the old project name

This install hub keeps the old search term, but new installs should use the CodeWhale command names. The practical question is not just which command exists, but which package path best matches your current terminal workflow and update habits.

Rename note: the product name is now CodeWhale

Upstream has renamed DeepSeek TUI to CodeWhale. For fresh installs, prefer codewhale as the command name and codewhale as the npm package.

The older deepseek and deepseek-tui names still work as compatibility shims for now, but upstream says they are temporary and planned for removal in v0.9.0.

Choose the install path by question type

Use this page as the install list first. Pick the package route that matches your machine and workflow, then open the detail guide.

Fastest

I need the most common install route

Choose npm first if you already use Node-based CLI tools and want the shortest route to a working command.

Go to npm install
System

I want a cleaner machine-level install

Choose Homebrew or release binaries if you care more about system package habits than the quickest first run.

Go to Homebrew install
Rust

I want the Rust-native package route

Choose cargo if you already live in the Rust toolchain and want CodeWhale to fit that environment.

Go to cargo install

Install article list

Open the exact install detail page you need instead of hopping between unrelated package manager examples.

npm

Install CodeWhale with npm

The npm route is the most approachable for many CLI users who already manage agent tools globally through Node.

Open npm guide
Cargo

Install CodeWhale with cargo

The cargo route matters if you want the Rust ecosystem path and need the current codewhale-cli --locked install command explained clearly.

Open cargo guide
Homebrew

Install CodeWhale with Homebrew

Homebrew is useful if you want a cleaner system-level install path and already manage CLI tools through brew.

Open Homebrew guide
Windows

Install CodeWhale on Windows

Use this page when shell defaults, PowerShell, Git Bash, or WSL make the install route feel less obvious than macOS examples suggest.

Open Windows install guide
Update

Update or upgrade CodeWhale

Use this page when the real issue is not first install, but how to keep the active command current without mixing package paths.

Open update guide