Skip to main content

pdks-codex

English · 한국어

The Rust host adapter connects Codex to the pdks covenant judge. init registers the adapter; hook judges proposed calls and records the session’s tool-call history.

Install

cargo install --locked pdks-codex builds the executable from crates.io with the dependency versions the release was tested with (the Cargo.lock in the crate). cargo binstall pdks-codex downloads the Release archive described below for aarch64-apple-darwin, x86_64-unknown-linux-musl and aarch64-unknown-linux-musl, and falls back to a source build on other targets.

cargo install --locked pdks-codex
cargo binstall pdks-codex

Each GitHub Release carries pdks-codex-<target>-v<version>.tar.gz for aarch64-apple-darwin, x86_64-unknown-linux-musl and aarch64-unknown-linux-musl. Each archive holds one directory with the same name, containing the executable and LICENSE. Extract it and place the executable on PATH.

Or clone the repository and build from its root:

cargo build --release -p pdks-codex

The built executable is target/release/pdks-codex.

Commands

Place both pdks-codex and pdks on PATH, then run init from the project root:

pdks-codex init
  • init runs pdks init, registers PreToolUse, PostToolUse, and SessionEnd in .codex/hooks.json, and adds .codex/hooks.json and .codex/config.toml to protectedPaths.
  • hook --project-root <absolute-path> --pdks <absolute-path> reads the host event on stdin. Both paths must be absolute and the flags must appear in this order.

The same commands are available as pdks codex init and pdks codex hook .... For the shared scaffold, see pdks init. The session connection guide describes host setup; its umbrella adapter commands use a different registration format.

Registration

Registrations pin the absolute project root, adapter executable, and pdks path found on PATH. They carry neither onFailure nor || exit 2. If the adapter cannot start, the host lets the call proceed without a message. If the adapter starts but cannot start the judge, it lets the call proceed with an instruction to install pdks.

hook translates apply_patch and Bash calls. PostToolUse records tool-call history in .polydeukes/codex-sessions/; SessionEnd removes it. Approve changed definitions through Codex /hooks. Current prompts do not supply human evidence.

License

MIT. See LICENSE.

Metadata

Release files for polydeukes-codex 0.23.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for polydeukes-codex 0.23.0
File Interpreter ABI Platform Actions
polydeukes_codex-0.23.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64, Linux musl 1.1+ x86-64 Details for polydeukes_codex-0.23.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
polydeukes_codex-0.23.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl Python 3 none Linux musl 1.1+ ARM64, Linux glibc 2.17+ ARM64 Details for polydeukes_codex-0.23.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
polydeukes_codex-0.23.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for polydeukes_codex-0.23.0-py3-none-macosx_11_0_arm64.whl

Total release size: 2.6 MB

Release files / polydeukes_codex-0.23.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl

Download URL polydeukes_codex-0.23.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
Size 928.3 kB
Tags Linux glibc 2.17+ x86-64 Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum
How to use checksums
db7df32cef924d0d993613f461c85a901240d9821501248eae83abf96ee529c4
BLAKE2b-256 checksum
How to use checksums
4a52cb6bd20b73bdbb8e51fec2de76f11ac8d9ed53d72eb29f8f84ae3493207f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Release files / polydeukes_codex-0.23.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl

Download URL polydeukes_codex-0.23.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
Size 885.6 kB
Tags Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3
SHA-256 checksum
How to use checksums
c3127f3418f2402b09a8af9e7e14f4ed2cc5922cf3bce40140c43a57bdc3e0bb
BLAKE2b-256 checksum
How to use checksums
ac2b0a9a4f7b3a1c0d1e1a9f9830677882d75560b9219275cd8cbcada188eedf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Release files / polydeukes_codex-0.23.0-py3-none-macosx_11_0_arm64.whl

Download URL polydeukes_codex-0.23.0-py3-none-macosx_11_0_arm64.whl
Size 776.6 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
f67c88126d52c7a756eb01f4eba7fede00c193aae8d1527192932d0577a3cd9d
BLAKE2b-256 checksum
How to use checksums
820cde5b8e7461463031769d41cbe6d326289abc2b49f0286bb3a2bb4531b424
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Security for polydeukes-codex 0.23.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page