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.