Plugin SDK
Plugins register commands, subscribe to lifecycle events, and contribute compatibility rules, all through a schema-validated manifest, all Ed25519-signed. 8 templates get you started.
Lifecycle
Scaffold plugin.yml, commands, hooks, and tests from one of 8 templates.
Run the plugin's own test suite in isolation before it touches your CLI.
Validate the manifest, check quality, and produce a distributable archive.
Sign the archive with your Ed25519 key and stage it to a local or shared directory.
Install from an archive; third-party keys require an explicit trust decision.
Quick start
Plugin lifecycle
Manifest
A plugin is its manifest: commands, events, dependencies, and optional compatibility rules, validated against a JSON Schema and semver-checked against the platform version.
name: my-plugin
version: 1.0.0
description: Adds a hello command
engine: ">=3.0.0"
commands:
- name: hello
script: commands/hello.js
description: Say hello from a plugin
events:
- on: install.afterInstall
script: hooks/after-install.jsQuality & signing
plugin quality grades your manifest, docs, tests, and structure before you ship.
Terminal
Your own key is auto-trusted; anyone else’s requires an explicit trust decision.
Terminal
One manifest, one template, and your workflow becomes a first-class citizen of the CLI.