How usestrix/strix works
Strix is an AI penetration-testing product: users configure and launch scans, agents coordinate reconnaissance and exploitation in a sandbox, and findings are validated and saved as reports for CLI, TUI, or browser review. The graph preserves the documented toolkit and reporting capabilities, plus MCP and live-view branches. Relationships are limited to README statements and source-index references; where wiring is not shown, links are omitted rather than inferred.
Main entry points: main.py CLI entry · factory.py Agent factory · state.py Report state · tool.py Finding tools
Components 27
User interfaces
- CLI entry
strix/interface/main.py - Interactive TUI
strix/interface/tui/backend/controller.py - TUI server
strix/interface/tui/backend/server.py - Run viewer
strix/interface/viewer/server.py - Viewer frontend
strix/interface/viewer/frontend/src/App.tsx
Scan engine
- Config loading
strix/config/loader.py - Settings models
strix/config/models.py - Codex auth
strix/config/codex.py - Agent factory
strix/agents/factory.py - Agent orchestration
strix/core/agents.py - Scan execution
strix/core/execution.py - Run paths
strix/core/paths.py - LLM request log
strix/llm/request_log.py
Agent capabilities
- Pentest skills
strix/skills/__init__.py - Coverage tools
strix/tools/coverage/tools.py - Proxy tools
strix/tools/proxy/tools.py - Finding tools
strix/tools/reporting/tool.py - MCP integrations
strix/tools/mcp
Findings and reports
- Report state
strix/report/state.py - Finding dedupe
strix/report/dedupe.py - Coverage records
strix/report/coverage.py - Report writer
strix/report/writer.py
Runtime and services
- Sandbox sessions
strix/runtime/session_manager.py - Docker runtime
strix/runtime/docker_client.py - Telemetry
strix/telemetry/posthog.py - Scan logging
strix/telemetry/logging.py
Other components
- Operator
Connections 29
- Operator → CLI entry: launches scan
- CLI entry → Config loading: loads settings
strix/interface/main.py - Config loading → Settings models: uses models
- CLI entry → Codex auth: configures auth
strix/interface/main.py - Agent factory → Config loading: loads config
strix/agents/factory.py - Agent factory → Coverage tools: registers tools
strix/agents/factory.py - Agent factory → Proxy tools: registers tools
strix/agents/factory.py - Agent factory → Finding tools: registers tools
strix/agents/factory.py - Agent factory → Pentest skills: loads skills
- Agent orchestration → Sandbox sessions: uses sessions
strix/core/agents.py - Scan execution → Sandbox sessions: starts runtime
- Sandbox sessions → Docker runtime: uses Docker
strix/runtime/session_manager.py - Proxy tools → Agent orchestration: reads agent context
strix/tools/proxy/tools.py - Coverage tools → Agent orchestration: reads agent graph
strix/tools/coverage/tools.py - Finding tools → Proxy tools: uses proxy tools
strix/tools/reporting/tool.py - Finding tools → Report state: updates findings
strix/tools/reporting/tool.py - Finding tools → Finding dedupe: deduplicates
strix/tools/reporting/tool.py - MCP integrations → Agent orchestration: dispatches tools
- Report state → Coverage records: writes coverage
strix/report/state.py - Report state → Report writer: writes reports
strix/report/state.py - Report state → LLM request log: reads usage
strix/report/state.py - CLI entry → Report state: finalizes run
strix/interface/main.py - CLI entry → Telemetry: ends telemetry
strix/interface/main.py - CLI entry → Scan logging: sets up logging
strix/interface/main.py - Operator → Interactive TUI: interacts
- TUI server → Interactive TUI: dispatches commands
strix/interface/tui/backend/server.py - Interactive TUI → Run viewer: serves live view
strix/interface/tui/backend/controller.py - Operator → Run viewer: opens run
- Viewer frontend → Run viewer: requests run data