How muxuejc/sapper-v2 works
sapper-v2 is a multi-agent pentest orchestration harness. Its documented campaign workflow is a commander reading the competition board, dispatching agents to work in parallel, and coordinating their findings through shared memory; a watchdog supports long unattended runs. The sampled CLI implements a filesystem-backed fact/intent graph, dispatch operations, and an arena bridge. The README also describes agent creation and communication, but those runtime details are not shown in the sampled source. Edges reflect explicit README statements or visible source references; uncertain integration links are omitted.
Main entry points: sapper.py Commander · arena.py Arena bridge · sapper-hook.py Claude hook bridge · _settings_patch.py Hook registration
Components 16
Campaign orchestration
- Commander
lib/sapper.py - Work scheduler
lib/sapper.py - Reason dispatch
lib/sapper.py - Explore dispatch
lib/sapper.py - Verify dispatch
lib/sapper.py - Arena bridge
lib/arena.py
Shared memory
- Fact graph
lib/sapper.py - Knowledge base
lib/kb.py - Claude hook bridge
lib/sapper-hook.py - Hook registration
lib/_settings_patch.py
Agent runtime
- Agent CLI
- tmux runtime
docker/tmux-drive.sh - Watchdog
docker/commander/watchdog.sh
External integrations
- Claude Code
- Competition platform
Other components
- Operator
Connections 14
- Operator → Commander: starts campaign
README.md - Commander → Work scheduler: dispatches work
README.md - Commander → Reason dispatch: proposes work
README.md - Commander → Explore dispatch: dispatches agents
lib/sapper.py - Commander → Verify dispatch: dispatches checks
lib/sapper.py - Commander → Fact graph: uses memory
README.md - Claude hook bridge → Fact graph: reads and renders
lib/sapper-hook.py - Hook registration → Claude Code: registers hooks
lib/_settings_patch.py - Claude Code → Claude hook bridge: invokes hooks
lib/sapper-hook.py - Commander → Agent CLI: dispatches agents
README.md - Agent CLI → tmux runtime: runs in
README.md - Watchdog → Commander: keeps alive
README.md - Commander → Arena bridge: uses arena
lib/sapper.py - Arena bridge → Competition platform: calls API
lib/arena.py