Skip to main content
Glama
agent-receipts

agent-receipts

by yulinlina

agent-receipts

Append-only local receipts for AI agent actions: capture commands, outputs, and handoff evidence, then expose them to agents over MCP.

License Language Status PyPI Tests


🎯 Why?

Trending agent projects increasingly mention evidence logs, verifiable handoffs, and agent observability, but most solutions are large frameworks or platform-specific hubs. Developers using Claude Code, Codex, OpenCode, or custom agents need a tiny local-first tool that simply records what happened and proves it was not edited. agent-receipts fills that gap with a zero-depend CLI plus a minimal MCP adapter.

Target audience: Developers running AI coding agents, agent-framework authors, and platform/security engineers who need lightweight local audit trails, reproducible handoffs, and evidence that an agent really ran a command or completed a step.

Related MCP server: GoLogX (logx-mcp)

✨ Features

  • ✨ Capture command executions with stdout/stderr tails, exit codes, duration, cwd, agent, session, and tags

  • ✨ Append-only hash-chained JSONL receipts with tamper detection via verify

  • ✨ Manual evidence notes for handoffs, plus search/export and a minimal MCP stdio server

πŸš€ Quick Start

# Install
pip install agent-receipts

# Run
agent-receipts --help

πŸ“¦ Installation

From Source

git clone https://github.com/YOUR_USERNAME/agent-receipts.git
cd agent-receipts
# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest -v

🎬 Demo

The GIF above was recorded using Charm VHS:

vhs < demo.tape

πŸ“– Usage

# Show help
agent-receipts --help

# Common usage examples
agent-receipts --example

πŸ—οΈ Architecture

graph LR
    A[Input] --> B[Core Engine]
    B --> C[Output]
    B --> D[Plugins]
    D --> E[Extensions]

🀝 Contributing

Contributions are welcome! Please:

  1. Fork the repo

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

πŸ“„ License

MIT Β© 2026 β€” See LICENSE for details.


If this project helped you, please ⭐ star it!

Made with ❀️ and AI

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      An MCP server that enforces fail-closed deterministic checks, independent refute-first review, and tamper-evident hash-chained receipts for AI agent outputs before claiming completion.
      4
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Tamper-evident audit logging for AI agents. Append-only, hash-chained, optionally Ed25519-signed log. The MCP server lets an agent keep and verify a record of what it actually did.
      8
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server that provides cryptographic audit trails for AI agent actions, making every action tamper-evident via HMAC-SHA256 signed hash chains.
      10
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that auto-emits tamper-evident receipts for every tool call, enabling EU AI Act Article 12 compliance with signed, chain-linked receipts.
      1
      Apache 2.0