# hmbown/codewhale

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/hmbown-codewhale).**

38,468 stars · 3,309 forks · Rust · MIT

## Links

- GitHub: https://github.com/Hmbown/CodeWhale
- Homepage: https://codewhale.net/
- awesome-repositories: https://awesome-repositories.com/repository/hmbown-codewhale.md

## Topics

`cli` `deepseek` `llm` `rust` `terminal` `tui`

## Description

CodeWhale is an AI coding agent orchestrator and development harness designed to coordinate autonomous agents that read, edit, and verify code. It provides a secure environment for AI agents to perform multi-step software engineering tasks, utilizing a sandboxed execution model to isolate shell commands and protect the host system.

The system distinguishes itself by spawning multiple independent agents in parallel to handle separate investigation or implementation slices simultaneously. It employs a multi-model gateway to route requests across various cloud APIs and local servers, and utilizes a hierarchical instruction system to resolve conflicts between global laws, project invariants, and user requests.

The platform covers a broad range of automation capabilities, including autonomous goal execution, reusable workflow loading, and session persistence to resume long-running tasks. It also supports snapshot-based state rollbacks to restore codebases without altering git history and integrates with external protocols to share tool definitions across different AI environments.

The project includes a command line interface for executing autonomous workflows in a headless mode.

## Tags

### Artificial Intelligence & ML

- [AI Agent Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/coordination-and-routing/ai-agent-orchestrators.md) — Provides a system to organize and coordinate specialized AI agents to read, edit, and verify code through multi-step tasks. ([source](https://github.com/hmbown/codewhale#readme))
- [Concurrent Agent Execution](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/orchestration-engines/ai-agent/multi-agent-coordination-systems/concurrent-agent-execution.md) — Implements mechanisms for running multiple independent agents in parallel to handle separate implementation slices simultaneously. ([source](https://github.com/hmbown/codewhale#readme))
- [Agent Harnesses](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-capabilities-skills-tooling/agent-harnesses.md) — Provides a structured development harness for creating and managing autonomous agents that modify code. ([source](https://github.com/hmbown/codewhale#readme))
- [Autonomous Coding Agents](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-coding-assistants/autonomous-coding-agents.md) — Builds and manages AI agents that autonomously decompose complex coding tasks into actionable steps within a terminal.
- [AI Execution Sandboxes](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-execution-sandboxes.md) — Isolates shell commands and tool calls from AI agents using OS-level sandboxing to protect the host system. ([source](https://github.com/hmbown/codewhale#readme))
- [Hierarchical Instruction Resolvers](https://awesome-repositories.com/f/artificial-intelligence-ml/instructional-prompting/hierarchical-instruction-resolvers.md) — Resolves priority conflicts between global laws, project invariants, and user requests using a hierarchical instruction system.
- [Multi-step Goal Execution](https://awesome-repositories.com/f/artificial-intelligence-ml/multi-step-goal-execution.md) — Pursues defined objectives across multiple turns of reading, editing, and verifying until a complex task is completed. ([source](https://github.com/hmbown/codewhale#readme))
- [Parallel AI Workflows](https://awesome-repositories.com/f/artificial-intelligence-ml/parallel-ai-workflows.md) — Enables the simultaneous execution of multiple independent AI agents to handle separate implementation slices of a project.
- [Agent State Persistence](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-state-persistence.md) — Persists the execution state of autonomous agents to ensure continuity across system restarts or sleep. ([source](https://github.com/hmbown/codewhale#readme))
- [Model Context Protocol](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/model-context-protocol.md) — Integrates with the Model Context Protocol to share tool definitions and execution capabilities across different AI environments. ([source](https://github.com/hmbown/codewhale#readme))
- [AI Agent Tool Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-agent-integrations/ai-agent-tool-integrations.md) — Connects AI models to external protocol servers to share and execute specialized tool definitions.
- [Model Request Routing](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-model-clients/model-request-routing.md) — Routes requests across diverse AI backends, including hosted cloud APIs and local runtime servers, for flexible model access. ([source](https://github.com/hmbown/codewhale#readme))
- [AI Tooling Protocols](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-tooling-protocols.md) — Interfaces with external protocol servers to synchronize tool definitions and capabilities across AI environments.
- [LLM Gateways](https://awesome-repositories.com/f/artificial-intelligence-ml/llm-gateways.md) — Acts as a centralized interface for aggregating and routing requests to multiple cloud and local LLM providers.
- [Multi-Model AI Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/multi-model-ai-orchestrators.md) — Provides a gateway to route requests across diverse cloud APIs and local AI model providers.

### Development Tools & Productivity

- [Agent Sandboxes](https://awesome-repositories.com/f/development-tools-productivity/agent-sandboxes.md) — Ships a secure execution environment with OS-level isolation for AI agents to run shell commands and modify files.
- [Agentic Task Orchestration](https://awesome-repositories.com/f/development-tools-productivity/task-automation-tools/agentic-task-orchestration.md) — Implements autonomous agent workflows for planning, tool invocation, and iterative execution of complex coding tasks.
- [AI Task Runners](https://awesome-repositories.com/f/development-tools-productivity/command-line-task-runners/ai-task-runners.md) — Provides a command line interface for executing autonomous AI workflows and tool calls within a sandboxed environment.

### Security & Cryptography

- [Isolated Execution Sandboxes](https://awesome-repositories.com/f/security-cryptography/application-and-system-security/sandbox-and-isolation/isolated-execution-sandboxes.md) — Provides an isolated execution sandbox for shell commands to protect the host system and control access.
- [Agentic Session Persistence](https://awesome-repositories.com/f/security-cryptography/identity-access-management/session-management/stateful-session-persistence/agentic-session-persistence.md) — Saves agent contexts and tool call sequences to disk to enable resuming long-running tasks after restarts.

### Data & Databases

- [Development State Snapshots](https://awesome-repositories.com/f/data-databases/data-snapshotting/viewport-snapshots/development-state-snapshots.md) — Captures temporary project snapshots to restore the codebase to a previous turn without altering git history.

### Operating Systems & Systems Programming

- [Agent Action Rollbacks](https://awesome-repositories.com/f/operating-systems-systems-programming/system-administration-maintenance/system-administration-utilities/system-modification-frameworks/modification-rollbacks/agent-action-rollbacks.md) — Restores the project state to a prior turn using snapshots to revert changes made by autonomous agents. ([source](https://github.com/hmbown/codewhale#readme))

### System Administration & Monitoring

- [Agent Execution Modes](https://awesome-repositories.com/f/system-administration-monitoring/operational-task-automation/agent-execution-modes.md) — Offers a command line interface to execute autonomous AI workflows in a non-interactive headless mode. ([source](https://github.com/hmbown/codewhale#readme))