Practical overview
When it fits
Use Codewhale when a coding task needs repository context, file editing, command execution and result checking in one terminal-oriented workflow, or when local and hosted model choices are important.
Who it is for
- Developers working in repositories from a terminal.
- Users who want to connect hosted or local models to coding tasks.
- Teams exploring delegated coding subtasks across agents with different models or roles.
Documented uses
- Inspect a project and make requested file changes.
- Run commands and examine their results.
- Execute a coding task interactively or through codewhale exec.
- Explore a repository in plan mode without file changes or shell execution.
- Delegate parts of a larger job to agents with different models and roles.
Requirements & limits
The repository is public, open source and MIT licensed. A connected hosted or local model is required for model replies. Documented interfaces include CLI, local web client and a community-maintained VS Code extension; Computer Use requires review of access requests and applicable OS permissions.
- Model flexibility: hosted providers and local models are supported, with Ollama, vLLM and SGLang named in the documentation.
- Permission control: Ask, Auto-Review and Full Access modes govern review and action approval.
- Execution style: use the interactive terminal interface or codewhale exec for scripted or CI tasks.
- Delegation: larger jobs can be assigned across agents with different models and roles, although the coordination mechanism and limits are not specified.
- Extensibility: MCP servers, skills, hooks and readable agent-role files are documented.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install Codewhale and connect a model
Install the published CLI, place it on the PATH when needed, and connect a hosted or local model.
Before you start
- A supported macOS, Linux or Windows environment.
- For macOS or Linux, access to the official GitHub release installer.
- A hosted model key or a local runtime; the documentation specifically mentions Ollama, vLLM and SGLang.
Steps
On macOS or Linux, run the official installer and launch the executable from $HOME/.local/bin.
If the shell reports that codewhale is not found, follow the installer’s PATH instruction or the documented PATH guide.
On Windows, download the matching installer or archive from GitHub Releases.
Run Codewhale, then use /provider or F3 to add a hosted key or choose a local runtime; use /model to select a model.
Expected outcome
Codewhale opens its terminal interface with a selected provider and model available for tasks.
Guide limitations
- The supplied documentation does not provide configuration steps for each local model runtime.
- Model replies require a connected hosted or local model.
- The first run opens directly to the composer rather than a setup walkthrough.
Compare options for AI coding assistance
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Codewhale | Inspect a project and make requested file changes. | CLI, Linux, macOS, Windows | The repository is public, open source and MIT licensed. A connected hosted or local model is required for model replies. Documented interfaces include CLI, local web client and a community-maintained VS Code extension; Computer Use requires review of access requests and applicable OS permissions. |
| Llmcode | Inspect a project's directory structure with `/tree`. | CLI | The documented setup requires an API key and supports an API base URL and model setting. The project is open source under Apache-2.0. |
| Klaat Code | Open a project directory for terminal-based coding assistance. | CLI, Server | The README provides a global npm installation command and documents browser sign-in with a KlaatAI account. It also identifies the repository as open source under Apache 2.0. |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 1 October 2026
- Original website title
- Hmbown/Codewhale · Official homepage title · retained in its source language