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.

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

Total release size: 2.6 MB

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

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

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

Download URL polydeukes_claude_code-0.23.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
7dbccb81257b39d1256ea1e50c65db066313f2c35c73b8eadb1690f0c45fcb23
BLAKE2b-256 checksum
How to use checksums
e346e0f21fa01a14e898c77b51491864df98abc23f4e889e93f6bc7db4c7b5f1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

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

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

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