ReleaseLatest release v0.10.2 · 24 d’oct. del 2026These pages describe v0.10.2, the published release.Changelog →

Vocabulary

These definitions describe Codewhale's product vocabulary, with the controls of the published release first and source-only controls kept in a labelled section. The execution nouns match the public fact matrix in the repository.

Execution nouns

Fleet = the user's model inventory: who is in the roster and which member is selected

Fleet records member IDs and names, semantic roles, provider/model identities, and roster state.

Workflow = what order the work follows

What order the work follows: phases, gates, budgets, replay, and fan-in.

Lane = one running Workflow instance

One running Workflow instance and its live progress.

Runtime = where, how, and with what authority selected work executes

Runtime owns the local or remote process, provider route, project/workspace trust, filesystem, network, secrets, approvals, sandbox, tools, and API boundary.

Modes and permissions

Tab with an empty composer cycles Plan → Work → Operate, and Shift+Tab cycles the permission posture Ask → Auto-Review → Full Access. You decide what it may do without asking.

Set modes and approvals

Plan

Plan permits workspace inspection and policy-allowed research, but refuses file mutation and shell execution.

Work

Work uses tools across multiple steps under the active permissions, sandbox and repository rules.

Operate

Operate has the same tools and authority as Work, and leans toward delegating multi-part work to parallel agents and checking results before the work is called done.

Ask

The default. Codewhale asks before a command runs; saved approvals and policy rules still apply.

Auto-Review

Codewhale reviews eligible tool actions automatically and denies high-risk calls or failed reviews. It can still ask you to resolve a user choice.

Full Access

Commands can reach anything on this computer without approval prompts. Repository law and managed policy still apply.

Al codi font, encara no publicat

This section describes behavior that exists in the project's source and is not in the published release. Check which version you have with codewhale --version.

Modes and permissions in source

Plan

Plan permits workspace inspection and policy-allowed research, but refuses file mutation and shell execution.

Work

Work uses tools across multiple steps under the active permissions, sandbox and repository rules.

Ask

Codewhale asks before file edits and commands, including workspace edits; saved approvals and policy rules still apply.

Accept Edits

Ordinary edits inside a git workspace can run without a prompt; commands and sensitive-file edits still ask. In source, new installs use this posture unless a saved choice or managed policy applies.

Auto-Review

Codewhale reviews eligible tool actions automatically and denies high-risk calls or failed reviews. It can still ask you to resolve a user choice.

Full Access

Commands can reach anything on this computer without approval prompts. Repository law and managed policy still apply.

Route identity: provider · model · requested→effective reasoning · source

Provider

Who serves inference — a hosted API, a gateway, or a loopback local runtime. A configured provider is never inferred from a model name.

Model

The exact model on that provider. Codewhale treats models as selectable components; no provider or model is privileged over another.

Requested reasoning

The policy requested for the frozen route: inherit, off, low, medium, high, max, or auto. Auto permits adaptive reasoning; it never permits a silent provider or model switch.

Effective reasoning

The tier actually applied for the run when the runtime or provider can establish it. If it cannot be established, the value is unavailable — never copied from the request or invented.

Routing source

Why this configured route was selected, such as an explicit member profile or inherited session setting. Missing provenance stays unavailable rather than being guessed.

Advisory role

Advisor

The public read-only advisory fleet role. The historical consultant and oracle spellings remain compatibility aliases for saved configuration and replay only; new product surfaces say Advisor.

Measurement principles

  • Provider token and cache usage is shown locally when the provider reports it; unknown usage stays unknown and is never displayed as zero.
  • Costs, progress, capabilities, and delivery state are shown only when a source establishes them. Unavailable values remain unavailable rather than becoming zero or success.
  • This site publishes no benchmark leaderboard. Any number Codewhale ever publishes must name its exact provider, model, requested and effective reasoning, and measurement harness alongside the result.

Unavailable Benchmark leaderboard: none on this site, and none will appear without route identity and a measurement harness attached.