Why it matters
This tool empowers developers by bringing AI coding assistance directly into their terminal workflow. Its flexibility in model choice and control over AI actions can streamline development processes and automate repetitive tasks. Builders can integrate it into scripts or use its interactive TUI for complex problem-solving.

What changed

Codewhale is an open-source AI coding agent that operates within the terminal, built using the Rust programming language. It is designed to read project files, edit code, execute commands, and verify its work, leveraging either hosted or local AI models. The latest release, v0.10.0, introduces a fresh build with continuous community improvement as a core focus. Installation for macOS and Linux is facilitated via a curl script that fetches the official GitHub release, while Windows users can download installers or archives from GitHub Releases. Existing installations can be updated using the codewhale update command. The initial run directs users to a composer interface, requiring a model connection via /provider or F3 to add hosted keys or select local runtimes. It automatically connects to Ollama if it's running with a chat model. Codewhale also offers support for various packaging routes including npm, Cargo, Docker, Nix, Scoop, Android/Termux, and a CNB mirror. Tab completion is available for bash, zsh, fish, powershell, and elvish shells.

Users can initiate tasks by running codewhale in their project directory, selecting a provider and model using /provider and /model commands, and then describing a concrete task, such as "Fix the failing tests and explain what changed." Alternatively, tasks can be executed non-interactively using codewhale exec "task description". The agent supports different operational modes: /mode plan for exploration without file changes or shell execution, and /mode work for making modifications. Users can also specify access levels via Shift+Tab, choosing between Ask, Auto-Review, or Full Access, with detailed explanations available in the modes and permissions guide.

Codewhale includes a terminal interface, a local web client accessible via codewhale web, and a planned native desktop app. A community-maintained VS Code extension also connects to the local Codewhale Runtime. The agent offers features to manage long-running tasks, save sessions, set durable goals, review workflows, and coordinate agents. Safety features include approval modes, repository rules, and optional OS sandboxing to limit agent actions. Users can undo or restore workspace changes using /undo and /restore commands.

Why it matters for builders

Codewhale brings powerful AI coding assistance directly into the developer's terminal, reducing the need to switch contexts. Its ability to integrate with both local and hosted models provides flexibility and control over AI processing and costs. Developers can leverage Codewhale for automated code fixes, task execution, and complex problem-solving directly within their existing development environment.

Practical impact

Developers can install Codewhale using the provided script for macOS/Linux or download installers for Windows. After installation, they can connect their preferred AI models using the /provider and /model commands. For immediate use, running codewhale in a project directory and issuing a task command like "Refactor this function" allows for direct interaction. For scripting or CI/CD pipelines, codewhale exec can be integrated. Builders should explore the different access modes (Ask, Auto-Review, Full Access) to find the right balance of automation and control for their workflows. The VS Code extension offers an alternative integration point for those who prefer an IDE-centric experience.

Caveats and source limits

The source indicates a "fresh release" for v0.10.0, but specific performance benchmarks or detailed comparisons to previous versions are not provided. Pricing for hosted models is not detailed within the source, and users are responsible for managing their own model costs. While the agent supports various local model runtimes like Ollama, vLLM, and SGLang, the setup complexity for these local environments is not elaborated upon. The exact capabilities and limitations of the "Computer Use" plugin, which allows interaction with other applications, are described as requiring review of requested access and platform requirements, with detailed setup guidance available separately. The native desktop app is mentioned as a future direction, with its current availability and feature set not fully detailed in this excerpt.

Sources

Written with AI assistance from the linked sources; every claim below was checked against them automatically. How we produce articles.

Claim check: 9/9 supported claims - 9 evidence links - 100% avg confidence
  • Codewhale is an open-source AI coding agent for the terminal, built in Rust.supported - github.com
  • Codewhale can read projects, edit files, run commands, and check its work using hosted or local models.supported - github.com
  • The latest release is v0.10.0.supported - github.com
  • Installation for macOS/Linux uses a `curl` script, and Windows users download installers from GitHub Releases.supported - github.com
  • Codewhale supports integration with Ollama, vLLM, and SGLang for local models.supported - github.com
  • Users can interact with Codewhale via a terminal TUI or a non-interactive `exec` command.supported - github.com
  • Codewhale offers different access modes: Ask, Auto-Review, and Full Access.supported - github.com
  • A VS Code extension is available for Codewhale.supported - github.com
  • Codewhale includes safety features like approval modes and optional OS sandboxing.supported - github.com

Caveats

  • Single-source caution: verify critical details at the linked source.
Radar score 87/100 - how it was calculated
Reliability82
Freshness92
Novelty77
Technical85
Developer96
Ecosystem72
Confidence100
  • Reliability 82: GitHub metadata supports source trust
  • Freshness 92: Fresh GitHub activity
  • Novelty 77: Fresh GitHub release
  • Technical 85: Repository technical metadata
  • Developer 96: Developer tooling signals
  • Ecosystem 72: Fresh GitHub release
  • Confidence 100: Claims have reliable evidence
Share
XLinkedInHacker News

Discussion

Loading comments...

Related articles

AI Coding - Nov 16, 2026cdpilot v0.9.12: Browser Automation CLI with CDPcdpilot, a Python-based browser automation CLI, has released version v0.9.12. It operates directly on the Chrome DevTools Protocol (CDP) without external dependencies like Puppeteer or Playwright, offering over 70 commands for testing and web scraping.AI Coding - Nov 20, 2026AndroidHarness AI Coding Agent Native App v3.4AndroidHarness has released version 3.4 of its native Android AI coding agent app. This update introduces an interactive terminal for running full shells, enhanced storage and skills management, and more granular control over context and changes.AI Coding - Nov 15, 2026OpenCode Mobile: Run AI Coding Agents on AndroidOpenCode Mobile is a new Android application that allows users to run various AI coding agents, including Claude Code and OpenCode, directly on their phones without needing a computer. The app provides a Linux environment, chat interface, diff viewer, and Git integration, enabling users to manage and steer agents remotely or locally.AI Coding - Nov 20, 2026iPhone CLI: AI Agents Control Real iPhones via Accessibility TreeThe iphone-cli tool allows AI agents to interact with real iPhones using the accessibility tree, bypassing the need for Xcode, WebDriverAgent, or on-device app installations. This Rust-based CLI tool supports iOS 27+ and operates directly from the terminal on macOS and Windows.Agents - Nov 14, 2026Strands Box: Open Source AI Agent SandboxStrands Box is an open-source sandbox for AI agents, written in Rust. It restricts agent execution, file access, and network reach using OS isolation and semantic policies defined in Dogwood. The system supports macOS on Apple silicon and Linux ARM64, with experimental x86-64 support.Agents - Nov 19, 2026OpenCrawl Core: Multiplayer Context Layer for Coding AgentsOpenCrawl Core introduces a multiplayer context layer designed to enhance collaboration among coding agents. It enables agents to share search results, memory files, and coordinate actions, working with models like Claude Code and Codex.