Add to Codewhale with plugins
A plugin bundle can carry skills, commands, agent profiles, hooks and MCP connectors. You install it, review what it asks for, trust it and enable it, and nothing in it runs before that. A skill, a connector or a hook can also be added on its own with /skill install, /mcp add or /hooks add.
What a plugin can add
Skills
Markdown instructions for a task, loaded when they apply.
Commands
Slash commands that start a workflow.
Agent profiles
Named roles for sub-agents, such as a read-only reviewer.
Hooks
Commands that run on session events.
MCP connectors
Servers that give the agent tools in other apps.
The idea comes from DeepSeek Harness, whose README describes an everything-is-a-plugin architecture. Codewhale adopts it inside one Engine that keeps turns, sessions, approvals and receipts, so a plugin adds capabilities without adding a second runtime.
Reviewed DeepSeek Harness plugins can run in the experimental extension host. /plugin import dsh previews a bundle, then installs it disabled and untrusted. Services Codewhale owns, such as turns, sessions, approvals and credentials, are refused by name. Update and rollback are not verified, and none of this is a release qualification.
DeepSeek Harness compatibility notes (current source, ahead of the release)Coming in 0.10.3, not in the current release
These are planned for 0.10.3. They are not in the version you can install today, and the plan can change before the release. The rest of this page describes the released version.
One Plugins place
Everything you add is listed in one Plugins place. Each row says what it adds (Skill, Connector, Hook or Command), where it came from and whether it is on. /skills, /mcp and /hooks keep working and open that place on their own filter.
Standard mode and Creator mode
You choose a mode for each conversation. In Creator mode the agent can write a plugin for you. A Standard conversation can install or remove a plugin, and the permission mode decides whether it asks you first.
Your permission mode decides what turns on
Turning on a plugin the agent wrote is treated like any other action: Ask asks you, Auto-Review's reviewer model judges it, Plan refuses it, and in Full Access the agent may turn it on. Codewhale records that the agent did it and shows it wherever plugins are listed. Until you review it once, that plugin works only in its own project.
Permissions
The control that holds Plan and Work and the permission dial is renamed Permissions, with Plan still on it. The new Mode menu holds Standard and Creator.
Connectors: the apps you already use
An MCP server is how Codewhale reaches an app. Add one directly, or install a plugin that carries it.
- GitHubToken
- LinearOAuth
- NotionOAuth
- StripeOAuth
- SupabaseOAuth
- SentryOAuth
- FigmaOAuth
- AtlassianOAuth
- CanvaOAuth
- PostHogOAuth
- Hugging FaceNo sign-in
- Context7No sign-in
- +26 more in the catalog
codewhale mcp add notion --url https://mcp.notion.com/mcp codewhale mcp login notion
Add a connector directly to use OAuth; a connector bundled in a plugin can only read a token from your environment. Either way, run one read-only tool after connecting to confirm it works.
Gmail and Google Calendar have no connector here. The skills-google plugin adds workflows that use a Gmail or Calendar tool you have connected.
MCP setup, authentication and troubleshootingPlugins from the catalog
Browsing the catalog runs nothing. The terminal ships an offline snapshot, so the entries and versions you see depend on your release.
- Computer Use v0.16.1 · macOS betaLet an agent work in Mac apps while you keep using your computer. Setup and limits are on the Computer Use page.
- Codewhale for Chrome v0.4.0Work in signed-in Chrome, one granted site at a time. Needs Node and the separate browser extension.
- Google skills v0.1.0Gmail and Calendar workflows through a tool you connect or your own OAuth client. Connects no account by itself.
- GitHub Workflow v0.1.0Review pull requests and triage issues through GitHub’s remote MCP. Needs your GitHub token; nothing posts without your approval.
- Linear Workflow v0.1.0Triage issues, claim work and post status updates through Linear’s remote MCP. Needs your Linear API key.
- Cloudflare v0.1.0Build and test Workers, and deploy with cf only after you approve.
- Vercel Workflow v0.1.0Preview and production deploys only after you approve, plus environment variables and logs.
- Office v0.1.0Make PowerPoint, Excel and Word files, and analyze CSV data, with Node alone.
- Review Toolkit v0.1.0Six read-only specialist reviewers and a /review-pr command that fans them out over your diff.
- WhaleWiki v0.2.0Understand a repository, find where to change it and see which docs depend on a file. Needs Node.
Installed disabled and untrusted
Every plugin installs disabled and untrusted. You review what it asks for, trust it, then enable it.
- Install
/plugin installLands disabled and untrusted. - Review
/plugin show <name>Shows the manifest and the capabilities it declares. - Trust
/plugin trust <name>Prints the confirmation command to run. - Enable
/plugin enable <name>Activates the bundle.
The confirmation command carries two full hashes, one for the plugin’s bytes and one for its declared capabilities, so an update with changed bytes needs review again. Catalog provenance alone grants no permission.
Install from any of these sources:
/plugin install github:owner/repo /plugin install ./path/to/bundle /plugin install https://example.com/x.tar.gz /plugin install npm:@example/plugin@1.0.0
Command reference and formats
Commands
/plugin marketplace list /plugin marketplace show codewhale /plugin marketplace install codewhale <name> /plugin install github:owner/repo /plugin show <name> /plugin trust <name> /plugin trust <name> <full-content-sha256>.<full-capability-sha256> /plugin enable <name> /plugin update <name> /plugin suggest <task>
Plugin formats
- Codewhale / Agent Plugins v1
- Declarative skills, commands, agent profiles, hooks, MCP and provider declarations. Native TypeScript extensions are experimental and require extension_host.
- Plugin bundles from other agents
- Compatible skills, commands, agent profiles and MCP declarations in .claude-plugin bundles can be imported. Hooks, LSP declarations and custom MCP paths are rejected.
- DeepSeek Harness (DSH)
- Experimental. Import previews a bundle and installs it disabled and untrusted; services Codewhale owns are refused by name.
Share a plugin
Package a workflow, document its dependencies and show what you verified. The authoring guide covers a local bundle; the catalog repository is where you propose an entry.