Contributing

Contributions are welcome — bug reports, feature requests, documentation, and pull requests. The plugin is source-available and free to use; see LICENSE for what that means.

The contribution grant

By submitting a contribution, you agree to the contribution terms in section 3 ("Contributions") of the LICENSE: you grant hviana an irrevocable, worldwide, royalty-free licence to use, modify, publish, distribute, and commercially exploit your contribution, including under a different licence.

That grant is what keeps the project honest: the source stays readable and the software stays free to use, while the author can still license it commercially where that matters. If your contribution is made in the course of your employment, you confirm that your employer consents to it.

Before you open a pull request

• The full gate is pnpm run check — typecheck, lint, test, build, and verify the published artifacts.
• Nothing in the suite reaches the internet, and no test needs a real Claude Code or Codex install. The seams the tests inject live in tests/support/ — a fake process port, in-memory files, and scripted advisor and human.
• When a vendor ships a new model, add it to src/domain/models.ts — one entry per id, with its aliases and a one-line summary. Every surface reads that one catalog: the tool instructions, /cli models, and the unknown-name warnings. Deployments extend it per delegate through the extraModels config without patching the plugin.
• A new runtime dependency changes the inlined bundles, so run pnpm run notices and commit the regenerated THIRD-PARTY-NOTICES.md with it.