plugin-kit-ai-starter-codex-python-runtime-package

Copy-first starter for Python teams that want the stable codex-runtime Notify path with a pinned shared plugin-kit-ai-runtime dependency from day one.

Who It Is For

• Teams wiring a local Codex plugin into an existing repo
• Python users who want requirements.txt, a repo-local .venv, and a reusable shared helper dependency
• Users who want the stable interpreted subset, not the more self-contained Go production lane

Prerequisites

• plugin-kit-ai installed
• Python 3.10+ installed on the machine that will run the plugin
• Codex local runtime lane

Runtime

• Platform: codex-runtime
• Runtime: python
• Entrypoint: ./bin/plugin-kit-ai-starter-codex-python-runtime-package
• Execution mode: launcher
• Status: public-stable, repo-local interpreted subset

First Run

plugin-kit-ai doctor .
plugin-kit-ai bootstrap .
plugin-kit-ai validate . --platform codex-runtime --strict

This starter keeps one canonical Python env story:

• requirements.txt pinned to plugin-kit-ai-runtime==1.0.6
• repo-local .venv
• src/main.py importing plugin_kit_ai_runtime

This starter begins on the shared package path directly instead of vendoring src/plugin_runtime.py.

plugin-kit-ai bootstrap . creates .venv when needed and installs requirements.txt. If you prefer uv, poetry, or pipenv, keep using the stable runtime lane, but this starter stays opinionated on requirements.txt plus .venv. If you want downstream users to avoid installing Python at all, prefer the Go starter instead.

Local Smoke

./bin/plugin-kit-ai-starter-codex-python-runtime-package notify '{"client":"codex-tui"}'

Stable Default

• Notify

Treat plugin-kit-ai validate --strict as the CI-grade readiness gate for this runtime lane. This starter is for repo-local integration, not the official packaged Codex bundle lane.

Target Files

• src/launcher.yaml: runtime and entrypoint for local Notify integration
• src/targets/codex-runtime/package.yaml: authored Codex runtime metadata
• .codex/config.toml: generated managed Codex config
• requirements.txt: pinned shared-helper dependency manifest
• src/main.py: runtime entry importing plugin_kit_ai_runtime

Ship It

This starter already includes .github/workflows/bundle-release.yml.

plugin-kit-ai doctor .
plugin-kit-ai bootstrap .
plugin-kit-ai validate . --platform codex-runtime --strict
plugin-kit-ai bundle publish . --platform codex-runtime --repo owner/repo --tag v1.0.0
plugin-kit-ai bundle fetch owner/repo --tag v1.0.0 --platform codex-runtime --runtime python --dest ./handoff-plugin