Shell tool
Runs shell commands for the agent through the approval gate and sandbox.
StableTUI: Stable
Read documentationshell_toolv0.1.0Check what Codewhale ships
Browse Codewhale commands, tools and Runtime capabilities with availability and documentation.
This catalogue covers 75 entries in source v0.10.2. Names and descriptions are in English; check your installed version.
Local code execution
Runs Python and Node with the shared execution policy and explicitly approved per-call elevation.
StableTUI: Stable
Read documentationSub-agents
Delegates bounded work to background child agents with their own budgets.
StableTUI: StableAPI: Stable
Read documentationsubagentsv0.1.0Web search
Searches and fetches the web for the agent, including DeepSeek Search (web.run, with the web_search alias).
StableTUI: Stable
Read documentationweb_searchv0.1.0apply_patch
Edits files with structured patches the user can review and undo.
StableTUI: Stable
Read documentationapply_patchv0.1.0MCP client
Connects local stdio and remote HTTP MCP servers and exposes their tools.
StableTUI: StableAPI: Stable
Read documentationmcpv0.1.0Execution policy
Decides allow, ask or deny for each tool call from layered permission rules.
StableTUI: Stable
Read documentationexec_policyv0.1.0Vision model
Routes image analysis to a separate vision-capable model configured in [vision_model].
Requires a flagTUI: Stable
Read documentationvision_modelv0.8.32verify tool
Lets the agent ask for an adversarial self-critique of its own work.
StableTUI: Stable
Read documentationverify_toolv0.9.2Code mode
execute_tools programs compose MCP, plugin and native tool calls under the normal gate.
ExperimentalTUI: Stable
Read documentationcode_modev0.10.0Extension host
Runs reviewed plugins' native TypeScript/JavaScript tool and slash-command code in a Bun or Node sidecar.
Requires a flagTUI: PreviewWEB: UnavailableAPI: Unavailable
Read documentationextension_hostv0.10.1Finance host
Routes opted-in finance tools through the bundled Native host under the existing permission and sandbox gates.
Requires a flagTUI: PreviewAPI: Preview
Read documentationfinance_hostv0.10.1Data host
Routes opted-in data validation through the bundled Native host with owned input and output bounds.
Requires a flagTUI: PreviewAPI: Preview
Read documentationdata_hostv0.10.1Speech host
Routes opted-in speech tools through the bundled Native host while Rust retains credentials and permissions.
Requires a flagTUI: PreviewAPI: Preview
Read documentationspeech_hostv0.10.1PDF host
Routes opted-in PDF extraction through the bundled Native host with the same Rust path and size guards.
Requires a flagTUI: PreviewAPI: Preview
Read documentationpdf_hostv0.10.1OCR host
Routes opted-in image OCR through the bundled Native host under existing media and permission guards.
Requires a flagTUI: PreviewAPI: Preview
Read documentationocr_hostv0.10.1GitHub host
Routes opted-in GitHub operations through the bundled Native host while Rust retains credentials and approvals.
Requires a flagTUI: PreviewAPI: Preview
Read documentationgithub_hostv0.10.1Web search host
Routes opted-in web search through the bundled Native host with the existing Rust credential and network gates.
Requires a flagTUI: PreviewAPI: Preview
Read documentationweb_search_hostv0.10.1Web extract host
Routes opted-in web extraction through the bundled Native host with owned URL and response bounds.
Requires a flagTUI: PreviewAPI: Preview
Read documentationweb_extract_hostv0.10.1Review host
Routes opted-in review tools through the bundled Native host while Rust retains route and permission authority.
Requires a flagTUI: PreviewAPI: Preview
Read documentationreview_hostv0.10.1Modes
Plan, Work and Operate modes set what the agent may do in a session; a finished plan offers to start the work.
StableTUI: StableAPI: Stable
Read documentationPermission postures
Ask, Auto-Review and Full Access postures decide when a tool call needs approval.
StableTUI: StableAPI: Stable
Read documentationCommand sandbox
Wraps commands in Seatbelt on macOS; bubblewrap on Linux is on by default once installed and verified.
StableTUI: Stable
Read documentationProviders
Provider routes with endpoint-scoped model facts, explicit limits and sourced price estimates.
StableTUI: StableAPI: Stable
Read documentationAuto model routing
Picks a model per turn under Auto; /router sets up the router.
StableTUI: Stable
Read documentationFleet
Runs and supervises groups of worker agents with receipts and a pre-spend check.
StableTUI: StableAPI: Stable
Read documentationEnvironment-aware Fleet placement
Places Fleet tasks by environment requirements and connects explicitly configured workers through Tailscale.
ExperimentalTUI: PreviewAPI: Preview
Read documentationWorkflows
Checked-in .workflow.js scripts coordinate agents step by step.
StableTUI: Stable
Read documentationAutomatic workflows
Turns a broad request into a compact Workflow plan without writing a script.
StableTUI: Stable
Read documentationGoals
/goal keeps the agent working toward one objective across turns.
StableTUI: StableAPI: Stable
Read documentationTodo list
The agent keeps a visible todo list for multi-step work.
StableTUI: StableAPI: Stable
Read documentationQueue and steer
Queue messages while a turn runs, or steer the running turn.
StableTUI: StableAPI: Stable
Read documentationReceipts
/receipts lists what a session did: files, commands, calls, approvals and failures.
StableTUI: StableAPI: Stable
Read documentationv0.10.1Request preview
/preview-request shows the redacted outbound request without sending it.
StableTUI: Stable
Read documentationread_media
Reads and preprocesses images for vision-capable models with size and privacy guards.
StableTUI: Stable
Read documentationUser memory
Opt-in local store of preferences and conventions that persists across sessions.
Requires a flagTUI: StableAPI: Stable
Read documentationSkills
Installs and loads trusted instruction packages with owned-root precedence and separate user/model invocation controls.
StableTUI: StableAPI: Stable
Read documentationPlugins
Installs, reviews and trusts plugin bundles, including the first-party marketplace.
StableTUI: StableAPI: Stable
Read documentationComputer Use
Reviewed app control with consent, fresh element targets, observation diffs and bounded named action batches.
ExperimentalTUI: PreviewAPI: Preview
Read documentationScript tools
Scripts in ~/.codewhale/tools become approval-gated tools; [tools.overrides] disables built-ins, never replaces them.
StableTUI: Stable
Read documentationClaude plugin compatibility
Loads Claude Code plugin bundles and skill folders where their features are supported.
StableTUI: Stable
Read documentationClaude settings import
/import-claude plans a reviewable import of Claude Code settings and servers.
StableTUI: Stable
Read source entryHooks
Runs user commands on session and tool events, with an execution receipt after shell tools.
StableTUI: StableAPI: Stable
Read documentationLSP diagnostics
Feeds language-server diagnostics to the agent; custom servers can be added.
StableTUI: StableAPI: Stable
Read documentationRuntime API
Local API: threads, events, approvals, project trust, workspace leases, Unix store sockets and scoped device tokens.
StableAPI: Stable
Read documentationHeadless exec
codewhale exec runs one headless turn from a script and streams JSON.
StableTUI: Stable
Read documentationGitHub PR review
codewhale review --pr N writes an advisory review; posting to GitHub is opt-in.
StableTUI: Stable
Read documentationLocal browser client
codewhale web opens the embedded browser client on 127.0.0.1 over the Runtime API.
StableWEB: Stable
Read documentationKeybindings
Terminal key bindings, documented from the keybinding catalog.
StableTUI: Stable
Read documentationSettings
/config and codewhale config edit settings declared once in the settings schema.
StableTUI: StableAPI: Stable
Read documentationWhat's new after an update
Says once, on the first start after an update, what changed and links that version's release notes.
StableTUI: StableUnreleased v0.10.2
Read documentationThemes
/theme picks a built-in theme; user themes follow a JSON schema.
StableTUI: Stable
Read documentationChat color
/color gives one chat's composer box its own color, kept with that session.
StableTUI: StableUnreleased v0.10.2
Read documentationLocalization
Interface text in 15 locales.
StableTUI: Stable
Read documentationVoice input
/voice, /voicecontrol and /voicesend use the selected ASR backend without switching providers.
StableTUI: StableAPI: Stable
Read source entryPet
Shared whale activity and reply views; desktop and app-server turns can follow an idle existing companion.
StableTUI: StableAPI: Partial
Read documentationHome dashboard
/overview shows the home dashboard.
StableTUI: Stable
Read documentationAccount login
/login signs in to an optional Codewhale account; plugin providers connect with /connect.
StableTUI: Stable
Read source entryAccount computer files
Save computer files as account versions, restore with revision checks, and download verified bytes.
ExperimentalTUI: PreviewUnreleased v0.10.2
Read source entryContext anchors
/anchor pins a fact that survives compaction.
StableTUI: Stable
Read source entryPin window
/pin keeps the terminal window on top.
StableTUI: Stable
Read source entryStructured copy
/structcopy copies one session object as redacted JSON.
StableTUI: Stable
Read source entryLive thinking
/verbose toggles live model thinking in the transcript.
StableTUI: Stable
Read source entryWorkbar
/workbar places the tasks, agents and context bar on any edge or hides it.
StableTUI: Stable
Read source entryTerminal dock
/workbar terminal shows workspace PTYs with live output, human input, session selection and a fresh shell; macOS/Linux.
StableTUI: StableUnreleased v0.10.2
Read source entryTelemetry
Anonymous aggregate usage counts, disclosed at first launch, with a saved off switch.
StableTUI: Stable
Read documentationDocker image
Runs Codewhale in a container, with an opt-in toolbox image.
StableTUI: Stable
Read documentationAndroid (Termux)
arm64 release archive for Termux on Android.
ExperimentalTUI: Preview
Read documentationSign in with ChatGPT
Uses official OAuth and the selected account catalog for eligible ChatGPT plan requests in the local OSS app.
ExperimentalTUI: PreviewAPI: PartialWEB: Unavailable
Read documentationv0.10.1Sign in with Claude
Adds Claude subscription sign-in and native Messages routing. Live provider acceptance remains unverified.
ExperimentalTUI: PreviewAPI: PartialWEB: UnavailableUnreleased v0.10.2
Read documentationReviewed plugin OAuth providers
Reviewed plugins sign in with /connect <id> and out with /disconnect; the host owns PKCE, models and approvals.
ExperimentalTUI: PreviewAPI: PartialWEB: Unavailable
Read documentationv0.10.1Sign in with OrcaRouter
OrcaRouter provider: sk-orca- API key or OAuth 2.0 + PKCE sign-in, plus a live chat model catalog.
ExperimentalTUI: PreviewAPI: UnavailableWEB: Unavailable
Read documentationv0.10.1Merch interest list
The community website collects private merch opt-ins, material preferences and optional item-price feedback.
ExperimentalTUI: UnavailableWEB: UnavailableAPI: Unavailable
Read documentationvunreleasedProfile constitution
Account preferences are captured per turn and previewed by the Engine.
ExperimentalTUI: PreviewAPI: Preview
Read documentationv0.10.1Plugin shell installation
codewhale install uses the reviewed bundle installer with local, GitHub and version-pinned npm sources.
ExperimentalTUI: PreviewUnreleased v0.10.2
Read documentation