okx-audit-log

The okx-audit-log skill provides a structured mechanism for developers and system administrators to access and manage audit logs generated by the Onchain OS environment. It addresses the common challenge of monitoring and troubleshooting command execution histories without requiring real-time file inspection. By exposing the location and structure of audit logs, it enables users to perform offline analysis, ensuring a secure and organized way to track command invocations, system interactions, and potential errors across the Onchain OS platform.

This skill offers several key capabilities. It provides the precise file path of the audit log, typically located at `~/.onchainos/audit.jsonl` or `$ONCHAINOS_HOME/audit.jsonl` if an environment variable is set. Logs are maintained in JSON Lines format, allowing each entry to be a standalone JSON object for easy parsing and automation. The first line captures device-specific metadata such as OS, architecture, and CLI version. Each subsequent entry records critical details including timestamp, command source, execution success, duration, redacted arguments, and any errors. Logs are rotated automatically once they reach 10,000 lines, retaining the device header and the most recent 5,000 entries, which ensures that log files remain manageable while preserving relevant history.

Targeted at developers, auditors, and IT professionals working within the Onchain OS ecosystem, this skill is particularly useful for offline troubleshooting, auditing command history, and understanding system behavior. It is suitable for users who need to analyze past operations without directly exposing sensitive information stored in the log entries. The skill is explicitly designed to avoid operations related to wallet balances, token searches, swaps, or any on-chain transactions, focusing solely on command and audit log management.