How falcosecurity/prempti works
Prempti is a cross-platform Falco-based policy and visibility layer for coding-agent tool calls. The main workflow intercepts an agent action, sends it through the Falco plugin for event evaluation against YAML rules, and returns an allow, deny, or ask verdict; monitor mode logs evaluations without enforcing them. The CLI and supervisor manage operation, hooks, and logs. Plugin wiring and several CLI behaviors are represented from the README and SOURCE INDEX; unsampled details are not inferred beyond documented links.
Main entry points: lib.rs Falco Plugin · broker.rs Verdict Broker · main.rs premptictl · socket_server.rs Socket Server
Components 24
Agent Interception
- Claude Hook
hooks/claude-code/src/main.rs - Codex Hook
hooks/codex/src/main.rs
Falco Evaluation
- Falco Plugin
plugins/coding-agents-plugin/src/lib.rs - Socket Server
plugins/coding-agents-plugin/src/socket_server.rs - HTTP Server
plugins/coding-agents-plugin/src/http_server.rs - Event Normalization
plugins/coding-agents-plugin/src/event.rs - Rule Fields
plugins/coding-agents-plugin/src/extract.rs - Patch Parsing
plugins/coding-agents-plugin/src/apply_patch.rs - Verdict Broker
plugins/coding-agents-plugin/src/broker.rs - Verdict Protocol
plugins/coding-agents-plugin/src/verdict.rs
Runtime Operations
- premptictl
tools/premptictl/src/main.rs - Falco Supervisor
tools/premptictl/src/daemon/mod.rs - Daemon Config
tools/premptictl/src/daemon/config.rs - Control Channel
tools/premptictl/src/daemon/control.rs - Log Pipe Drain
tools/premptictl/src/daemon/pipe_drain.rs - Log Rotation
tools/premptictl/src/daemon/rotate.rs - Claude Hook Setup
tools/premptictl/src/hook.rs - Codex Hook Setup
tools/premptictl/src/hook_codex.rs - Log Renderer
tools/premptictl/src/logs_pretty.rs
Policy and Audit
- Falco Rules
rules/default/coding_agents_rules.yaml - User Rules
rules/user - Audit Logs
Other components
- Coding Agent
- Falco Engine
Connections 30
- Coding Agent → Claude Hook: invokes tools
README.md - Coding Agent → Codex Hook: invokes tools
README.md - Claude Hook → Falco Plugin: submits calls
README.md - Codex Hook → Falco Plugin: submits calls
README.md - Falco Plugin → Socket Server: starts server
plugins/coding-agents-plugin/src/lib.rs - Falco Plugin → HTTP Server: starts server
plugins/coding-agents-plugin/src/lib.rs - Socket Server → Verdict Broker: registers requests
plugins/coding-agents-plugin/src/socket_server.rs - Socket Server → Event Normalization: sends events
plugins/coding-agents-plugin/src/lib.rs - Socket Server → Patch Parsing: parses patches
plugins/coding-agents-plugin/src/socket_server.rs - HTTP Server → Verdict Broker: uses broker
plugins/coding-agents-plugin/src/http_server.rs - Falco Plugin → Event Normalization: queues events
plugins/coding-agents-plugin/src/lib.rs - Falco Plugin → Rule Fields: exposes fields
plugins/coding-agents-plugin/src/lib.rs - Event Normalization → Falco Engine: provides events
- Rule Fields → Falco Engine: provides fields
- Falco Rules → Falco Engine: configures rules
README.md - User Rules → Falco Engine: customizes policy
README.md - Falco Engine → Verdict Broker: reports verdict alerts
- Verdict Broker → Verdict Protocol: resolves response
plugins/coding-agents-plugin/src/broker.rs - Verdict Broker → Claude Hook: returns decision
README.md - Verdict Broker → Codex Hook: returns decision
README.md - Falco Engine → Audit Logs: records activity
README.md - premptictl → Falco Supervisor: controls daemon
tools/premptictl/src/main.rs - Falco Supervisor → Daemon Config: loads settings
tools/premptictl/src/daemon/mod.rs - Falco Supervisor → Control Channel: handles control
tools/premptictl/src/daemon/mod.rs - Falco Supervisor → Log Pipe Drain: drains output
tools/premptictl/src/daemon/mod.rs - Log Pipe Drain → Log Rotation: rotates logs
tools/premptictl/src/daemon/pipe_drain.rs - premptictl → Claude Hook Setup: manages hooks
tools/premptictl/src/main.rs - premptictl → Codex Hook Setup: manages hooks
tools/premptictl/src/main.rs - premptictl → Log Renderer: renders logs
tools/premptictl/src/main.rs - Audit Logs → Log Renderer: streams logs
README.md