CodeWhale
ActiveDescription
CodeWhale is a DeepSeek + MiMo powered terminal coding agent delivering high-performance code generation and reasoning for developers.
Key Features
- Constitution architecture — Nine-tier authority hierarchy where user intent > verification > confidence, ensuring correct decision chains in conflicting contexts
- Concurrent sub-agents — Up to 20 parallel sub-agents with async task delegation, results returned inline via completion sentinels
- LSP diagnostics integration — Auto-runs rust-analyzer, pyright, typescript-language-server after every edit, injecting diagnostics into next reasoning step
- Three operation modes — Plan (read-only), Agent (approval-gated destructive ops), YOLO (auto-approve in trusted workspaces)
- Workspace snapshots & rollback — Side-git snapshot per turn, /restore and revert_turn for full workspace rollback
- Auto model routing — Fin flash call auto-selects model, --model auto default, DeepSeek V4 prefix caching reduces inference cost ~100x
Use Cases
💡 Large-scale code refactoring — Parallel sub-agents handle multi-module refactors, LSP ensures type safety, snapshots enable safe rollback
💡 Cross-language development — Unified terminal experience with LSP for Rust, Python, TypeScript, Go and more
💡 Security-sensitive code changes — Plan mode for review, Agent mode for approval-gated execution, Constitution prevents dangerous operations
💡 AI-assisted debugging — Non-zero exit codes, type errors, and sandbox denials feed back as correction vectors for self-healing
💡 Team collaborative development — Workspace snapshots and rollback for multi-person collaboration with full change traceability
Strengths & Limitations
✅ Strengths
- • Actively maintained, recent updates
- • High community interest (40.9k stars)
- • Permissive open-source license (MIT)
- • Responsive to issues, low backlog
Tags
Categories
Quick Start
```bash
# Install
cargo install codewhale-cli --locked
cargo install codewhale-tui --locked
# Set API Key
export DEEPSEEK_API_KEY="your-key-here"
# Launch
codewhale
# Or start in agent mode in current directory
codewhale --mode agent
```