looptail 0.1.0

Record every AI decision as a signed, append-only trail. Every loop leaves a tail.

looptail

Record every AI decision as a signed, append-only trail. Every loop leaves a tail.

pip install looptail

import looptail

looptail.init(app="support-agent")

@looptail.trail
def handle_ticket(ticket):
    ...

# report an outcome signal when you learn how it went
looptail.outcome(looptail.last_event_id(), csat=5)

Every call becomes a hash-chained, Ed25519-signed loop event appended to .looptail/support-agent.jsonl. Nothing is edited in place; any modification, deletion, or reorder of past records is detectable:

npx @looptail/cli verify --app support-agent

✔ 2 loop events
✔ chain intact · signatures valid

Or from Python: looptail.verify_trail().

How it works

• A signing key is created on first use at ~/.looptail/signing-key (override with LOOPTAIL_SIGNING_KEY, hex seed).
• Events follow the open trail format — spec/trail-format.md — and are verifiable by any implementation, including the JS CLI.
• The local trail is the source of truth. With an API key (looptail.init(app=..., api_key=...) or LOOPTAIL_API_KEY), events also sync to the hosted Tail (private beta); sync is best-effort and never blocks or crashes your app.

Read the trust model in the spec before relying on local trails as evidence: self-signed trails are tamper-evident; hosted anchoring (v0.2) makes them stronger.

Docs: looptail.ai/docs · License: Apache-2.0