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.
Choose Homebrew, crates.io, npm, or PyPI in the installation guide. The documentation home connects installation with the next steps.
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
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
initrunspdks init, registersPreToolUse,PostToolUse, andSessionEndin.codex/hooks.json, and adds.codex/hooks.jsonand.codex/config.tomltoprotectedPaths.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.
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.25.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| polydeukes_codex-0.25.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl | Python 3 | none | Linux musl 1.1+ x86-64, Linux glibc 2.17+ x86-64 | Details for polydeukes_codex-0.25.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl |
| polydeukes_codex-0.25.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.25.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl |
| polydeukes_codex-0.25.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details for polydeukes_codex-0.25.0-py3-none-macosx_11_0_arm64.whl |
Total release size: 2.6 MB
Release files / polydeukes_codex-0.25.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
| Download URL | polydeukes_codex-0.25.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl |
|---|---|
| Size | 928.0 kB |
| Tags | Linux glibc 2.17+ x86-64 Linux musl 1.1+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
03e0d4460e5aaea644bbc37c526864e49211b9c5a83c09e3b3ac492cae38031b
|
|
BLAKE2b-256 checksum How to use checksums |
56f550da6a57ea686003fa67eaac56adeb5c2ffc57a68c33f0c5b33fb9fc154f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logRelease files / polydeukes_codex-0.25.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
| Download URL | polydeukes_codex-0.25.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl |
|---|---|
| Size | 885.7 kB |
| Tags | Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
f9913c4702bc21a8941603247a1a2b9286349d77bbe359eaa0844f4cc4001c2b
|
|
BLAKE2b-256 checksum How to use checksums |
8c5e1d48ef9a556c3b957a0adf3539029a94eca9bdda5f9f72f4f21148e5f231
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logRelease files / polydeukes_codex-0.25.0-py3-none-macosx_11_0_arm64.whl
| Download URL | polydeukes_codex-0.25.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 776.7 kB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
13f76d5945c9d01349dc648938367c7d8a0c72ef673f6e9ac22ee28d15d73331
|
|
BLAKE2b-256 checksum How to use checksums |
8a6760840aecd5dafa45038ed2aaecd3a5aa840ab4a4053d80333ebd4e5d5654
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logSecurity for polydeukes-codex 0.25.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.
Full provenance
All 3 files in this release have been uploaded with provenance metadata.
Attestation for polydeukes_codex-0.25.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logA 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.