Hmbown/Codewhale

What it solves

Codewhale is a terminal-based coding agent that helps developers automate repetitive or complex coding tasks directly from the command line. It allows users to read repositories, edit files, and run commands to achieve a specific goal, acting as an AI teammate that can autonomously work through a problem.

How it works

Built in Rust, Codewhale integrates with various AI models via hosted providers or local runners like Ollama, vLLM, or SGLang. It operates as a TUI (Terminal User Interface) or a direct command-line execution tool. The agent can read your code, execute commands, and modify files based on a user's goal. To maintain safety and control, it features approval modes (Ask, Auto-Review, Full Access) and workspace snapshots for easy restoration via /undo and /restore.

Who it’s for

Developers who prefer working in the terminal and want an AI agent capable of executing real-world tasks in their local environment with high levels of control and organization.

Highlights

• Model Flexibility: Supports a wide range of hosted and local models, switchable via /model.
• Control Mechanisms: Includes read-only plans, approval modes, and the ability to revert changes with /undo.
• Goal-Oriented: Supports durable goals and session saving for long-term work.
• Extensibility: Connects to MCP servers and skills, uses configurable hooks, and allows agent roles to be defined as readable files.
• Safety: Offers optional OS sandboxing and repository rules to limit agent actions.