KillerTools

A modern, cross-platform Swiss-army toolkit for developers and makers with plugin architecture, multiple interfaces (CLI/TUI/GUI), and professional tooling.

✨ Features

• Multiple Interfaces: CLI, TUI, and GUI applications
• Plugin Architecture: Extensible with custom plugins
• Cross-Platform: Works on Windows, macOS, and Linux
• Theme Support: System theme detection with manual switching
• Rich Output: Beautiful terminal output with Rich
• Modern UI: PyQt6 GUI with native look and feel
• Developer Tools: JSON/YAML formatters, regex tester, file operations, cryptography, and more

🧭 Table of Contents

• Quick Start
• Installation
• Usage
• Configuration
• Examples
• Architecture
• Roadmap
• Contributing
• License

🚀 Quick Start

# 1) Install
pipx install killertools
# or
pip install killertools

# 2) Run
killertools --help
killertools list-plugins
killertools tui  # Launch TUI
killertools gui  # Launch GUI

💿 Installation

See docs/installation.md for platform-specific steps.

Using pipx (Recommended)

pipx install killertools

Using Poetry

git clone https://github.com/VoxHash/KillerTools.git
cd KillerTools
poetry install
poetry run killertools --help

Using pip

pip install killertools

🛠 Usage

Basic usage here. Advanced usage in docs/usage.md and docs/cli.md.

# List available plugins
killertools list-plugins

# Run a plugin
killertools files --help
killertools crypto --help
killertools devtools --help

# Launch interfaces
killertools tui   # Terminal UI
killertools gui   # Graphical UI

⚙️ Configuration

Configuration is stored in ~/.killertools/config.json. See docs/configuration.md for full reference.

Variable	Description	Default
theme.mode	Theme mode (system/light/dark)	system
theme.accent_color	Accent color in hex	#7C3AED
ui.window_width	Default window width	1200
ui.window_height	Default window height	800
logging.level	Log level	INFO

📚 Examples

• Start here: docs/examples/example-01.md
• More: docs/examples/

🧩 Architecture

KillerTools uses a plugin-based architecture with dynamic loading. See docs/architecture.md for details.

Key Components:

• Plugin Registry: Auto-discovers and registers plugins
• Core System: Settings, theming, logging
• Interfaces: CLI (Typer), TUI (Textual), GUI (PyQt6)

🔌 Plugins

Built-in Plugins

• Files Plugin: File hashing, duplicate detection, bulk operations
• Crypto Plugin: Hash functions, HMAC, JWT, UUID/ULID generation, Base64
• DevTools Plugin: JSON/YAML/TOML formatters, regex testing, .env parsing
• Image Plugin: AI image generation with OpenAI DALL-E

Coming Soon

• Media Plugin: Audio/video conversion, thumbnails, metadata
• Network Plugin: Ping, DNS lookup, HTTP probing, speed testing
• AI Plugin: Text summarization, translation, code generation

🗺 Roadmap

Planned milestones live in ROADMAP.md. For changes, see CHANGELOG.md.

🤝 Contributing

We welcome PRs! Please read CONTRIBUTING.md and follow the PR template.

🔒 Security

Please report vulnerabilities via SECURITY.md.

📞 Support

• Documentation: docs/ and full docs
• Issues: GitHub Issues
• Contact: See SUPPORT.md

📄 License

This project is licensed under the terms in LICENSE.

---

Made with ❤️ by VoxHash

⭐ Star this repo • 🐛 Report a bug • 💡 Request a feature