ghostshell

A Netcat-style remote command execution tool using raw Python sockets.

Features

• Raw socket client/server
• CLI and importable API
• Supports multiple requests per session

Installation

From PIP

pip install ghostshell

Manual Installation using setup.py

• Clone this git repo
• cd ghostshell
• Run

pip install .

CLI Usage

For Code/module CLI:

 python -m ghostshell.cli.main serve --host 0.0.0.0 --port 9999
 python -m ghostshell.cli.main connect --host 127.0.0.1 --port 9999

For Installed CLI package:

ghostshell serve --host 0.0.0.0 --port 9999
ghostshell connect --host 127.0.0.1 --port 9999

Python Usage

from ghostshell.core.server import RemoteServer
from ghostshell.core.client import RemoteClient

server = RemoteServer("0.0.0.0", 9999)
server.start()

client = RemoteClient("127.0.0.1", 9999)
client.connect()

print(client.send_command("whoami"))
client.close()

License

MIT

⚠️ Disclaimer

This tool is intended strictly for educational and authorized use only.

By installing or using this package, you agree that:

• You will only use it in environments where you have explicit permission.
• You understand that this tool can be used for remote command execution, and improper use may violate laws or system security.
• The author is not responsible for any damage, unauthorized access, or misuse of this software.

Use responsibly and at your own risk.