Whale is an unofficial, open-source AI coding agent for the terminal, built to leverage the DeepSeek API. It targets developers seeking a cost-effective, high-performance AI assistant directly within their command-line environment, offering significant savings (~30x cheaper than Claude Code) and optimized long coding sessions via advanced prefix-cache utilization.

How It Works

Whale operates as a terminal-first application, deeply integrating with the DeepSeek API. Its core design prioritizes maximizing DeepSeek's prefix-caching mechanism by ensuring byte stability through append-only turns and stable context ordering. This enables efficient local code reading, file editing, and shell command execution, with extensibility via MCP for external tools and Skills for reusable workflows.

Quick Start & Requirements

Installation is available via script (curl ... | sh), Homebrew (brew install usewhale/tap/whale), or Windows PowerShell/CMD. A DeepSeek API key is required. Whale supports macOS, Linux, and Windows. Relevant documentation links include CONTRIBUTING.md, ROADMAP.md, and SECURITY.md.

Highlighted Details

• Supports DeepSeek V4 models with a 1 million token context window.
• Claims ~97% live prefix-cache hit rate for optimized performance.
• Offers significant cost savings, estimated at ~30x cheaper per task than Claude Code.
• Features a terminal-first TUI/CLI interface for interactive coding, local file operations, and shell command execution.
• Extensible via MCP for external tools and local Agent Skills for reusable workflows.

Maintenance & Community

The project is actively developed, with a roadmap at ROADMAP.md and contribution guidelines in CONTRIBUTING.md. Security concerns are addressed via SECURITY.md. It's a community-driven project, independent of DeepSeek Inc.

Licensing & Compatibility

The project is open-source; a specific license type is not detailed in the provided README. Compatibility is focused on terminal environments, integrating with shell, Git, and testing commands, rather than replacing IDEs. Whale is currently DeepSeek-only.

Limitations & Caveats

Whale is an unofficial, DeepSeek-only agent, not a generic multi-model wrapper. The project is described as "moving quickly," best suited for personal projects or workflows where changes are easily reviewed and rolled back. It is terminal-first and does not replace IDEs.