[!IMPORTANT] This repository is no longer maintained. If needed, please use the official harness: DeepSeek Harness.

Building wirebox.sh — The identity and communication layer for AI agents.

Whale

简体中文 · English

Blazingly fast · ~98% prompt cache hit · Zero bloat

Whale — AI coding agent for DeepSeek, in any environment. Long context, tools, and programmable workflows — start in the terminal, scale to desktop and beyond.

---

🚀 Quick Start

Any platform:

npm install -g @usewhale/whale

macOS:

brew install usewhale/tap/whale

Linux:

curl -fsSL https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.sh | sh

Windows PowerShell:

Requires Windows 10 or Windows Server 2016 or later.

irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex

Windows CMD:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex"

# Set your DeepSeek API key
whale setup

# Launch the interactive TUI
whale

That's it. Type your question and Whale starts working — reading files, running commands, editing code, searching the web.

Need a different model provider, proxy, or custom config? See Configuration.

---

✨ At a Glance

What	Why it matters
💰 ~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.
🐋 DeepSeek-native	Built for DeepSeek's long context (1M tokens), tool calling, and cost efficiency — no generic multi-model wrapper
🔁 Dynamic Workflows	Write JavaScript scripts that orchestrate multiple agents — fan-out research, multi-perspective review, pipelines. Claude Code compatible.
🔌 MCP	Plug in 1,000+ MCP servers for extended tooling — file ops, shell, git, web, and more
🧩 Skills + Plugins	Install community skills (code review, git workflows, etc.) or write your own

---

🔁 Dynamic Workflows

Whale's Dynamic Workflows let you script multi-agent orchestration in JavaScript:

// .whale/workflows/research.js
const results = await parallel([
  () => agent("Search for best practices in Go error handling"),
  () => agent("Find common Go error handling mistakes"),
]);
return agent("Synthesize both findings into a concise guide");

Fan-out research · Multi-perspective review · Pipeline processing · Adversarial validation

✅ Claude Code compatible — workflow scripts written for Claude Code work as-is in Whale.

⚠️ Disabled by default — run /config in the TUI and enable Dynamic workflows, or add [workflows] enabled = true to .whale/config.local.toml.

Learn more: Workflow Overview · Custom Workflow Guide

---

🧰 MCP, Skills & Plugins