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

Total release size: 2.6 MB

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

Download URL polydeukes_claude_code-0.26.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
Size 947.9 kB
Tags Linux glibc 2.17+ x86-64 Linux musl 1.1+ x86-64 Python 3
SHA-256 checksum
How to use checksums
a316b9f2e62508bab63d82dc4c9823858c988ce732fdfae0ce508b03323fc7c5
BLAKE2b-256 checksum
How to use checksums
277c00cf1e22dcb2a2c622eaee0c7ca338c047d667a5b945f0ac347a3a192b04
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_claude_code-0.26.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl

Download URL polydeukes_claude_code-0.26.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
30577ee0539013b624f8acca0e4c4696ea68427fb9fad8816153ce86fc0ae4a6
BLAKE2b-256 checksum
How to use checksums
d44f7abca98e1b691d3104eddf232b6eacab7d2d4d0e58bd5e90344ae6e2dc87
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_claude_code-0.26.0-py3-none-macosx_11_0_arm64.whl

Download URL polydeukes_claude_code-0.26.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
2806299765950a8185982ae19a72a95936f5ff66b9a6c5da22599e7f2f541d8e
BLAKE2b-256 checksum
How to use checksums
939e1bdc6bd6d85b518e689c4ac38dca0a255dbad27e2c00976f6f36f7e07f59
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-claude-code 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_claude_code-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