# Develop plugins

Canonical: https://hypaware.ai/docs/cli-reference/develop-plugins

```text
hyp dev <subcommand> [args...]
```

Use `hyp dev --help` and `hyp dev plugin --help` to list developer commands:

```sh
hyp dev --help
hyp dev plugin --help
```

## `hyp dev plugin new`

```text
hyp dev plugin new <name> [--kind source|sink|dataset] [--dir <path>]
```

Creates a source, sink, or dataset plugin scaffold. It refuses to overwrite an
existing target.

```sh
hyp dev plugin new @example/hypaware-plugin-widget --kind source --dir ./plugins
```

## `hyp dev plugin doctor`

```text
hyp dev plugin doctor [dir] [--json]
```

Aggregates static manifest and entrypoint checks, then imports and activates
the plugin in an isolated state directory. This is a dry-run for state paths,
not a security sandbox. Run it only on code you trust. Warnings can return `0`;
errors return `1`.

```sh
hyp dev plugin doctor ./plugins/hypaware-plugin-widget --json
```