codex-plugins-kit

Codex adapters for selected capabilities from plugins-kit.

This repository is under initial development. Its adapters depend on canonical implementations maintained in plugins-kit; it does not aim to port every Claude Code plugin or duplicate their implementation.

Shared runtime

The adapters use one managed Python 3.12 virtual environment at:

~/.codex/.local-data/codex-plugins-kit/.venv

Every upstream package is installed editable. Setup automatically uses a sibling ../plugins-kit checkout when available. Otherwise, it clones the immutable revision in upstream.lock.json into managed local data and installs that checkout editable.

Setup also registers this repository as the codex-plugins-kit marketplace and installs the selected Codex plugins. Pass --skip-codex-install when testing only the Python runtime.

On macOS or Linux:

./scripts/setup
./scripts/doctor

On Windows PowerShell:

./scripts/setup.ps1
./scripts/doctor.ps1

Choose one plugin or an explicit source checkout when needed:

./scripts/setup --plugin llm-scripting-kit
./scripts/setup --plugins-kit /path/to/plugins-kit

uv, Git, and a Python 3 interpreter capable of launching the setup manager are required. uv provisions the managed Python 3.12 runtime.

uninstall removes only the managed virtual environment, managed source clone, and runtime record. It preserves credentials and user configuration.

Initial adapters

• llm-scripting-kit: endpoint and harness delegation through the canonical upstream library.
• awesome-kit: Codex-native orchestration plus the canonical interoperable task system.

orchestrate prefers native Codex background agents and can route bounded work to every HTTP or CLI harness configured through llm-scripting-kit. task exposes all canonical task verbs while preserving the existing task files and CLAUDE.md hand-off contract.

MCP is intentionally out of scope.