Skip to main content

Synopsis

profclaw security audit [flags]

Description

The security audit log captures every security-relevant action in profClaw: tool executions, approval requests, approvals, denials, and authentication events. It provides a tamper-evident trail for compliance and debugging. The audit subcommand is accessed via profclaw security audit. See the security command for the full security command group.

Flags

-l, --limit
string
default:"20"
Maximum number of log entries to show.
--pending
boolean
Show only entries with pending result - items awaiting approval.
--json
boolean
Output as JSON array with full entry details.

Audit Entry Fields

FieldDescription
idUnique entry ID
actionWhat was attempted (e.g., exec, write_file, http_request)
actorUser or agent that initiated the action
targetResource targeted (file path, URL, command)
resultapproved, denied, or pending
createdAtTimestamp

Examples

profclaw security audit

Audit Results

ResultDescription
approvedAction was allowed (automatically or manually)
deniedAction was blocked
pendingAwaiting manual approval from an admin