{"id":"308f1ad6-e0f4-498a-a1f4-6b0dafc52306","slug":"whale","kind":"mcp","name":"Whale","summary":"Whale — blazingly fast, terminal-first AI coding agent for DeepSeek. ~98% prompt cache hit rate, 1M context, MCP tools, dynamic workflows.","owner":"usewhale","repoUrl":"https://github.com/usewhale/Whale","license":"MIT","licenseTier":"permissive","trust":"community","stars":933,"match":null,"fewStars":false,"format":"mcp","createdAt":null,"addedAt":"2026-10-14T05:37:18.558Z","logoUrl":"https://avatars.githubusercontent.com/u/282163618?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["memory-knowledge"],"tags":["deepseek","deepseek-agent","deepseek-cli","llm","terminal","coding-agent","go","deepseek-coding-agent"],"runtime":"go","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-14T05:44:37.762Z","sample":false,"url":"https://conduits.dev/tools/whale","language":"Go","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# Whale\n\n<p align=\"center\">\n  <img src=\"docs/logo.svg\" alt=\"Whale — AI coding agent for DeepSeek, in any environment\" width=\"640\">\n</p>\n\n<p align=\"center\">\n  <a href=\"./README.zh.md\">简体中文</a> · <strong>English</strong>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/usewhale/Whale/releases\"><img src=\"https://img.shields.io/github/v/release/usewhale/Whale?label=release\" alt=\"release\"></a>\n  <a href=\"https://www.npmjs.com/package/@usewhale/whale\"><img src=\"https://img.shields.io/npm/v/@usewhale/whale\" alt=\"npm\"></a>\n  <a href=\"https://github.com/usewhale/Whale/actions/workflows/ci.yml\"><img src=\"https://img.shields.io/github/actions/workflow/status/usewhale/Whale/ci.yml?label=CI\" alt=\"CI\"></a>\n  <a href=\"./LICENSE\"><img src=\"https://img.shields.io/github/license/usewhale/Whale\" alt=\"license\"></a>\n  <a href=\"https://github.com/usewhale/Whale/stargazers\"><img src=\"https://img.shields.io/github/stars/usewhale/Whale?style=flat&logo=github&label=stars\" alt=\"GitHub stars\"></a>\n  <img src=\"https://img.shields.io/badge/prompt%20cache-98%25-brightgreen\" alt=\"98% prompt cache hit\">\n</p>\n\n<p align=\"center\">\n  Blazingly fast · ~98% prompt cache hit · Zero bloat\n</p>\n\n<p align=\"center\">\n  <b>Whale — AI coding agent for DeepSeek, in any environment.</b><br>\n  Long context, tools, and programmable workflows —<br>\n  start in the terminal, scale to desktop and beyond.\n</p>\n\n---\n\n## 🚀 Quick Start\n\nAny platform:\n\n```bash\nnpm install -g @usewhale/whale\n```\n\nmacOS:\n\n```bash\nbrew install usewhale/tap/whale\n```\n\nLinux:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.sh | sh\n```\n\nWindows PowerShell:\n\nRequires Windows 10 or Windows Server 2016 or later.\n\n```powershell\nirm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex\n```\n\nWindows CMD:\n\n```cmd\npowershell -NoProfile -ExecutionPolicy Bypass -Command \"irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex\"\n```\n\n```bash\n# Set your DeepSeek API key\nwhale setup\n\n# Launch the interactive TUI\nwhale\n```\n\nThat's it. Type your question and Whale starts working — reading files, running commands,\nediting code, searching the web.\n\n> Need a different model provider, proxy, or custom config? See [Configuration](docs/configuration.en.md).\n\n---\n\n## ✨ At a Glance\n\n| What | Why it matters |\n|---|---|\n| 💰 **~98% prompt cache hit** | Whale reuses cached context aggressively — most prompts hit cache, slashing costs to pennies per session. DeepSeek pricing × Whale caching = AI-assisted coding at scale. |\n| 🐋 **DeepSeek-native** | Built for DeepSeek's long context (1M tokens), tool calling, and cost efficiency — no generic multi-model wrapper |\n| 🔁 **Dynamic Workflows** | Write JavaScript scripts that orchestrate multiple agents — fan-out research, multi-perspective review, pipelines. Claude Code compatible. |\n| 🔌 **MCP** | Plug in 1,000+ MCP servers for extended tooling — file ops, shell, git, web, and more |\n| 🧩 **Skills + Plugins** | Install community skills (code review, git workflows, etc.) or write your own |\n\n---\n\n## 🔁 Dynamic Workflows\n\nWhale's **Dynamic Workflows** let you script multi-agent orchestration in JavaScript:\n\n```js\n// .whale/workflows/research.js\nconst results = await parallel([\n  () => agent(\"Search for best practices in Go error handling\"),\n  () => agent(\"Find common Go error handling mistakes\"),\n]);\nreturn agent(\"Synthesize both findings into a concise guide\");\n```\n\n**Fan-out research · Multi-perspective review · Pipeline processing · Adversarial validation**\n\n> ✅ **Claude Code compatible** — workflow scripts written for Claude Code work as-is in Whale.\n\n> **⚠️ Disabled by default** — run `/config` in the TUI and enable `Dynamic workflows`, or add `[workflows] enabled = true` to `.whale/config.local.toml`.\n\nLearn more: [Workflow Overview](docs/workflows.en.md) · [Custom Workflow Guide](docs/custom-workflows.en.md)\n\n---\n\n## 🧰 MCP, Skills & Plugins\n\n| Extension | What it does | Get started |\n|---|---|---|\n| **MCP Servers** | Connect to 1,000+ tools (databases, APIs, browser automation) | [docs/mcp.en.md](docs/mcp.en.md) |\n| **Skills** | Load domain expertise — code review, git-worktree, and more | [docs/skills.en.md](docs/skills.en.md) |\n| **Subagents** | Define focused child-agent roles such as reviewers or researchers | [docs/agents.en.md](docs/agents.en.md) |\n| **Plugins** | Extend Whale's runtime with custom logic | [docs/plugins.en.md](docs/plugins.en.md) |\n| **Hooks** | Run scripts on lifecycle events | [docs/hooks.en.md](docs/hooks.en.md) |\n\n---\n\n## 📸 How It Works\n\nWhale currently offers three interfaces — with more environments on the way:\n\n| Interface | When to use |\n|---|---|\n| **`whale`** (TUI) | Interactive coding sessions — chat, review, iterate with full context |\n| **`whale ask \"...\"`** (CLI) | One-shot questions, quick code reviews, single commands |\n| **`whale --headless`** | CI/CD, automated PR reviews, scheduled tasks |\n\n---\n\n## 🎯 Non-goals\n\n- **Multi-model shell.** Whale is DeepSeek-first — optimized for DeepSeek's caching, tools, and pricing.\n- **IDE replacement.** Whale is not an IDE — it's an agent that meets you wherever you code: terminal, desktop, or CI.\n\n## 📦 Project Status\n\nWhale is in active development. Best suited for personal projects, experimental repositories,\nand workflows where changes can be reviewed and rolled back.\n\n> **Disclaimer:** This project is not affiliated with DeepSeek Inc. It is an independent open-source community project.\n\n---\n\n## 🤝 Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for local development, testing, issues, and PRs.\n\nCurrent direction and available tasks: [ROADMAP.md](ROADMAP.md).\n\nSecurity issues: [SECURITY.md](SECURITY.md).\n\n---\n\n## Star History\n\n<a href=\"https://www.star-history.com/?repos=usewhale%2FWhale&type=date&legend=top-left\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/chart?repos=usewhale/Whale&type=date&theme=dark&legend=top-left\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/chart?repos=usewhale/Whale&type=date&legend=top-left\" />\n   <img alt=\"Star History Chart\" src=\"https://api.star-history.com/chart?repos=usewhale/Whale&type=date&legend=top-left\" />\n </picture>\n</a>\n\n---\n\n## 🙏 Credits\n\nWhale stands on the shoulders of giants:\n\n- [Charmbracelet](https://charm.sh) — Bubble Tea, Lip Gloss, Glamour, and the entire TUI ecosystem\n- [fastschema/qjs](https://github.com/fastschema/qjs) — QuickJS Go bindings for workflow scripting\n- [spf13/cobra](https://github.com/spf13/cobra) — CLI framework\n- [alecthomas/chroma](https://github.com/alecthomas/chroma) — Syntax highlighting\n- [yuin/goldmark](https://github.com/yuin/goldmark) — Markdown parsing\n- [modelcontextprotocol/go-sdk](https://github.com/modelcontextprotocol/go-sdk) — MCP protocol support\n- [tetratelabs/wazero](https://github.com/tetratelabs/wazero) — Pure-Go WebAssembly runtime\n\nAnd the many open-source libraries we depend on — thank you.\n"}