Whale
Whale — blazingly fast, terminal-first AI coding agent for DeepSeek. ~98% prompt cache hit rate, 1M context, MCP tools, dynamic workflows.
Whale is a terminal-first AI coding agent optimized for DeepSeek's API, designed for fast, cost-efficient software development workflows. It achieves approximately 98% prompt cache hit rates through aggressive context reuse, supporting up to 1 million tokens of context while minimizing API costs. The agent offers interactive TUI, CLI, and headless modes, with extensibility through MCP servers, custom skills, and JavaScript-based dynamic workflows that are compatible with Claude Code workflow scripts.
Key Features
Use Cases
- 01Interactive coding sessions with full-context chat, code review, and iterative refinement
- 02Automated pull request reviews and code quality checks in CI/CD pipelines
- 03Multi-perspective code analysis using parallel agent workflows for best practices research
- 04Cost-effective AI-assisted development leveraging DeepSeek's pricing and aggressive caching
- 05Quick one-shot code reviews and refactoring suggestions via CLI commands
- 06Extended tooling integration through MCP servers for databases, APIs, and browser automation
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
Whale — FAQ
What is Whale?+
Whale is a terminal-first AI coding agent built specifically for DeepSeek's API. It provides interactive coding assistance with file operations, command execution, code editing, and web search capabilities, optimized for low-cost operation through aggressive prompt caching.
How do I install Whale?+
Install globally via npm with 'npm install -g @usewhale/whale', through Homebrew on macOS with 'brew install usewhale/tap/whale', or use the platform-specific shell/PowerShell installation scripts. After installation, run 'whale setup' to configure your DeepSeek API key.
Do I need a DeepSeek API key?+
Yes, Whale requires a DeepSeek API key to function. Run 'whale setup' after installation to configure your API key, which you can obtain from DeepSeek's platform.
Is Whale free to use?+
Whale is open-source software, but it requires a DeepSeek API account which has its own pricing. The ~98% cache hit rate significantly reduces API costs, making AI-assisted coding highly economical.
Which AI clients does Whale work with?+
Whale is a standalone agent that runs independently in your terminal, desktop, or CI/CD environment—it doesn't plug into other AI clients. However, its dynamic workflows are compatible with Claude Code workflow scripts.
Can I use Whale in automated workflows?+
Yes, Whale supports headless mode ('whale --headless') specifically designed for CI/CD pipelines, automated PR reviews, and scheduled tasks without interactive input.
How do I install Whale?+
Open the source repository on GitHub and follow its README. Whale is a agent — MCP Agents Market links you directly to the official repo.
Is Whale free?+
Whale is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.