ag-ledger

Log agent activity as append-only JSONL records with daily ledger files.

21|Updated Jan 3, 2026

Search Tags:#workflow #logging #audit #session #jsonl #ledger #ag-ledger

Ready to run

npx skills add https://github.com/kevinslin/skills --skill ag-ledger

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ag-ledger
Source: https://github.com/kevinslin/skills/tree/main/active/ag-ledger
Command: npx skills add https://github.com/kevinslin/skills --skill ag-ledger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Keeps a durable, auditable log of agent activity by recording session starts, notable changes, and session ends in an append-only ledger stored as per-day JSONL entries under META_LEDGER_ROOT.

Core Features & Use Cases

Append current session events with ag-ledger append-current and manual messages with ag-ledger append.
Query and filter entries by session, workspace, or time range via ag-ledger filter.
Data layout and storage: per-day ledger files named ledger-YYYY-MM-DD.md under $META_LEDGER_ROOT/data.

Quick Start

Run ag-ledger init to install or update AGENTS.md guidance, then log your first session with ag-ledger append-current "session start: <what you plan to do>".

Frequently Asked Questions about ag-ledger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I keep an auditable log of agent activity across multiple sessions?▼

To keep an auditable log of agent activity, you can record session starts, changes, and ends as append-only JSONL entries. This approach stores daily ledger files, enabling review by session, workspace, or time range.

What is the best way to track AI agent sessions in a structured log format?▼

Tracking AI agent sessions in a structured log format is best done using append-only JSONL records. This format stores daily ledger files under a specified root directory, allowing you to query and filter entries by session or time range.

How do I initialize and append session history to a daily JSONL ledger file?▼

To initialize and append session history, run an init command to install guidance, then log your first session using an append-current command. This writes session events as JSONL entries into daily ledger files named by date.

Can I filter agent workflow logs by workspace and time range?▼

Yes, you can filter agent workflow logs by workspace and time range. A CLI filter command queries the append-only JSONL records, allowing you to review specific session histories across multiple workspaces.

Does ag-ledger require any external dependencies to maintain session audit logs?▼

No external dependencies are required to maintain session audit logs with ag-ledger. It operates independently using CLI scripts to manage append-only JSONL records stored locally under a configurable root directory.

When should I use append-only JSONL files for logging agent session history?▼

You should use append-only JSONL files for logging agent session history when you need a durable, tamper-evident audit trail. This format prevents modifications to past entries, ensuring historical workflow data remains reliable.