Examples And Recipes

Use this page when you want to see what plugin-kit-ai looks like in real repositories instead of only reading abstract guidance.

1. Production Plugin Examples

These are the clearest examples of finished public shapes:

• codex-basic-prod: Codex runtime production repo
• claude-basic-prod: Claude production repo
• codex-package-prod: Codex package target
• gemini-extension-package: Gemini extension packaging target
• cursor-basic: Cursor workspace-config target
• opencode-basic: OpenCode workspace-config target

Read these when you want:

• a concrete repo layout
• real generated outputs
• a truthful public example of what “healthy” looks like

Important: these examples show distinct public product shapes. They do not imply that a real system must be split into a separate repo for every target.

2. Starter Repos

Use starter repos when you want to begin from a known-good baseline instead of from an empty directory.

They are best for:

• first-time setup
• team onboarding
• choosing between Go, Python, Node, Claude, and Codex starting points

If you are still choosing, pair this with Choose A Starter Repo.

3. Local Runtime References

The examples/local area shows Python and Node runtime references for repos that stay local-first.

These are useful when:

• you want to understand the interpreted runtime story more deeply
• you want to compare JavaScript, TypeScript, and Python local-runtime setups
• you need a concrete reference beyond the starter repos

4. Skill Examples

The examples/skills area shows supporting skill examples and helper integrations.

These are not the main entrypoint for most plugin authors, but they are valuable when:

• you want to wire docs, review, or formatting helpers into the broader workflow
• you want to understand how adjacent skills can fit around plugin repos

Suggested Reading By Goal

• Want the strongest runtime example: start with the Codex or Claude production example, then read Build A Team-Ready Plugin.
• Want packaging or workspace-config examples: start with Codex package, Gemini, Cursor, or OpenCode examples, then read Package And Workspace Targets.
• Want a clean starting point, not a finished example: go to Starter Templates.
• Want to choose the target before looking at repos: read Choose A Target.
• Want the full one-repo expansion story first: read What You Can Build.

Final Rule

Examples should clarify the public contract, not replace it.

Use example repos to see shape and healthy outputs. For the one-repo multi-target mental model, read One Project, Multiple Targets.