Logryph records tool calls made by an AI agent. It sits between the agent and the tool server. It forwards traffic and saves a copy of each request and response. Records are stored in SQLite. Each record is hashed and signed so edits can be detected. You can inspect, verify, and export records with a CLI.
When agents use tools, you often need a reliable record of what happened. Logryph creates that record so you can review, verify, and export it.
- Records every tool request and response
- Stores data in
logryph.db - Chains records with hashes
- Signs records with a local key
- Lets you query and export with
logyctl
Build:
go build -o logryph main.go
go build -o logyctl cmd/logyctl/main.goRun:
./logryph --target http://localhost:8080 --port 9999 --backpressure dropSend your agent traffic to:
http://localhost:9999
Use the CLI:
./logyctl trace
./logyctl verify
./logyctl export <file.zip>Ports: proxy :9999, admin/metrics :9998
Backpressure:
dropkeeps requests fast but can lose records under loadblockslows requests to keep all records
Server flags:
./logryph --config logryph-policy.yaml --target http://localhost:8080 --port 9999 --backpressure drop--config— path to the policy file--target— tool server URL--port— proxy listen port--backpressure—droporblock
CLI commands:
logyctl status— show current run infologyctl events --limit 10— list recent eventslogyctl stats— show run and global statslogyctl risk— list high‑risk eventslogyctl trace <task-id>— show a task timelinelogyctl verify— verify the hash chainlogyctl verify --skip-live— verify without live Bitcoin checkslogyctl export <file.zip>— export an evidence baglogyctl replay <event-id>— replay a stored tool calllogyctl rekey— rotate signing keyslogyctl backup-key— save a key backuplogyctl restore-key <backup-file>— restore from a backuplogyctl list-backups— list available backups
LOGRYPH_ADMIN_TOKENprotects the admin rekey endpointLOGRYPH_LOG_LEVELcontrols log verbosity
- Config:
logryph-policy.yaml - Database:
logryph.db - Key:
.logryph_key - Schema:
internal/ledger/store/schema.sql
Apache 2.0