Install and use Codewhale

The installer, npm, Homebrew tap, Cargo, and release binaries, with the output each step prints.

Install, connect a model, and give Codewhale a task in your project.

Save a provider key, check which key is used, run a local model, or sign in to the optional account.

Supported providers, switching models, and local runners such as Ollama, vLLM, and SGLang.

Find the config file, change settings from the session or shell, and see what a repository may override.

Plan, Work, or Operate for the kind of work; Ask, Auto-Review, or Full Access for when it asks you.

See every edit, roll files back to an earlier turn, get a code review, and keep a review receipt.

Follow the goal, To-do list, and sub-agents in the workbar, and hand work to a fresh session.

Hand independent parts of a task to sub-agents, pick roles, and keep parallel edits in worktrees.

Save roles in a Fleet, write a repeatable Workflow, run it as a Lane, and run batches of tasks.

The OS sandbox on macOS, Linux, and Windows, how to turn it on, and how much a command may write.

What stays local, what a provider receives, what usage counting sends, and how to turn it off.

Add local (stdio) or remote (HTTP) MCP servers, sign in with OAuth, serve Codewhale over MCP, and try code mode.

Run your own scripts at session start, before a tool call, at turn end, or when Codewhale waits for you.

Install, find, trust, and load reusable instruction packages.

Find, install, review, and trust plugin bundles.

Run one-shot jobs from scripts, or drive threads, events, and approvals over the local HTTP API.

Work in a local browser tab, or continue a terminal session from the web app with /rc.

Preview: propose, confirm, and track a cloud agent that opens a pull request on GitHub, CNB, or Gitee.

Diagnose in one command, then fix install, key, network, stuck-turn, session, and MCP problems.

The contributing guide, agent ethos, contributor credits, and release process.

Fleet, Workflow, Lane, and Runtime; Plan, Work, and Operate — each in one sentence.

What the agent treats as law: built-in rules, your personal constitution, and a repository's own.

The small set of tools every session starts with, and how Codewhale finds the rest.