Architecture

Normalize the hook. Explain the action.

The first version is deterministic and local. There is no daemon, database, cloud account, or required LLM.

See the source layout and model types in GitHub.View on GitHub

Core model

Host-specific JSON becomes a NormalizedAction: shell command, file write, file edit, file delete, file read, or unknown tool.

Agent CLI hook payload
        ↓
NormalizedAction
        ↓
Rule engine
        ↓
Plain-English preview

Rule engine

The MVP covers common deletes, installs, tests, git commands, output redirection, file writes, file edits, and unknown-command fallbacks.

Privacy posture

  • No network calls.
  • No telemetry.
  • No shell execution.
  • No file reads based on hook payload paths.