How nocoolusername/volatility-workbench works
Volatility Workbench is a local browser or native-desktop interface for memory-forensics cases; the separate volatility-mcp core performs forensic execution. Users register existing images, check readiness, run sequential report work and independent plugin batches, then revisit saved reports, evidence, citations, and coverage. The graph includes settings, plugin inspection, VolShell, AI assistance, and the optional Adventure game. Relationships for unsampled modules are included only where documented or listed in the source index; some internal wiring is therefore omitted.
Main entry points: app.py Case controller · http.py Local HTTP transport · settings.py Settings manager · storage.py Case and report storage
Components 25
User interfaces
- Browser interface
src/volatility_workbench/static/app.js - Local HTTP transport
src/volatility_workbench/http.py - Native macOS shell
src/volatility_workbench/desktop.py
Cases and reports
- Case controller
src/volatility_workbench/app.py - Case and report storage
src/volatility_workbench/storage.py - Report plugin inventory
src/volatility_workbench/report_plugins.py - Case data models
src/volatility_workbench/models.py
Analysis and assistance
- Volatility MCP core
- Report generation
src/volatility_workbench/generation.py - AI provider adapter
src/volatility_workbench/providers.py - Codex connector
src/volatility_workbench/codex.py - Report decorations
src/volatility_workbench/coins.py - VolShell interface
src/volatility_workbench/static/volshell.js - VolShell process manager
src/volatility_workbench/volshell.py - VolShell AI agent
src/volatility_workbench/volshell_agent.py - AI command suggestions
src/volatility_workbench/volshell_assist.py - Live console transport
src/volatility_workbench/live_console.py
Configuration and extensions
- Settings interface
src/volatility_workbench/static/settings.js - Settings manager
src/volatility_workbench/settings.py - Symbol import and checks
src/volatility_workbench/symbols.py - Analyzer maintenance
src/volatility_workbench/runtime_management.py - Theme catalog
src/volatility_workbench/static/themes.js - Adventure game
src/volatility_workbench/adventure.py - Adventure interface
src/volatility_workbench/static/adventure.js
Other components
- Workbench user
Connections 33
- Workbench user → Browser interface: uses
README.md - Workbench user → Native macOS shell: opens
README.md - Browser interface → Local HTTP transport: requests
README.md - Native macOS shell → Local HTTP transport: hosts
src/volatility_workbench/desktop.py - Local HTTP transport → Case controller: dispatches
src/volatility_workbench/http.py - Local HTTP transport → Settings manager: routes settings
src/volatility_workbench/http.py - Local HTTP transport → Adventure game: serves status
src/volatility_workbench/http.py - Case controller → Case and report storage: persists cases
src/volatility_workbench/app.py - Case controller → Case data models: uses models
src/volatility_workbench/app.py - Case controller → Report generation: generates reports
src/volatility_workbench/app.py - Case controller → AI provider adapter: uses providers
src/volatility_workbench/app.py - Case controller → VolShell process manager: manages sessions
src/volatility_workbench/app.py - Case controller → VolShell AI agent: uses agent
src/volatility_workbench/app.py - Case controller → Report plugin inventory: packages inventory
src/volatility_workbench/app.py - Case controller → Report decorations: uses decorations
src/volatility_workbench/app.py - Case controller → Live console transport: uses console
src/volatility_workbench/app.py - Case controller → Volatility MCP core: runs analysis
README.md - Case and report storage → Report plugin inventory: packages saved runs
src/volatility_workbench/storage.py - Case and report storage → Report decorations: loads coin data
src/volatility_workbench/coins.py - AI provider adapter → Codex connector: connects Codex
src/volatility_workbench/providers.py - VolShell AI agent → VolShell process manager: uses sessions
src/volatility_workbench/volshell_agent.py - AI command suggestions → AI provider adapter: uses AI adapter
src/volatility_workbench/volshell_assist.py - Local HTTP transport → VolShell interface: serves console data
README.md - Settings interface → Local HTTP transport: submits settings
README.md - Settings manager → Symbol import and checks: imports symbols
src/volatility_workbench/settings.py - Settings manager → Analyzer maintenance: maintains analyzer
src/volatility_workbench/settings.py - Settings manager → Case and report storage: stores preferences
src/volatility_workbench/settings.py - Workbench user → Theme catalog: chooses theme
README.md - Workbench user → Adventure interface: plays
README.md - Adventure interface → Local HTTP transport: requests game
README.md - Local HTTP transport → Adventure game: routes game
src/volatility_workbench/http.py - Browser interface → Settings interface: opens settings
- VolShell interface → AI command suggestions: requests suggestions