How goldlance07/ttula works
TTULA is a terminal-first security reconnaissance workspace with an optional browser console. Operators launch a UI or CLI workflow; the core engine dispatches discovery, URL processing, mesh-status, command-knowledge, and lab-gated authentication tasks through adapters. Tookie and the crawler can feed Uro normalization, while the execution manager provides one-shot processes and persistent PTY sessions. Shared models carry targets, commands, results, and URL collections. README and sampled-source evidence establish the main wiring; some UI and adapter internals were not sampled, so those links are omitted where unverified.
Main entry points: engine.py TTULA Engine · adapter.py Uro URL Filter · process.py Subprocess Runner · app.py Browser Console
Components 20
Operator Interfaces
- CLI Commands
ttula/cli/main.py - Textual Dashboard
ttula/ui/tui/app.py - Browser Console
ttula/ui/streamlit/app.py - Home View
ttula/ui/components/home.py - Tool Header
ttula/ui/components/header.py - Category Badges
ttula/ui/components/badges.py
Core Orchestration
- TTULA Engine
ttula/core/engine.py - Shared Data Models
ttula/core/models.py - Operation Mapping
ttula/core/operations.py - Tool Metadata
ttula/config/tools.py
Recon Capabilities
- Web Crawler
ttula/integrations/crawler/adapter.py - Tookie OSINT
ttula/integrations/tookie/adapter.py - Uro URL Filter
ttula/integrations/uro/adapter.py - Arsenal Cheats
ttula/integrations/arsenal/adapter.py - Legba Auth Builder
ttula/integrations/legba/adapter.py - Tailscale Mesh
ttula/integrations/tailscale/adapter.py
Execution Runtime
- Execution Manager
ttula/execution/manager.py - Subprocess Runner
ttula/execution/process.py - Persistent PTY
ttula/execution/pty.py
Other components
- Operator
Connections 27
- Operator → CLI Commands: runs commands
README.md - Operator → Textual Dashboard: uses dashboard
README.md - Operator → Browser Console: uses console
README.md - CLI Commands → TTULA Engine: dispatches workflows
ttula/cli/main.py - Textual Dashboard → TTULA Engine: invokes workflows
ttula/ui/tui/app.py - Browser Console → TTULA Engine: invokes workflows
ttula/ui/streamlit/app.py - Browser Console → Home View: renders home
ttula/ui/streamlit/app.py - Tool Header → Category Badges: renders badges
ttula/ui/components/header.py - Tool Header → Tool Metadata: reads metadata
ttula/ui/components/header.py - Category Badges → Tool Metadata: reads categories
ttula/ui/components/badges.py - Home View → Category Badges: renders badges
ttula/ui/components/home.py - TTULA Engine → Shared Data Models: uses models
ttula/core/engine.py - TTULA Engine → Operation Mapping: uses mappings
ttula/core/engine.py - TTULA Engine → Web Crawler: dispatches crawl
ttula/core/engine.py - TTULA Engine → Tookie OSINT: dispatches discovery
ttula/core/engine.py - TTULA Engine → Uro URL Filter: dispatches filtering
ttula/core/engine.py - TTULA Engine → Arsenal Cheats: dispatches search
ttula/core/engine.py - TTULA Engine → Legba Auth Builder: dispatches auth build
ttula/core/engine.py - TTULA Engine → Tailscale Mesh: requests mesh status
ttula/core/engine.py - TTULA Engine → Execution Manager: runs commands
ttula/core/engine.py - TTULA Engine → Uro URL Filter: normalizes crawl results
ttula/core/engine.py - TTULA Engine → Uro URL Filter: normalizes OSINT results
ttula/core/engine.py - Execution Manager → Persistent PTY: starts sessions
ttula/execution/manager.py - Execution Manager → Subprocess Runner: runs one-shot commands
README.md - Tailscale Mesh → Subprocess Runner: runs CLI calls
ttula/integrations/tailscale/adapter.py - Tookie OSINT → Subprocess Runner: runs discovery tool
ttula/integrations/tookie/adapter.py - Uro URL Filter → Subprocess Runner: runs filter tool
ttula/integrations/uro/adapter.py