← All hooks

Interaction Audit Logger

non-blocking stable

Appends a JSONL record to ~/.ai/audit/interactions/<YYYY-MM>.jsonl for every Claude Code hook event: SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SessionEnd, SubagentStop, PreCompact. Non-blocking. Implements Common.md §5.2.

ID hook/audit-logger Version 1.0.0 Author convergent-systems-key
ai hooks run audit-logger
Event PreToolUse Language python Trigger always Side effects
  • writes to ~/.ai/audit/interactions/<YYYY-MM>.jsonl
linuxmacoswindows Logic is cross-platform. Wiring: use 'ai hooks run audit-logger' in settings.json — the ai binary discovers Python on each OS. Writes to ~/.ai/audit/ — path resolves correctly cross-platform via Python pathlib.
auditlogginggovernanceclaude-code
Attribution: convergent-systems-key.