mcpField
O
okx-audit-log

okx-audit-log

github.com/okxDevelopment3456.4k installsUpdated 1d ago
Repository

About okx-audit-log

A skill for helping Onchain OS developers locate and understand the audit log when troubleshooting offline. It explains the log path, JSON Lines format, recorded fields, and rotation behavior without exposing log contents.

Key features

  1. 01Provides the audit log path
  2. 02Explains JSON Lines structure
  3. 03Lists recorded entry fields
  4. 04Documents log rotation behavior

Use cases

  1. 01Finding logs for offline troubleshooting
  2. 02Checking which fields audit entries contain

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/okx/onchainos-skills --skill okx-audit-log

After installing, type/okx-audit-login Claude Code to confirm it loaded.

Details

From the project README

Onchain OS Audit Log

Provide the audit log file path for developers to troubleshoot issues offline.

Response

Tell the user:

  1. Log file path: ~/.onchainos/audit.jsonl (or $ONCHAINOS_HOME/audit.jsonl if the env var is set)
  2. Format: JSON Lines, one JSON object per line
  3. First line (device header): {"type":"device","os":"<os>","arch":"<arch>","version":"<cli_version>"} — written once when the log file is created; preserved across rotations
  4. Entry fields: ts (local time with timezone, e.g. 2026-03-18 +8.0 18:00:00.123), source (cli/mcp), command, ok, duration_ms, args (redacted), error
  5. Rotation: max 10,000 lines, auto-keeps the device header + most recent 5,000 entries

Do NOT read or display the file contents in the conversation.

Comments

Markdown supported