Codewhale

Project Overview

CodeWhale is an open-source coding agent for your terminal, built in Rust and improved in public with the people who use it.

Key Features

• Use the model you want — connect hosted providers or local models through Ollama, vLLM, or SGLang; switch provider and model with /model
• Stay in control — Plan is read-only; Ask, Auto-Review, and Full Access make approval behavior visible; /undo reverts the last turn and /restore returns to an earlier snapshot
• Keep long work organized — save sessions, set a durable /goal
• Multiple installation methods: npm, Cargo, Docker, Nix, Scoop, Android/Termux

Target Audience

• Developers who want AI coding assistance in the terminal
• Teams who need flexible model selection and permission control
• Users who value open-source and community-driven projects

Quick Start

1. Install: npm install -g codewhale
2. Launch: codewhale
3. The first run helps you connect a provider or stay offline
4. Run a task without opening the TUI: codewhale exec "fix the failing tests and explain what changed"

Core Advantages

• Built in Rust for excellent performance
• Supports multiple model providers and local models
• Visible approval behavior for control
• Session persistence and recovery

System Requirements

• OS: Cross-platform (macOS, Linux, Windows, Android/Termux)