How mohamed2007sarhan/shad0wsploit2 works
Shad0wSploit is a CLI ReAct agent: a user starts or resumes a task, the orchestrator gathers task context, asks an LLM for the next action, runs a discovered tool, and uses its output to continue or finish. Persistent task state and cross-task deductions support recovery and learning. The tool tree also exposes system, network, web, and repository operations. The graph follows README capabilities and sampled entry-point and memory code; unsampled tool wiring and individual tool behavior are represented only where the tree or README supports them.
Main entry points: main_agent.py Tool execution · memory_manager.py Memory manager · run_shell.py Shell tools · process_manager.py Process control
Components 18
Agent runtime
- Task CLI
main_agent.py - ReAct orchestrator
main_agent.py - Tool discovery
tools - Tool execution
main_agent.py
Task memory
- Memory manager
memory/memory_manager.py - Task database
memory/memory_manager.py - Task workspace
memory/memory_manager.py
Tool arsenal
- Shell tools
tools/run_shell.py - File operations
tools/file_manager.py - Process control
tools/process_manager.py - Network tools
tools/port_scanner.py - Web search tools
tools/web_search.py - Git operations
tools/git_manager.py
External systems
- Language model
- Local host
- Web services
- Git remote
Other components
- User
Connections 20
- User → Task CLI: starts or resumes
- Task CLI → ReAct orchestrator: enters task loop
- ReAct orchestrator → Memory manager: loads and saves state
- Memory manager → Task database: reads and writes tasks
- Memory manager → Task workspace: reads and writes workspace
- ReAct orchestrator → Language model: requests next action
- Language model → ReAct orchestrator: returns response
- ReAct orchestrator → Tool discovery: finds tool signatures
- ReAct orchestrator → Tool execution: dispatches action
- Tool execution → Shell tools: runs command
- Tool execution → File operations: runs file action
- Tool execution → Process control: runs process action
- Tool execution → Network tools: runs network action
- Tool execution → Web search tools: runs search action
- Tool execution → Git operations: runs git action
- Shell tools → Local host: executes on
- Process control → Local host: inspects or controls
- Network tools → Web services: queries targets
- Web search tools → Web services: searches
- Git operations → Git remote: pushes or pulls