How mirusu400/lanius works
Lanius is a local-first web security desktop workspace: users select a project, route browser traffic through its proxy, inspect and edit captured flows, then replay or fuzz them. The graph preserves documented project storage, site mapping, plugins, decoding/diffs, and agent access. Relationships are limited to README statements and visible source references/calls; many listed subsystems are unsampled, so their internal wiring is intentionally not inferred.
Main entry points: api/server.py REST and stream API · mcp/server.py Native MCP server · App.tsx Workspace UI · store.py Flow store
Components 23
Desktop Workspace
- Workspace UI
ui/src/App.tsx - Engine API client
ui/src/api/client.ts - Decode and encode
engine/app/addons/codecs.py - Response diff
ui/src/tabs/DiffTab.tsx - Project picker
ui/src/ProjectPicker.tsx
Capture and Testing
- Engine runtime
engine/app/main.py - REST and stream API
engine/app/api/server.py - HTTP proxy
engine/app/proxy.py - Flow capture
engine/app/addons/capture.py - Request interception
engine/app/addons/intercept.py - Request replay
engine/app/addons/replay.py - Payload fuzzing
engine/app/addons/fuzzer.py - Scope and sitemap
engine/app/addons/scope.py - WebSocket tools
engine/app/addons/websocket_proxy.py - Match and replace
engine/app/addons/match_replace.py
Project Data
- Flow store
engine/app/db/store.py - Project schema
engine/app/db/schema.py
Extensions and Agents
- Plugin runtime
engine/app/plugin_registry.py - Plugin management API
engine/app/api/server.py - Native MCP server
engine/app/mcp/server.py
Other components
- Security analyst
- AI agent
- Web browser
Connections 26
- Security analyst → Workspace UI: uses
README.md - Workspace UI → Project picker: selects project
ui/src/App.tsx - Workspace UI → Engine API client: requests engine
ui/src/App.tsx - Engine API client → REST and stream API: HTTP requests
- Engine runtime → REST and stream API: creates app
engine/app/main.py - Engine runtime → HTTP proxy: starts proxy
- Web browser → HTTP proxy: sends traffic
README.md - HTTP proxy → Flow capture: captures flows
- Flow capture → Flow store: persists flows
- REST and stream API → Flow store: reads history
engine/app/api/server.py - REST and stream API → Request interception: controls interception
engine/app/api/server.py - REST and stream API → Request replay: sends replay
engine/app/api/server.py - REST and stream API → Payload fuzzing: runs fuzzing
engine/app/api/server.py - REST and stream API → Scope and sitemap: serves scope
engine/app/api/server.py - REST and stream API → WebSocket tools: routes tools
engine/app/api/server.py - REST and stream API → Match and replace: routes rules
engine/app/api/server.py - REST and stream API → Decode and encode: routes codecs
engine/app/api/server.py - Flow store → Project schema: uses schema
engine/app/db/store.py - Workspace UI → Response diff: opens diff
README.md - REST and stream API → Plugin management API: exposes plugin routes
engine/app/api/server.py - Plugin management API → Plugin runtime: manages plugins
engine/app/api/server.py - AI agent → Native MCP server: invokes tools
README.md - Native MCP server → Flow store: queries flows
engine/app/mcp/server.py - Native MCP server → Request interception: controls rules
engine/app/mcp/server.py - Native MCP server → Request replay: sends requests
engine/app/mcp/server.py - Native MCP server → Plugin runtime: plugin tools
engine/app/mcp/server.py