LibreAI / Dev Tools / Codewhale
// devtools · codewhale-hq/Codewhale

Codewhale

Open-source Rust agent engine and terminal client with provider choice, approvals and receipts

★ 41.1k stars⑂ 3.6k forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Codewhale is an open-source dev tools project by codewhale-hq (codewhale-hq/Codewhale on GitHub). It has 41,082 GitHub stars and 3,568 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
41,082
Forks
3,568
License
MIT
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want from Codewhale and check the README and requirements to confirm it fits your setup and Rust environment.

  2. Get the code

    Clone the repository from GitHub (github.com/codewhale-hq/Codewhale) or use the documented install channel if you do not need the source.

  3. Install and configure

    Follow the README quickstart to install dependencies and set any required configuration or credentials.

  4. Run your first task

    Work through the README's first example end to end, then adapt it to your own project or data.

// features

Why people love it

Terminal agent client

A terminal client and agent engine written in Rust for coding work.

Provider choice

Choose between multiple model providers instead of being locked to one.

Approvals

Tool actions go through an approvals flow so you control what executes.

Receipts

Actions produce receipts, giving an auditable record of agent work.

Modes and permissions

Documented modes and permissions tune how autonomous the agent may be.

MCP and multi-agent

Supports MCP and multi-agent, multi-model workflows per the project topics.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Start by getting the source and entering the project directory.

    git clone https://github.com/codewhale-hq/Codewhale.git
    cd Codewhale
  2. Install Codewhale

    Use the install script, npm (`npm install -g codewhale`), or Cargo (`cargo install codewhale-cli --locked`).

    curl -fsSL https://codewhale.net/install.sh | sh
  3. Start the terminal client

    Launch it in your project and pick your provider and mode.

    codewhale  # see README for the exact command
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Codewhale?

It is maintained by codewhale-hq and contributors on GitHub, where the repository github.com/codewhale-hq/Codewhale is the canonical home for code, issues and releases.

Is Codewhale free to use?

Yes — it is open source under the MIT license. Read the license in the repository for what is permitted, including any conditions on redistribution or commercial use.

Does it need a paid API key?

Yes — you connect your own model provider account or API key.

How does Codewhale compare to alternatives?

Compared with Claude Code: Codewhale is provider-agnostic and Rust-based with an approvals-and-receipts model, while Claude Code is Anthropic's own Claude-only tool.

How do I get started?

Clone github.com/codewhale-hq/Codewhale, follow the README quickstart to install it, and run the documented first example before adapting it to your own work.

// keep exploring

Similar tools

Dev Tools

gptme

gptme is a terminal AI agent with shell, files, browser, vision, and subagents — provider-agnostic

★ 4.4k starsMIT
View guide →
Dev Tools

jcode

A high-performance coding agent harness in Rust - fast TUI, swarms and every provider

★ 20.4k starsMIT
View guide →
Dev Tools

herdr

The terminal runtime your coding agents live on — a Rust multiplexer built for agent sessions

★ 42.9k starsApache-2.0
View guide →
Dev Tools

codex

OpenAI's lightweight coding agent that runs locally in your terminal

★ 128.2k starsApache-2.0
View guide →
Dev Tools

pi_agent_rust

A native Rust port of the Pi coding agent: single binary, zero unsafe code, and hardened extensions.

★ 1.9k starsMIT
View guide →
Dev Tools

Gemini Cli

An open-source AI agent that brings the power of Gemini directly into your terminal

★ 107.2k starsApache-2.0
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if Codewhale is not the right fit.

Get Codewhale

Free and open — grab the source, star the repo, and start creating.