Rename Transition

DeepSeek TUI has been renamed to CodeWhale, and this guide now treats the old name as the migration entry point

Use the top navigation to choose the topic family first. If you searched for DeepSeek TUI, the most important update is that new installs should use the CodeWhale command names while this site keeps the old keyword as a discoverability bridge.

Quickstart Full install docs
npm install -g codewhale
codewhale --version
codewhale --model auto
CodeWhale rename tracked Main menu first List page before detailDocs and guides together
$ Quickstart
$ npm install -g codewhale
$ codewhale --version
$ codewhale --model auto
Install with the new package name, verify the current binary, then launch with automatic model selection.

Rename note: DeepSeek TUI is now CodeWhale

The upstream project has been renamed. For fresh installs, use npm install -g codewhale and launch with codewhale.

Older deepseek and deepseek-tui commands still exist as compatibility shims for now, but upstream documents them as temporary and scheduled for removal in v0.9.0.

Choose a main section

These are the main branches in the top menu. Open one branch first, then use the left section menu to move into the exact list page or article.

Install

Install

Use this branch for npm, cargo, Homebrew, Windows, and update routes.

Open install section
Docs

Docs

Use this branch for architecture, runtime API, keybindings, runbooks, and mirrored repo topics.

Open docs section
Config

Config

Use this branch for API keys, providers, file location, environment variables, and reset workflows.

Open config section
MCP

MCP

Use this branch for MCP setup, server lists, and example flows after base config already works.

Open MCP section
Modes

Modes

Use this branch for plan mode, yolo mode, and the differences between them.

Open modes section
Skills

Skills

Use this branch for reusable workflows, examples, and skills vs prompts explanations.

Open skills section
Compare

Comparisons

Use this branch for CodeWhale vs Claude Code and other terminal-agent comparisons.

Open comparisons section
News

News

Use this branch for rename explainers, overview pages, and ecosystem context that explain why the tool is still being searched under the old name.

Open news section

How to use the structure

The site should now behave like a documentation product, not a pile of unrelated landing pages.

Step 1

Choose one branch from the top menu

Pick Install, Docs, Config, MCP, Modes, Skills, Comparisons, Troubleshooting, or News first.

See a section hub
Step 2

Use the left menu as the section list

Every section page and article page now gets a left-side submenu so users can move inside that branch without going back home.

See install list
Step 3

Open the article detail only when needed

Once the branch and list are clear, the final click should be a focused detail page like npm install, architecture docs, or API key setup.

See a detail page

Most useful articles

These are the detail pages people most often need after choosing a section.

Install

Install CodeWhale with npm

Best first detail page if you already use Node-based CLI tools.

Open npm article
Config

CodeWhale API key setup

Best first detail page if the install worked but auth is still unclear.

Open API key article
Docs

CodeWhale Architecture Docs

Best docs detail page if you care about structure rather than just setup.

Open architecture article
Modes

Plan mode vs yolo mode

Best detail page if you need to choose how cautious or direct the agent should be.

Open modes article
Rename

DeepSeek TUI renamed to CodeWhale

Best first article if your real question is what changed in install commands, package names, and migration guidance.

Open rename article
Compare

CodeWhale vs Claude Code

Best comparison page if you are choosing between terminal-agent workflows.

Open comparison article