Whale
A DeepSeek-first terminal coding agent with long context, tools, and programmable workflows.
What does this agent do, and when should you use it?
Whale is a terminal-first AI coding agent built for DeepSeek rather than a general multi-model shell. It offers an interactive `whale` TUI, one-shot `whale ask "..."` commands, and `whale --headless` for CI/CD and automated work. The agent can read files, run commands, edit code, and search the web, with extensions through MCP servers, Skills, Subagents, Plugins, and Hooks. Its JavaScript-based Dynamic Workflows orchestrate multiple agents for fan-out research, review, and pipeline-style processing. The project is under active development and is positioned for personal projects, experimental repositories, and workflows where changes can be reviewed and rolled back.
After a DeepSeek API key is configured, whale starts an interactive TUI where the agent can read files, run commands, edit code, and search the web. whale ask "..." handles one-shot questions, quick code reviews, or single-command work, while whale --headless targets CI/CD, automated PR reviews, and scheduled tasks. MCP Servers can connect tools such as databases, APIs, and browser automation; Skills, Subagents, Plugins, and Hooks add domain behavior and lifecycle scripting. When Dynamic Workflows are enabled, JavaScript files in .whale/workflows/ can use parallel and agent to run multiple tasks and synthesize their results.
- A developer using the DeepSeek API who wants a terminal agent to inspect repository files, execute commands, and edit code.
- An engineer needing a quick, single-turn code review or answer through `whale ask "..."`.
- A team running automated PR reviews, scheduled jobs, or other non-interactive tasks through `whale --headless` in CI/CD.
- A developer who needs databases, APIs, or browser automation available to a coding workflow through MCP Servers.
- A user who wants to fan out research or multi-perspective review work in JavaScript and then synthesize the results with another agent.
What are this agent's strengths and limitations?
- It is explicitly optimized around DeepSeek long context, tool calling, and caching; the README reports an approximately 98% prompt-cache hit rate.
- It exposes interactive TUI, one-shot CLI, and headless automation interfaces for local and CI/CD use.
- Dynamic Workflows provide JavaScript multi-agent orchestration and are documented as compatible with Claude Code workflow scripts.
- MCP Servers, Skills, Subagents, Plugins, and Hooks offer several distinct extension mechanisms.
- Whale is DeepSeek-first rather than a provider-agnostic multi-model tool, and setup requires a DeepSeek API key.
- Dynamic Workflows are disabled by default and require explicit activation through `/config` or `.whale/config.local.toml`.
- The project is in active development; its README recommends personal projects, experimental repositories, and workflows with reviewable, reversible changes.
- The supplied documentation does not describe native integrations for ChatGPT, Codex, the OpenAI API, or the Claude API.
How do you install or deploy this agent?
On any platform, run npm install -g @usewhale/whale. On macOS, you can instead run brew install usewhale/tap/whale. Then run whale setup to set a DeepSeek API key and start the interactive TUI with whale. For Linux, the documented command is curl -fsSL https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.sh | sh. For Windows 10, Windows Server 2016, or later, run irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex in PowerShell.
How do you use this agent?
Run whale after whale setup, then enter a task in the TUI. For a one-shot request, use whale ask "Review this code"; for automation, use whale --headless. Dynamic Workflows are disabled by default: enable Dynamic workflows through /config in the TUI, or add [workflows] enabled = true to .whale/config.local.toml.
How does this agent compare with similar options?
Whale explicitly rejects the role of a general multi-model shell and instead positions itself as DeepSeek-first. It states that Claude Code workflow scripts run unchanged in Whale, but that compatibility is for workflow scripts rather than evidence of a complete Claude Code product integration.