Choose A Target
This is an advanced page. If you are still deciding what kind of repo to create, start with Choose What You Are Building first.
Use this page when you already know you want plugin-kit-ai, but you still need to match the repo to how you want to ship the plugin.
Choosing a target means choosing the main path the product needs today, not locking the repo forever.
Short Rule
- choose
codex-runtimewhen you want the strongest default runtime path - choose
claudewhen Claude hooks are the real product requirement - choose
codex-packagewhen the product is an official Codex package - choose
geminiwhen the product is a Gemini extension package - choose
opencodeorcursorwhen the repo should own integration/config setup
Target Directory
| Target | Choose it when | Lane |
|---|---|---|
codex-runtime | You want the default executable plugin path | Recommended runtime path |
claude | You need Claude hooks specifically | Recommended Claude path |
codex-package | You need Codex packaging output | Recommended package path |
gemini | You are shipping a Gemini extension package | Recommended extension path |
opencode | You want repo-owned OpenCode integration setup | Repo-owned integration setup |
cursor | You want repo-owned Cursor integration setup | Repo-owned integration setup |
Safe Default
If you are unsure, start with codex-runtime and the default Go path.
That gives you the cleanest production starting point before you choose a narrower or more specialized path.
When you later move to codex-package, the official package lane follows the official .codex-plugin/plugin.json bundle layout.
If you intentionally start on supported Node/TypeScript or Python, that changes the language choice, not the need to decide every packaging or integration detail on day one.
What To Do When You Need More Than One Target
- choose the main path that defines the product today
- keep the repo unified
- add more targets only when a real delivery or integration requirement appears
Read One Project, Multiple Targets when you want the broader multi-target mental model.