ckdn · PyPI

Deterministic check runner and log digester for AI-assisted development loops

Let agents move fast.
Keep verification explicit, bounded, and machine-readable.

ckdn (short for checkdown) sits between a coding agent and your project’s verification tools. The agent never reads a 10 000-line pytest log and never decides from prose whether a run “looks green”.

Every check goes through one orchestrator that:

owns the true process exit code,
archives the full log as evidence,
emits a bounded, machine-readable digest — the only thing the agent is supposed to read.

ckdn pipeline: agent → ckdn run coverage → subprocess (owns exit code) → .agent-runs artifacts; agent reads digest.json

Text-based interpretation of tool output fails two ways: context bloat (the agent drowns in a thousand-line log) and false green (a collection error prints no FAILED lines, so a regex calls it clean). ckdn's answer is a strict status model from both the exit code and a format-aware parser: the two must agree before anything is called green. ckdn may downgrade green; it never upgrades red.

Runtime: Python ≥ 3.11, stdlib only for the core CLI (zero third-party dependencies). The optional MCP server is an extra (ckdn[mcp]).

Install

uv tool install ckdn          # global CLI
# or as a project dev dependency:
uv add --dev ckdn

Quick start

cd your-project
ckdn init                      # writes starter ckdn.toml
echo '.agent-runs/' >> .gitignore

ckdn checks                    # list configured checks
ckdn run ruff                  # one atomic check → compact digest on stdout
ckdn run lint                  # alias → members (e.g. ruff, pylint)
ckdn show                      # pretty-print latest digest

ckdn run exits with the original command’s code, so it slots into any hook or CI step where the raw command used to be — with a bounded, schema-backed digest as a side effect.

Documentation

Full documentation lives at orenlab.github.io/ckdn:

Get started — install and first check
Status model — exit code × parser → one verdict; exit-code contract
Digests & schemas — the machine-readable contract (ckdn.digest/2)
Aliases & aggregates — grouped checks and routing
Configuration — ckdn.toml, command policy, working directory
CLI — command reference
Parsers — built-ins, custom parsers, and plugins
Agents & MCP — wiring ckdn into an agent loop
Design & non-goals

License & community

Copyright (c) 2026 Den Rozhnovskiy <rozhnovskiydenis@gmail.com>
License: MIT (SPDX-License-Identifier: MIT)
Changelog: CHANGELOG.md
Security: SECURITY.md
Contributing: CONTRIBUTING.md
Code of Conduct: CODE_OF_CONDUCT.md

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ckdn-1.2.0.tar.gz (223.4 kB view details)

Uploaded Jul 21, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ckdn-1.2.0-py3-none-any.whl (71.1 kB view details)

Uploaded Jul 21, 2026 Python 3

File details

Details for the file ckdn-1.2.0.tar.gz.

File metadata

Download URL: ckdn-1.2.0.tar.gz
Upload date: Jul 21, 2026
Size: 223.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for ckdn-1.2.0.tar.gz
Algorithm	Hash digest
SHA256	`8e172018dd972a95768b767b95939e18d3fe00680b152459e0c613f6b3769cc2`
MD5	`9852b42c21ef23f806a5eb375c302001`
BLAKE2b-256	`e4aa2df123bcd648156ada7cc7164d8638434a3e96e78193321be68700e1eccc`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ckdn-1.2.0.tar.gz:

Publisher: publish.yml on orenlab/ckdn

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ckdn-1.2.0.tar.gz
- Subject digest: 8e172018dd972a95768b767b95939e18d3fe00680b152459e0c613f6b3769cc2
- Sigstore transparency entry: 2212614022
- Sigstore integration time: Jul 21, 2026
Source repository:
- Permalink: orenlab/ckdn@f9fe819231e602b5840a7054f69a595f50f294dc
- Branch / Tag: refs/tags/v1.2.0
- Owner: https://github.com/orenlab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@f9fe819231e602b5840a7054f69a595f50f294dc
- Trigger Event: release