usewhale/Whale

Whale – DeepSeek용 AI 기반 코딩 어시스턴트

개요 – Whale은 터미널 우선, DeepSeek에 최적화된 AI 에이전트로, 코드를 읽고, 편집하고, 실행하고, 웹을 탐색하고, 도구를 호출할 수 있습니다. 단일 바이너리(또는 npm 패키지)로 제공되며 TUI, 일회성 CLI, CI/CD용 헤드리스 모드를 제공합니다.

주요 기능

• 프롬프트 캐싱(약 98% 적중률) – 이전에 보낸 컨텍스트를 재사용하여 대부분의 상호 작용 비용이 몇 센트에 불과합니다.
• DeepSeek 네이티브 – DeepSeek의 1M 토큰 컨텍스트, 도구 호출 및 가격 모델에 맞게 조정되었습니다.
• 동적 워크플로우 – 여러 에이전트(병렬 조사, 합성 등)를 조율하는 JavaScript 스크립트를 작성합니다. Claude Code 스크립트와 호환됩니다.
• MCP, 스킬 및 플러그인 – 수천 개의 MCP 서버(파일 작업, git, 웹, 데이터베이스)에 연결하고, 커뮤니티 "스킬"(코드 검토, git worktree)을 로드하거나 사용자 정의 플러그인과 훅을 추가할 수 있습니다.
• 다중 인터페이스 – 대화형 TUI(whale), 빠른 CLI(whale ask "…"), 자동화를 위한 헤드리스 모드.

설치

# npm(크로스 플랫폼)
npm install -g @usewhale/whale
# macOS는 Homebrew 사용
brew install usewhale/tap/whale
# Linux 원라이너
curl -fsSL https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.sh | sh
# Windows PowerShell
irm https://raw.githubusercontent.com/usewhale/Whale/main/scripts/install.ps1 | iex

설치 후 whale setup을 실행하여 DeepSeek API 키를 저장한 다음 whale로 에이전트를 시작합니다.

일반적인 워크플로우

1. TUI를 시작합니다(whale).
2. 자연어 요청을 입력합니다(예: "이 함수를 리팩터링해 줘").
3. Whale이 관련 파일을 읽고, DeepSeek 모델을 호출하고, 도구(셸, git, 웹 검색)를 호출할 수 있으며, 편집된 코드를 반환합니다.
4. 스크립트화된 파이프라인의 경우 .whale/workflows/*.js 파일을 배치하고 구성에서 동적 워크플로우를 활성화합니다.

프로젝트 상태 – 이 저장소는 더 이상 유지 관리되지 않습니다. README는 유지 관리되는 대안으로 공식 DeepSeek Harness를 안내합니다. 코드는 계속 사용할 수 있지만 추가 업데이트나 공식 지원은 없습니다.

대상 사용자 – 전체 IDE 통합의 오버헤드 없이 터미널에서 직접 작동하고 CI 파이프라인에 포함할 수 있는 빠르고 저렴한 AI 코딩 어시스턴트를 원하는 개발자.