XRefKit

XRefKit is a framework for making AI-assisted work repeatable, reviewable, and handoff-ready.

It helps teams turn domain procedures and knowledge into work that can be performed with explicit evidence, human judgment, and completion checks.

Why XRefKit?

Using AI for real work creates recurring operating problems:

Why XRefKit is needed

the AI can act from incomplete context or unsupported guesses
procedures, domain facts, and judgment criteria get mixed together in prompts
execution, checking, and handoff collapse into one opaque step
work becomes hard to continue across agents, humans, or sessions
outputs may lack evidence, closure discipline, or auditability

XRefKit provides a repository and runtime model for addressing these problems.

What it provides

Skills — reusable procedures for a defined kind of work
Knowledge — source-backed domain facts and local rules
Workflow protocol — recorded progress, deterministic verification, and closure checks
Evidence and handoffs — outputs, judgments, concerns, and decisions that remain reviewable after the work is done
Skill Run Dashboard — inspect Skill execution status, referenced XIDs, evidence, judgments, concerns, and handoffs to improve the auditability of results
XIDs — stable references for connecting procedures, knowledge, and supporting documents

The package includes the resolver, Skill runtime, workflow controls, client tools, and an optional MCP adapter.

The Skill Run Dashboard helps people trace how a Skill run used its referenced XIDs and recorded its evidence before accepting or handing off the result.

Quick start

XRefKit requires Python 3.11 or later.

python -m pip install xrefkit
xrefkit init
xrefkit --help

For local development:

python -m pip install -e .
xrefkit init

For the optional MCP server:

python -m pip install "xrefkit[mcp]"
xrefkit mcp serve --repo . --transport stdio

Where to go next

Security

XRefKit does not require provider API keys to explore or install the package. Do not commit secrets, API keys, access tokens, .env files, or provider credentials. Authenticate external AI tools through their official provider mechanisms.

Download files

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

Source Distribution

xrefkit-0.4.12.tar.gz (287.2 kB view details)

Uploaded Aug 29, 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.

xrefkit-0.4.12-py3-none-any.whl (262.7 kB view details)

Uploaded Aug 29, 2026 Python 3

File details

Details for the file xrefkit-0.4.12.tar.gz.

File metadata

Download URL: xrefkit-0.4.12.tar.gz
Upload date: Aug 29, 2026
Size: 287.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for xrefkit-0.4.12.tar.gz
Algorithm	Hash digest
SHA256	`56b33895348a2e23e043fcf1a78ed5b4aa17acdfb344fcd8a45422b74441c838`
MD5	`e1502be271eb7cb6f16c4412ee6539ae`
BLAKE2b-256	`ad59fa2bcf0e7fa3987ab34a2cc6c994d5e53ad9a9748a613cb3c8a05f193c2b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for xrefkit-0.4.12.tar.gz:

Publisher: python-package.yml on synthaicode/XRefKit

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: xrefkit-0.4.12.tar.gz
- Subject digest: 56b33895348a2e23e043fcf1a78ed5b4aa17acdfb344fcd8a45422b74441c838
- Sigstore transparency entry: 2635562549
- Sigstore integration time: Aug 29, 2026
Source repository:
- Permalink: synthaicode/XRefKit@cd8eb747dbf94dd167080451a22ebce1270fab4f
- Branch / Tag: refs/tags/v0.4.12
- Owner: https://github.com/synthaicode
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-package.yml@cd8eb747dbf94dd167080451a22ebce1270fab4f
- Trigger Event: push