Plugin SDK
Author, validate, test, and publish CELLAS plugins.
Overview
Plugin authors extend CELLAS capabilities under a stable contract. This page summarizes the author guide; the monorepo remains canonical.
Canonical source: docs/developer/plugin-author-guide.md.
Concepts
| Command | Purpose |
|---|---|
cellas plugin init | Create the canonical Plugin package skeleton |
cellas plugin validate | Validate manifest, package layout, and integrity |
cellas plugin test | Run plugin, integration, compatibility, or all suites |
cellas plugin package | Build, test, and produce a signed distributable |
cellas plugin verify | Verify a published package against registry metadata |
cellas plugin publish | Publish a verified package to the registry |
cellas plugin doctor | Check toolchain, registry, and environment readiness |
SDK behavior lives under packages/sdk/*. @cellas/plugin-sdk is a compatibility entrypoint—prefer specific SDK packages for your capability type.
Example: starter project
pnpm create cellas my-plugin --template plugin --yes
cd my-plugin
pnpm exec cellas verify
pnpm exec cellas certifyExample: monorepo author commands
Prerequisites: Node.js ^22.13.0 || >=24.0.0, pnpm run build:workspace.
pnpm exec cellas plugin init my-analyzer \
--component-id my-analyzer \
--capability-type analyzer \
--capability-subtype seo
pnpm exec cellas plugin validate
pnpm exec cellas plugin test --suite pluginCLI
pnpm exec cellas plugin --helpRelated pages
Reference plugins: plugins/reference-* in the repository.