Skip to content

Add Tracekit to Decision-Record Tools - #49

Merged
yzhao062 merged 1 commit into
yzhao062:mainfrom
LoopGlitch26:add-tracekit
Nov 5, 2026
Merged

yzhao062 merged 1 commit into
yzhao062:mainfrom
LoopGlitch26:add-tracekit

Conversation

@LoopGlitch26

Copy link
Copy Markdown
Contributor

Adds Tracekit to Decision-Record Tools, as the last entry (after Vestige).

  • Title: Tracekit
  • Primary link: https://github.com/Cygnux-Labs/Tracekit
  • Section: Audit Trails and Decision Records > Decision-Record Tools
  • Summary: a signer process outside the agent that decides each tool call before it runs and signs every call, decision, approval and result into a per-run hash chain that verifies offline.
  • License and activity: MIT, 2026-present; 1.5.2 released 2026-10-31 (PyPI tracekit-ai, npm @cygnuxlabs/tracekit).

How it bears on auditing an agent: the record is written by a separate process that holds the signing key and assigns the sequence numbers; the agent's hook, framework adapter or MCP gateway can only report to it. A run exports as one .tkb bundle, and tracekit verify checks the signatures, the chain and any witness checkpoints offline, with no network access and no code taken from the bundle. An edited or truncated record fails at the record that changed, and an outage is written as a signed gap rather than left as a hole. Auditor guide: https://github.com/Cygnux-Labs/Tracekit/wiki/Auditor-Guide

What it doesn't establish, which is why the entry says so:

  • It only records what passes through its hooks, adapters or gateway. A call made around them leaves no record.
  • In the default dev mode the signer runs as the agent's own user, so a compromised agent could tamper with it. The record holds up only when the signer runs as a separate user, in a container (there's a Helm chart for a sidecar) or on another host.
  • It shows what was decided and done, not whether the action was right. By default the record holds digests of the content (prompts, arguments, output), not the text.

Checks: one added entry and its blank line, in the format of the entries around it (language tag, owner/repo link, license and activity period at the end); git diff --check passes. I didn't run tools/check_links.py locally; the entry adds a single GitHub link.

Disclosure: I maintain Tracekit (Cygnux Labs). Cygnux Labs also has a hosted plan in early access; the entry is about the MIT package and needs nothing else. Please edit the summary however suits the list.

@yzhao062
yzhao062 merged commit 605aba3 into yzhao062:main Nov 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants