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.

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
  • 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.

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.26.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.26.0
File Interpreter ABI Platform Actions
polydeukes_codex-0.26.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.26.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
polydeukes_codex-0.26.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64, Linux musl 1.1+ ARM64 Details for polydeukes_codex-0.26.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
polydeukes_codex-0.26.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for polydeukes_codex-0.26.0-py3-none-macosx_11_0_arm64.whl

Total release size: 2.6 MB

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

Download URL polydeukes_codex-0.26.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
3bbd7ab8cd9bed25d4c079017786dd8ded723376e7e5ea55af959fbb205ff894
BLAKE2b-256 checksum
How to use checksums
5dd23268c1d3789d43582b1d55e1ff7b224462cdaeb4ced9fabe49241b2094f2
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 10, 2026.

Transparency log

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

Download URL polydeukes_codex-0.26.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
Size 885.5 kB
Tags Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3
SHA-256 checksum
How to use checksums
de897c1e71cc581fe0a01bcac73a63075f11ea20ddec6ecd1c9164d15a47b29a
BLAKE2b-256 checksum
How to use checksums
3557421db1436a2da3a05753ed579357bcdceb1efac397ccd3b278ee110591db
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 10, 2026.

Transparency log

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

Download URL polydeukes_codex-0.26.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
5264e63d8f3d9b78f6e3d4deda55f90583dc43e723c09fe6083bea6079012632
BLAKE2b-256 checksum
How to use checksums
34017190d7c8e5cb105d9762e3b85e18110d427b5419957d60e6e7abf41df268
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 10, 2026.

Transparency log

Security for polydeukes-codex 0.26.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.

Select from 3 files

Attestation for polydeukes_codex-0.26.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 10, 2026.

Transparency log

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