First run, defaults, visual hierarchy, task finales, website / community front door, contributor guidance, and release smoke feel composed, legible, and exact. The project's visual identity locks in: an orange / blue / white work-state palette against a dark navy / near-black background, used to encode state rather than decorate. Drop the legacy deepseek and deepseek-tui binary shims now that the rename has baked through the v0.8.x line.
In scope
-
First-run wizard. A short structured wizard for new users: provider setup (DeepSeek, Hugging Face Inference Providers, OpenRouter, or a local runtime via the Serving Workset path), model choice, execution-mode default (Plan / Agent / YOLO),
--model autoopt-in, theme, optional memory-store opt-in, optional verifier opt-in. Replaces an unguided "just start typing" first turn. -
Control panel polish.
/configbecomes a control panel: modes, permissions, provider, model, thinking, memory, MCP, theme — every setting inspectable, adjustable, and accompanied by a "what does this do?" line. -
Visual direction (project identity). The orange / blue / white work-state palette (against dark navy / near-black background) becomes the project's visual identity. The palette encodes state, not decoration:
- Blue owns frame, control, selection, borders, taskbar, stable system state.
- White owns readable content, primary text, final answers, clean surfaces.
- Orange owns active reasoning, live progress, Fin wakeup/verifier checks, warnings, and goal momentum — appears only when Brother Whale is actively doing something.
- Dark navy / near-black is the background that keeps the palette crisp instead of loud.
The feeling is crisp, cold, useful, kinetic — not a sports-brand parody, not gradient overload. Restraint is the brief. Affordance, not nostalgia. Other themes still ship; this one becomes the default.
-
Shim-drop. Remove
[[bin]] deepseekfromcrates/cli/Cargo.tomland[[bin]] deepseek-tuifromcrates/tui/Cargo.toml. Dropnpm/deepseek-tui/package directory. Dropdeepseek-artifacts-sha256.txtalias fromrelease.yml; stop buildingdeepseek-*release assets. DropCODEWHALE_*=DEEPSEEK_TUI_*legacy env-var aliases (TUI-brand vars only — DeepSeek API vars stay forever). -
Governance + community docs.
GOVERNANCE.md(decision rights, trust boundary),SPONSORSHIP.md(how sponsorship works, what it does not buy — no preferential merging, no "powered by" branding without explicit maintainer approval),SUPPORT.md(where to ask for help).security@codewhale.netsecurity inbox listed inSECURITY.md. Issue templates refreshed. -
Public positioning. README + landing page frame the project precisely: CodeWhale is an agentic terminal workbench for open-source and open-weight coding models. DeepSeek is first-class; Hugging Face Inference Providers and OpenRouter serve as the open-model discovery and routing layer; vLLM, SGLang, Ollama, and TGI cover local serving. Historical CHANGELOG entries untouched.
Out of scope (kept forever)
~/.deepseek/user config directory name.- DeepSeek API env vars (
DEEPSEEK_API_KEY,DEEPSEEK_BASE_URL,DEEPSEEK_MODEL,DEEPSEEK_PROVIDER). api.deepseek.com,api.deepseeki.com.- Model IDs (
deepseek-v4-pro,deepseek-v4-flash). ProviderKind::Deepseekenum +"deepseek"provider string.- Historical CHANGELOG entries.
- CNB mirror namespace.
Definition of done
- Fresh install via
npm install -g codewhaleorcargo install codewhale-clishipscodewhaleandcodewhale-tuibinaries; nodeepseekshim present. - First-run wizard runs cleanly for a new user and produces a working setup (provider key for DeepSeek / HF / OpenRouter / local, default execution mode, theme).
/configopens the control panel; every entry has a "what does this do?" line.- The orange / blue / white work-state palette is the default theme; alternate themes still ship.
GOVERNANCE.md,SPONSORSHIP.md,SUPPORT.mdlive and linked from README.- README provider matrix lists DeepSeek + HF + OpenRouter + the local-runtime path with clear "what each is for" framing.
- A new user sees codewhale-named welcome surfaces with zero legacy strings.
Release gate
- Parity gates green.
CHANGELOG.md[0.8.48]thanks contributors to the v0.8.x DeepSeek-TUI line; frames v0.8.48 as the brand-consolidation + workbench-affordance milestone.- Release notes document the binary removal explicitly (running
deepseekproduces a shell "command not found" — no in-binary message because there is no binary).
List view
0 issues of 29 selected
- Status: Open.#1882 In Hmbown/CodeWhale;
- Status: Open.#1579 In Hmbown/CodeWhale;
- Status: Open.#1564 In Hmbown/CodeWhale;
- Status: Open.#1871 In Hmbown/CodeWhale;
- Status: Open.#1854 In Hmbown/CodeWhale;
- Status: Open.#1605 In Hmbown/CodeWhale;
- Status: Open.#963 In Hmbown/CodeWhale;
- Status: Open.#936 In Hmbown/CodeWhale;
- Status: Open.#998 In Hmbown/CodeWhale;
- Status: Open.#1142 In Hmbown/CodeWhale;
- Status: Open.#1070 In Hmbown/CodeWhale;
- Status: Open (in progress).Hmbown/CodeWhalenumber 1872#1872 In Hmbown/CodeWhale;
- Status: Open (in progress).Hmbown/CodeWhalenumber 1861#1861 In Hmbown/CodeWhale;
- Status: Open.#1038 In Hmbown/CodeWhale;
- Status: Open.#1890 In Hmbown/CodeWhale;
- Status: Open.#790 In Hmbown/CodeWhale;
- Status: Open.#598 In Hmbown/CodeWhale;
- Status: Open.#1708 In Hmbown/CodeWhale;
- Status: Open.#1224 In Hmbown/CodeWhale;
- Status: Open.#1562 In Hmbown/CodeWhale;
- Status: Open.#1461 In Hmbown/CodeWhale;
- Status: Open.#1899 In Hmbown/CodeWhale;
- Status: Open.#688 In Hmbown/CodeWhale;
- Status: Open (in progress).Hmbown/CodeWhalenumber 1935#1935 In Hmbown/CodeWhale;
- Status: Open (in progress).Hmbown/CodeWhalenumber 1937#1937 In Hmbown/CodeWhale;