mentat-log

Manage Mentat audit events with JSONL validation and SQLite storage.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/matheushenriquefs/mentat --skill mentat-log
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mentat-log
Source: https://github.com/matheushenriquefs/mentat/tree/main/.agents/skills/mentat-log
Command: npx skills add https://github.com/matheushenriquefs/mentat --skill mentat-log

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a comprehensive solution for managing and interacting with Mentat audit events, enabling structured logging, validation, and pruning of events for orchestration history and custom scripts.

Core Features & Use Cases

  • Event Emission: Emit structured audit events for various Mentat activities.
  • Validation: Validate JSONL log files for proper event format.
  • Listing: List audit events from the canonical store.
  • Pruning: Prune old agent log directories based on specified criteria.
  • Use Case: Monitor the orchestration history of Mentat and ensure the integrity of audit logs for post-mortem analysis and custom script integration.

Quick Start

Run the mentat-log skill to emit a new event:

mentat-log emit my-agent slice_started "Initial slice setup."

Frequently Asked Questions about mentat-log

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

FAQPage Schema
How do I emit structured audit events for Mentat orchestration?▼

To emit structured audit events for Mentat orchestration, run the mentat-log skill with the emit command, specifying the agent name, event type, and message. This writes the event to the canonical SQLite store for orchestration history tracking.

Can I validate JSONL log files for proper Mentat audit event format?▼

Yes, you can validate JSONL log files for proper Mentat audit event format. The skill checks the structure of emitted events to ensure the integrity of audit logs for post-mortem analysis and custom script integration.

What is the best way to prune old agent log directories in Mentat?▼

The best way to prune old agent log directories in Mentat is using the mentat-log skill's pruning feature. It removes outdated log directories based on specified criteria, maintaining a clean and organized audit trail.

Does Mentat audit logging require external dependencies or databases?▼

Mentat audit logging does not require external dependencies. It utilizes Python's standard library for JSON handling and SQLite for database operations, storing structured events in a canonical local store without extra setup.

How do I list audit events from the canonical store in Mentat?▼

To list audit events from the canonical store in Mentat, use the mentat-log skill's listing feature. It retrieves and displays structured events from the SQLite database, allowing you to monitor orchestration history and external script interactions.