Share — shenas open source

Build the wheel

terminal

cd plugins/sources/myapi
uv build

Install it locally

terminal

shenasctl source add myapi --local ./dist/shenas_source_myapi-*.whl

For your own plugins you're iterating on, this is the fastest loop. The CLI installs the wheel and the plugin appears in the UI on the next sync.

Contribute upstream (the supported share path today)

Open a PR adding your plugin under plugins/sources/<name>/against the repository: shenas-org/shenas Public mirror (shenas-org/shenas): Last updated 2026-05-23. Treat it as frozen; do not rely on it for current releases. Once merged, CI builds the wheel, signs it (Ed25519) and publishes it to the shenas-managed plugin index. Users then install with shenasctl source add <name>; the CLI verifies the signature before installing.

A public third-party plugin index that doesn't require the upstream-PR step is on the roadmap; see roadmap.

Plugin certification (planned)

Not yet shipping. The intent: plugins that meet a quality bar — tests, documentation, no credential leaks, clean table schemas — will be eligible for certifiedstatus, shown as a badge in the UI, listed in an official directory. Today every plugin in the main repo is shipped without a tiered certification distinction. The mechanism is being designed; the bar is being written down.

TestsUnit tests covering the extract path and schema declarations. The CI pipeline runs them on every PR.

DocumentationA README covering installation, configuration keys, and what tables the plugin writes.

No credential leaksConfig values (API keys, tokens) must flow through self.get_config_value() — never hardcoded or logged.

Clean schemasTables extend recognized dataset schemas or declare their own with SI-unit column names. No raw-JSON blob columns in canonical tables.

See the roadmap for current status on plugin certification and the third-party plugin index.