Skip to main content

pdks-claude-code

English · 한국어

The Rust host adapter connects Claude Code to the pdks covenant judge. init registers the adapter; hook translates a host event and runs pdks covenant check.

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-claude-code builds the executable from crates.io with the dependency versions the release was tested with (the Cargo.lock in the crate). cargo binstall pdks-claude-code 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-claude-code

Each GitHub Release carries pdks-claude-code-<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-claude-code

The built executable is target/release/pdks-claude-code.

Commands

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

pdks-claude-code init
  • init runs pdks init, registers PreToolUse in .claude/settings.json, and adds .claude/settings.json and .claude/settings.local.json to protectedPaths. It also writes .claude/rules/polydeukes.md and .claude/skills/discipline-draft/SKILL.md, each only if that file does not already exist.
  • 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 claude-code init and pdks claude-code 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 the proposed tool call and transcript evidence into input IR for the judge.

License

MIT. See LICENSE.

Metadata

Release files for polydeukes-claude-code 0.25.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-claude-code 0.25.0
File Interpreter ABI Platform Actions
polydeukes_claude_code-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_claude_code-0.25.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
polydeukes_claude_code-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_claude_code-0.25.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
polydeukes_claude_code-0.25.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for polydeukes_claude_code-0.25.0-py3-none-macosx_11_0_arm64.whl

Total release size: 2.6 MB

Release files / polydeukes_claude_code-0.25.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl

Download URL polydeukes_claude_code-0.25.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
Size 947.7 kB
Tags Linux glibc 2.17+ x86-64 Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum
How to use checksums
c7f4af8c42a55aa32b59b58282fc1e1c03a365151a98ef935a875dca7c01e2fa
BLAKE2b-256 checksum
How to use checksums
b41c7022e6c4bf9ef94ee64ad0ba944ded65d584a54d8d26022671881067dc02
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 log

Release files / polydeukes_claude_code-0.25.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl

Download URL polydeukes_claude_code-0.25.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
Size 900.8 kB
Tags Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3
SHA-256 checksum
How to use checksums
1f6b6749511e73161f797f613a4823767d8ebd562e9383a00a2fde0d2f3f5c28
BLAKE2b-256 checksum
How to use checksums
9ffb1dcb1781a96a0a67c177a6a363b7f78d21753a93686dd482686aab2e6885
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 log

Release files / polydeukes_claude_code-0.25.0-py3-none-macosx_11_0_arm64.whl

Download URL polydeukes_claude_code-0.25.0-py3-none-macosx_11_0_arm64.whl
Size 797.6 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
88dd7528a2918fea447f0f8f7bf3628e7007f62c77824ec64c2ded5e0c9909d6
BLAKE2b-256 checksum
How to use checksums
04de8e7671daedc710ed62fb0a57b68f1e2e8489b015c029c4fb206a63b6e594
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 log

Security for polydeukes-claude-code 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.

Select from 3 files

Attestation for polydeukes_claude_code-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 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