Skip to content

gplay audit

Query and manage the local command audit log.

gplay audit <subcommand> [flags]

Query and manage the local command audit log.

Every gplay command invocation appends a JSON entry to ~/.gplay/audit.log. Disable with GPLAY_AUDIT=0. Override the path with GPLAY_AUDIT_LOG.

List recent audit entries (newest first).

gplay audit list [flags]
Flag Description Default
--limit Maximum number of entries to show (0 = all) 50
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false
--since Only include entries newer than this (RFC3339 or duration like 24h) ``
--status Filter by status (ok, error, started) ``

Search audit entries by command or status.

gplay audit search --command <substr> [flags]
Flag Description Default
--command Substring to match against command name ``
--limit Maximum number of results 100
--output Output format: json (default), table, markdown json
--pretty Pretty-print JSON output false
--status Filter by status ``

Truncate the audit log.

gplay audit clear --confirm
Flag Description Default
--confirm Required to actually truncate the log false

Print the active audit log path.

gplay audit path