# Hmbown/CodeWhale

Open-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome.

Repository: https://github.com/Hmbown/CodeWhale
Canonical: https://ross.abutalabs.com/products/codewhale
Homepage: https://codewhale.net/
Language: Rust
License: MIT
License Family: permissive
Topics: cli, rust, tui, ai-agent, coding-agent, agent-orchestration, local-first, mcp, multi-agent, multi-model, open-source
Last push: 2026-08-26T23:12:57+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 16
- inputs: {"age_days": 226, "days_push": 7, "days_rel": 10, "gap_med": 0.0, "n_releases_24m": 135}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 40866, forks 3538 (observed 2026-08-28T04:12:08.383704+00:00)

## What it is
Codewhale is an open-source, terminal-native coding agent written in Rust that reads your repository, edits files, runs commands, and works toward goals under configurable approval modes. It supports any hosted or local model (Ollama, vLLM, SGLang, 45+ providers), multi-agent fleets, MCP servers, and hooks, with a TUI and headless exec mode.

## Use cases
- fix failing tests from the terminal with an AI agent
- run a coding agent with local models via Ollama
- orchestrate multiple AI agents on coding tasks
- automate code edits with approval gates and undo
- connect MCP servers to a terminal coding assistant
- use different LLM models for different agent roles
- run headless coding agent tasks in CI or scripts

## When to choose
- you want a terminal-native coding agent that works with local or self-hosted models
- you need fine-grained permission modes, undo, and workspace snapshots
- you want multi-agent orchestration (Fleet/Workflow) with MCP and hooks extensibility
- you prefer open-source, local-first tooling with no vendor lock-in

## When to avoid
- you want a GUI or IDE-integrated assistant rather than a terminal TUI
- you need a fully managed cloud coding service with no local setup
- you require long-term stability guarantees — the project is pre-1.0 and evolving quickly

## Facets
- artifact type: cli-tool
- maturity: active
- function: agent-framework, cli, mcp, llm-inference, developer-tools, terminal-ui
- domain: developer-tools, large-language-models
- platform: cli, windows, rust, cross-platform
- tags: coding-agent, tui, multi-model, local-first, multi-agent, bring-your-own-model, terminal-agent, ollama, vllm, ai-agents, command-line, linux, macos, android

## Member repositories
- Hmbown/CodeWhale (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:08.383704+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:23:16.781112+00:00, confidence not recorded.
  - readme: https://github.com/Hmbown/CodeWhale (fetched 2026-08-28T04:12:08.383704+00:00, sha 6611f6aab8dc)
  - homepage: https://codewhale.net/ (fetched 2026-08-29T07:46:30.169008+00:00, sha be940973ee80)
  - site_page: https://codewhale.net/en/docs (fetched 2026-08-29T07:46:30.178623+00:00, sha aed3e55238b0)
  - site_page: https://codewhale.net/en/docs/guide (fetched 2026-08-29T07:46:30.181287+00:00, sha 318cd1cdacdf)
  - site_page: https://codewhale.net/en/install (fetched 2026-08-29T07:46:30.194847+00:00, sha 3c7c83decb1c)
  - site_page: https://codewhale.net/en/docs/vocabulary (fetched 2026-08-29T07:46:30.199867+00:00, sha c9444df335db)
  - site_page: https://codewhale.net/en/docs/fleet (fetched 2026-08-29T07:46:30.203514+00:00, sha 7846c7db47db)
  - registry_crates: https://crates.io/api/v1/crates/codewhale (fetched 2026-08-29T07:46:30.206374+00:00, sha 900dedfb3718)
  - site_page: https://codewhale.net/en/faq (fetched 2026-08-29T07:46:30.197407+00:00, sha b58e6d4d9a02)
- Data as of 2026-08-30T08:39:29.467469+00:00.