Adding Tools to Tool-X Framework

June 29, 2026 · View on GitHub

Tool-X uses a JSON based tool database.

All tools are stored inside:

core/data.json

Tool Format

Each tool entry follows this structure:

"ToolName": {
    "name": "ToolName",
    "desc": "Short description of the tool",
    "category": ["web_hacking", "osint"],
    "url": "[https://github.com/example/tool.git](https://github.com/example/tool.git)",
    "package_manager": "git",
    "dependency": ["python", "bash", "git"],
    "os": ["linux", "termux", "macos"]
}

Example Tool Entry

"seeker": {
        "name": "seeker",
        "desc": "Accurately Locate Smartphones using Social Engineering.",
        "url": "https://github.com/thewhiteh4t/seeker",
        "category": [
            "Social Engineering & Phishing"
        ],
        "dependency": [
            "bash"
        ],
        "package_manager": "git"
    },

Fields Explanation

Field	Description
name	Tool name
desc	Short description
repo	GitHub repository
reqs	Required dependencies
help_cmd	Command to run tool

Steps to Add a Tool

Open:core/data.json
Select a category
Add a new tool entry
Test installation
Submit Pull Request

Testing

Run Tool-X

toolx

Navigate to the category and install the tool.

Guidelines

• Ensure GitHub repo works
• Provide correct dependencies
• Keep descriptions short
• Test installation before submitting