How to publish a plugin

The official repo does not take outside PRs. They treat it as a showcase and a source of ideas, not the only door for community plugins. Publish your own package and make it discoverable.

Checklist

1. Write Cordis-shaped code: export `apply(ctx)`, or provide a Service.
2. Declare `dsh.bundle` in `package.json` (and `dsh.client` when you need it). Without that field, `dsh plugin add` installs a plain dependency.
3. Put a `dsh plugin --profile web add ...` example in the README. Community checkers warn when it is missing.
4. Add the dsh-plugin topic. That is the discovery path written in the official README.
5. Do not reuse official core row ids (tools / session / llm / web / permission) unless you mean to replace the whole layer.

Minimal apply

export const name = 'hello'
export function apply(ctx) {
  console.log('hello from plugin')
}

Full tutorial: official docs/cordis-tutorial. Extension recipes: docs/cookbook.

Get listed here

Open the submit page and send the repo URL with the template. We check the topic, README install command, and license, then add the catalog row. A listing is still not a compatibility or security endorsement.