Skip to content

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-runtime when you want the strongest default runtime path
  • choose claude when Claude hooks are the real product requirement
  • choose codex-package when the product is an official Codex package
  • choose gemini when the product is a Gemini extension package
  • choose opencode or cursor when the repo should own integration/config setup

Target Directory

TargetChoose it whenLane
codex-runtimeYou want the default executable plugin pathRecommended runtime path
claudeYou need Claude hooks specificallyRecommended Claude path
codex-packageYou need Codex packaging outputRecommended package path
geminiYou are shipping a Gemini extension packageRecommended extension path
opencodeYou want repo-owned OpenCode integration setupRepo-owned integration setup
cursorYou want repo-owned Cursor integration setupRepo-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.

Public docs for plugin authors and integrators.