Overview

CodeWhale is a sophisticated terminal-native coding agent powered by DeepSeek V4, designed to supercharge your development workflow directly from your command line. It seamlessly integrates a powerful language model with robust tools and an intelligent "harness" to ensure focused, efficient, and verifiable code generation and task completion. Experience AI-assisted coding where trust, clear authority, and continuous improvement are paramount.

Key Features

• DeepSeek V4 Integration: Leverages the advanced capabilities of DeepSeek V4 for intelligent code understanding and generation.
• Terminal-Native Experience: Operates entirely within your terminal, providing a fast, efficient, and distraction-free coding environment with the codewhale command.
• Interactive TUI: Features a rich, interactive Text User Interface (TUI) powered by codewhale-tui for dynamic session management and feedback.
• Reasoning Blocks & Approval Gates: Streams explicit reasoning steps and enforces approval gates for potentially destructive workspace edits, ensuring user control.
• Auto Mode: Intelligently selects the optimal model (DeepSeek V4 Flash vs. Pro) and thinking level (off, high, max) per turn, balancing cost and capability.
• Constitutional Authority: Operates under a formal "Constitution" that defines a clear hierarchy of directives, ensuring user intent and verifiable facts always take precedence.
• Recursive Improvement: The agent's "harness" is designed to improve alongside the model, leading to progressively stronger and more accurate interactions.
• Workspace Editing with Verification: Edits local workspaces with built-in verification mandates, ensuring every action leaves evidence.
• Concurrent Sub-Agents: Supports running up to 20 sub-agents concurrently for complex, multi-task workflows.
• Side-Git Snapshots: Records workspace state in side-git snapshots, enabling easy rollback and exploration of alternative development paths.
• Extensive Provider Support: Connects with a wide array of LLM providers, including DeepSeek, OpenAI-compatible endpoints, NVIDIA NIM, Xiaomi MiMo, and more.
• LSP Diagnostics Integration: Feeds live Language Server Protocol diagnostics into the model's context after every edit for immediate awareness.

Typical Use Cases

• Automated Code Generation & Refactoring: Generate new code snippets, refactor existing codebases, or translate code between languages.
• Intelligent Debugging: Analyze error messages, trace execution paths, and suggest fixes for bugs.
• Code Explanation & Documentation: Understand complex functions, generate documentation, and explain code logic.
• Task Automation: Automate repetitive development tasks, scripting, and data processing.
• Exploratory Development: Rapidly prototype ideas and explore alternative solutions with branching conversations and workspace rollbacks.
• Pair Programming Assistance: Collaborate with the AI agent in real-time within your terminal.
• Complex Workflow Orchestration: Manage multi-step processes and background tasks using concurrent sub-agents.
• CI/CD Pipeline Integration: Integrate AI-driven code analysis and review into your continuous integration and delivery pipelines.