TeoSlayer/pilot-skills / skills/pilot-audit-log
pilot-audit-log
UnverifiedComprehensive audit trail of all Pilot Protocol activity for security and compliance. Use this skill when: 1. You need detailed logs of all trust decisions and connections 2. You require compliance audit trails for security reviews 3. You want to investigate suspicious activity or incidents Do NOT use this skill when: - You need real-time alerting (use pilot-watchdog instead) - You only need basic daemon logs (use pilotctl info) - You're doing performance profiling (use dedicated profiling tools)
Pilot Audit Log
Comprehensive audit logging for Pilot Protocol with structured event capture, retention policies, and compliance-ready output formats.
Commands
Initialize audit log:
mkdir -p ~/.pilot/audit
cat > ~/.pilot/audit/config.json <<EOF
{
"enabled": true,
"log_file": "$HOME/.pilot/audit/events.jsonl",
"retention_days": 90,
"event_types": ["trust.handshake", "trust.approve", "connection.open"]
}
EOF
Log trust events:
log_audit() {
local EVENT_TYPE=$1
local DETAILS=$2
echo "$(date -u +%Y-%m-%dT%H:%M:%SZ) $EVENT_TYPE $DETAILS" >> ~/.pilot/audit/events.jsonl
}
pilotctl --json handshake "$AGENT" "Audit test"
log_audit "trust.handshake" "{\"agent\": \"$AGENT\"}"
Query audit log:
grep "trust.approve" ~/.pilot/audit/events.jsonl
jq 'select(.event_type == "trust.approve")' ~/.pilot/audit/events.jsonl
Generate audit report:
cat > ~/.pilot/audit/report-$(date +%Y-%m-%d).json <<EOF
{
"date": "$(date +%Y-%m-%d)",
"total_events": $(wc -l < ~/.pilot/audit/events.jsonl),
"handshakes": $(grep -c "trust.handshake" ~/.pilot/audit/events.jsonl || echo 0),
"approvals": $(grep -c "trust.approve" ~/.pilot/audit/events.jsonl || echo 0)
}
EOF
Workflow Example
#!/bin/bash
# Audit logging with automatic event capture
AUDIT_DIR=~/.pilot/audit
LOG_FILE=$AUDIT_DIR/events.jsonl
mkdir -p "$AUDIT_DIR"
audit_log() {
local EVENT_TYPE=$1
local AGENT=$2
local ACTION=$3
local RESULT=$4
cat >> "$LOG_FILE" <<EOF
{"timestamp":"$(date -u +%Y-%m-%dT%H:%M:%SZ)","event_type":"$EVENT_TYPE","agent":"$AGENT","action":"$ACTION","result":"$RESULT"}
EOF
}
# Wrap trust commands with audit logging
audit_handshake() {
local AGENT=$1
audit_log "trust" "$AGENT" "handshake" "started"
if pilotctl --json handshake "$AGENT" "Audit tracked"; then
audit_log "trust" "$AGENT" "handshake" "success"
else
audit_log "trust" "$AGENT" "handshake" "failed"
fi
}
audit_handshake "agent1.pilot"
Dependencies
Requires pilot-protocol skill, pilotctl binary, running daemon, and jq for JSON parsing.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |