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
profclaw security audit --pending
profclaw security audit --limit 100
profclaw security audit --json | jq '.[] | select(.result == "denied")'
profclaw security audit --pending
profclaw security approve <id>
profclaw security deny <id> --reason "Unauthorized external request"

Audit Results

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