
WITCHCRAFT is a cyberdeck toolkit built for runners who dive deep into the mesh. It’s your all-in-one rig for data-ghosting, ICE-breaking, and corp-system infiltration. Whether you’re running forensic traces, scraping OSINT feeds, or slicing through firewalls, WITCHCRAFT’s got your back.


Your OPSEC companion. Run witchcraft help or witchcraft manual (for the complete manual)
WitchcraftFEX Are much more than a simple hacking script, is a cyberdeck toolkit built for runners who dive deep into the net. A shell and automation's and automation's engine for pentesting, osint, forensics, fingerprinting,web-hacking, malware building, reverse shells, RCE agents, generation of reports (RBR), and playbooks (RBP) based on rules. All based in a modular system. It is fully compatible with GNU/Linux, BSD, Android (with Termux) and Windows (WSL)


WitchcraftFEX or just WFEX is a modular system with build and hacking tools for cypherpunks. The objective is to centralize all my work (that is correlated to cyber security) and expose it in a standardized way to the user. I have several repos for that, but this is the ONLY one that matters.
This repo contains the tools it self but also all build scripts and configurations files for setup a development system for cyphers, if you want to build something and chill, this repo is for you.
What about the contents? Well exists a monorepo.md you should read it to understand the structure of the project. But in a nutshell:
manifest is for documents, like manifest from punks and cypherswitchcraft is the main toolkit for offensive and defensive ops, it's the magnos opus of the project, everything relevant to ops and security is here (or should be)xcript is a independent programming lang in rust (i know, i know) that i created tobloodmoon-os is the opsec OS, lightweight and "customizable", it's not a full capable OS, the objective is to run on cyberdecks and help me (you) to understand OS and Linux in deeph.This repo included hand made and IA assited code, somethings like the rocket_db is almost 100% IA created (with some tweaks). I don't mind code IA code that I can explain.
2026, cosmic-zip
WitchcraftFEX is an offensive security toolkit that aggregates tools, serializes functions, and provides a standardized interaction interface for various tasks including Wi-Fi hacking, web scanning, vulnerability scanning, OSINT, forensics, backup management, SQL injection, backdoor and ransomware management, custom malware building, reverse shells, RCE agents, generation of reports (RBR), and playbooks (RBP) based on rules.
It also has a WebUI that provides access to all CLI features and includes custom extensions. The WebUI is automatically generated, so all modifications made by the user will be available after executing the build.web sub-command.
The system works through a "genesis" file, which registers all commands, aliases, binds, and functions, along with their documentation and super-strings. Each super-string contains information about predefined options for external software or internal functions. With this design, and the fact that documentation and manuals are automatically generated, we have a complete, extensible, and robust system ready for operational use.
WitchcraftFEX features an automated playbook generation system based on vulnerability and attack databases from OWASP and AI support. It supports English and Brazilian Portuguese versions. This system is also used to generate bug bounty reports.
From the genesis file, a parser combined with a template engine (built from scratch) generates Web, CLI, and API interfaces. The most commonly used are CLI and Web. The API interface is experimental and may not function correctly.
Important: This project has a custom web server implemented from scratch using GO. This server allows code execution and remote command execution, so it must not be exposed to any network. Always run it in localhost or inside a NATed virtual machine.
The user (you) interacts only with the interfaces, which provide a standardized way to engage with all submodules, extensions, plugins, and native functions.
WitchcraftFEX does not rely on third-party libraries. It uses only code developed directly in Python, making it highly portable, durable, and easy to install. Wherever a GNU/coreutils or coreutils-compatible system exists, WitchcraftFEX will run.
NT_DATAROOT - Sets the full path location for the spellbook directory (e.g., /opt/witchcraft/spellbook)For convenience, we provide pre-compiled versions built with Nuitka. If you don't trust pre-compiled binaries, please compile from source instead.
Note! this project already contain compiled versions of:
WitchcraftFEX comes in two variants:
| Version | Size | Description |
|---|---|---|
witchcraft_full.tar.gz | 200 MB | Lightweight version without LLM models |
witchcraft_devel.tar.gz | 5.8 GB | Development version including Deepseek llama 8b model |
Recommendation: Use the full version for complete functionality.
In main.py, you can add a script to run every time Witchcraft runs. It allows for more advanced configuration. Custom scripts will run every time, before every command.
net_shell_router(FN_REGISTRY, "spellbook/pkg/common/hello.sh")
main.py [submodule] --arg1 value --arg2 option --arg3 123
Whenever executing any function in WitchcraftFEX, you always start by defining which submodule to use, followed by arguments written with --. The argument names are not standardized anymore, but they meaning can be found in the rocketdb.json
About the submodule cosmic: Cosmic is my nickname, and I used it to address small and self-contained submodules that would otherwise create unnecessary overhead.
Example:
chmod +x main.py
./main.py version
Adds ANSI terminal colors using UNIX escape codes. Suitable for interactive terminals. Not safe for log files or automation.
Example:
./main.py version
Outputs plain UTF-8 text, no colors or formatting. Ideal for scripts, logs, and automation.
Example:
./main.py version --output_mode_none
Generates HTML-formatted output using inline <span> and style. Used for dashboards, reports, and web previews.
Example:
./main.py version --output_mode_html