Nm Leyline Usage Logging
by @athola
Implements structured usage logging and audit trails for cost and session tracking
clawhub install nm-leyline-usage-loggingπ About This Skill
name: usage-logging description: Consult this skill when implementing usage logging and audit trails version: 1.9.4 triggers: - logging - usage - audit - metrics - sessions - analytics metadata: {"openclaw": {"homepage": "https://github.com/athola/claude-night-market/tree/master/plugins/leyline", "emoji": "\ud83e\udd9e"}} source: claude-night-market source_plugin: leyline
> Night Market Skill β ported from claude-night-market/leyline. For the full experience with agents, hooks, and commands, install the Claude Code plugin.
Table of Contents
Usage Logging
Overview
Session-aware logging infrastructure for tracking operations across plugins. Provides structured JSONL logging with automatic session management for audit trails and analytics.
When To Use
When NOT To Use
Core Concepts
Session Management
Sessions group related operations:
Log Entry Structure
{
"timestamp": "2025-12-05T10:30:00Z",
"session_id": "session_1733394600",
"service": "my-service",
"operation": "analyze_files",
"tokens": 5000,
"success": true,
"duration_seconds": 2.5,
"metadata": {}
}
--help flag to verify availability.Quick Start
Initialize Logger
from leyline.usage_logger import UsageLoggerlogger = UsageLogger(service="my-service")
--help flag to verify availability.Log Operations
logger.log_usage(
operation="analyze_files",
tokens=5000,
success=True,
duration=2.5,
metadata={"files": 10}
)
--help flag to verify availability.Query Usage
# Recent operations
recent = logger.get_recent_operations(hours=24)Usage summary
summary = logger.get_usage_summary(days=7)
print(f"Total tokens: {summary['total_tokens']}")
print(f"Total cost: ${summary['estimated_cost']:.2f}")Recent errors
errors = logger.get_recent_errors(count=10)
--help flag to verify availability.Integration Pattern
# In your skill's frontmatter
dependencies: [leyline:usage-logging]
--help flag to verify availability.Standard integration flow: 1. Initialize logger for your service 2. Log operations after completion 3. Query for analytics and debugging
Log Storage
Default location: ~/.claude/leyline/usage/{service}.jsonl
# View recent logs
tail -20 ~/.claude/leyline/usage/my-service.jsonl | jq .Query by date
grep "2025-12-05" ~/.claude/leyline/usage/my-service.jsonl
--help flag to verify availability.Detailed Resources
modules/session-patterns.md for session managementmodules/log-formats.md for structured formatsExit Criteria
Troubleshooting
Common Issues
Command not found Ensure all dependencies are installed and in PATH
Permission errors Check file permissions and run with appropriate privileges
Unexpected behavior
Enable verbose logging with --verbose flag
β‘ When to Use
π‘ Examples
Initialize Logger
from leyline.usage_logger import UsageLoggerlogger = UsageLogger(service="my-service")
--help flag to verify availability.Log Operations
logger.log_usage(
operation="analyze_files",
tokens=5000,
success=True,
duration=2.5,
metadata={"files": 10}
)
--help flag to verify availability.Query Usage
# Recent operations
recent = logger.get_recent_operations(hours=24)Usage summary
summary = logger.get_usage_summary(days=7)
print(f"Total tokens: {summary['total_tokens']}")
print(f"Total cost: ${summary['estimated_cost']:.2f}")Recent errors
errors = logger.get_recent_errors(count=10)
--help flag to verify availability.π Tips & Best Practices
Common Issues
Command not found Ensure all dependencies are installed and in PATH
Permission errors Check file permissions and run with appropriate privileges
Unexpected behavior
Enable verbose logging with --verbose flag