How luckypipewrench/pipelock works
Pipelock is an AI-agent egress firewall: an operator routes an agent’s network activity through Pipelock, which mediates and scans traffic, applies policy, and records signed evidence for later review. Its runtime also supports MCP mediation, containment, and deferred decisions; users can inspect or verify evidence offline. The repository includes a separate public-playground system and enterprise fleet/dashboard services. Relationships below are limited to README statements and sampled-source references; unsampled subsystem wiring is not asserted.
Main entry points: server.go Proxy runtime · pipeline_gates.go MCP gates · main.go Pipelock CLI · recorder Flight recorder
Components 21
Mediation runtime
- Pipelock CLI
cmd/pipelock/main.go - Runtime config
internal/config - Proxy runtime
internal/cli/runtime/server.go - HTTP proxy
internal/proxy - MCP gates
internal/mcp/pipeline_gates.go - Content scanner
internal/scanner - Scan API
internal/scanapi/handler.go - Deferred actions
internal/deferred/manager.go
Evidence and review
- Signed receipts
internal/contract/receipt - Flight recorder
internal/recorder - Evidence viewer
internal/cli/evidence - Receipt verifier
cmd/pipelock-verifier
Agent controls
- Host containment
internal/cli/contain - Process sandbox
internal/sandbox
Public playground
- Playground broker
internal/playground/broker/server.go - Live chat
internal/playground/livechat/server.go - Model agent
cmd/pipelock-playground-llm-agent/main.go
Enterprise services
- Fleet dashboard
enterprise/dashboard/handler.go - Fleet audit store
enterprise/fleet/sink/storage.go
Other components
- Operator
- AI agent
Connections 21
- Operator → Pipelock CLI: configures and runs
- AI agent → Proxy runtime: routes traffic through
- Pipelock CLI → Proxy runtime: starts
internal/cli/runtime/server.go - Proxy runtime → Runtime config: loads policy
internal/cli/runtime/server.go - Proxy runtime → HTTP proxy: constructs
internal/cli/runtime/server.go - Proxy runtime → MCP gates: integrates
internal/cli/runtime/server.go - Proxy runtime → Content scanner: constructs
internal/cli/runtime/server.go - MCP gates → Content scanner: scans content
internal/mcp/pipeline_gates.go - MCP gates → Runtime config: reads policy
internal/mcp/pipeline_gates.go - Proxy runtime → Deferred actions: uses
internal/cli/runtime/server.go - Proxy runtime → Flight recorder: records decisions
internal/cli/runtime/server.go - Proxy runtime → Signed receipts: emits decisions
- Proxy runtime → Host containment: supports deployment
- Proxy runtime → Process sandbox: supports deployment
- Operator → Evidence viewer: reviews session
- Flight recorder → Evidence viewer: reads session
- Operator → Receipt verifier: verifies receipt
- Operator → Playground broker: visits playground
- Playground broker → Live chat: proxies sessions
internal/playground/broker/server.go - Live chat → Model agent: runs agent
- Fleet dashboard → Fleet audit store: queries audit data