⚡ DJINN

The Ultimate AI-Powered CLI Tool

Transform natural language into precise shell commands with 60+ built-in commands and 900+ plugin templates.
TUI Dashboard • Universal Package Manager • Voice Control • AI Code Reviewer

djinn "find all files larger than 100MB and sort by size"

---

⚡ Key Features

• Natural Language Parsing: Uses LLMs (Ollama, OpenAI, LM Studio) to understand you.
• Smart Execution: djinn -x to run commands instantly.
• Interactive Mode: djinn -i for a chat-like experience.
• 180+ Built-in Commands: Git, Docker, Network, Files, Security, and more.
• Plugin Marketplace: Download 30+ additional plugins.
• Cross-Platform: Windows, macOS, Linux.

---

🔌 Plugins System

Built-in Plugins (Included)

DJINN comes with 100+ commands built-in, covering:

Category	Commands
Git	djinn git status, djinn git undo
Docker	djinn docker cleanup, djinn docker logs
Network	djinn ip, djinn ports, djinn ping
Files	djinn tree, djinn search, djinn qr
Security	djinn pass, djinn audit, djinn hash
System	djinn sysinfo, djinn monitor, djinn clean

🛒 Plugin Marketplace (Download More)

Want more features? Install additional plugins from the marketplace:

# Browse available plugins
djinn market list

# Install a plugin
djinn market install spotify
djinn market install notion-cli
djinn market install kubernetes

# View installed plugins
djinn plugins installed

# Remove a plugin
djinn plugins remove spotify

📦 30+ Marketplace Plugins Available

Category	Plugins
AI & ML	ollama-manager, openai-chat, huggingface
Cloud	vercel-deploy, firebase, netlify, aws-toolkit, cloudflare, supabase, stripe
DevOps	kubernetes, terraform, system-monitor
Databases	database-cli, redis-cli, elasticsearch
Development	api-tester, github-toolkit, webhook-tester, data-converter, data-faker
Productivity	notion-cli, slack-cli, todoist, linear, jira, pomodoro, screenshot
Security	password-manager (1Password/Bitwarden)
Media	spotify, youtube-dl

See all plugins: marketplace/README.md

---

📚 Documentation

Everything you need to know about using DJINN:

• Installation Guide: Install via Pip, Script, Homebrew, or Docker.
• Command Reference: Master the CLI, from aliases to configuration.
• Plugins & Subcommands: Learn about the plugin system.
• Marketplace: Browse and create plugins.

---

🚀 Quick Start

# Install DJINN
pip install djinn-cli

# Run setup wizard (first time)
djinn setup

# Use natural language
djinn "list all docker containers"

# Or use direct commands
djinn git status
djinn docker cleanup
djinn sysinfo

# Install more plugins
djinn market install spotify
djinn spotify now

---

🤝 Contributing

We love contributions! Please see CONTRIBUTING.md for details.

Creating Plugins

Want to create your own plugin?

# Generate plugin template
djinn plugins create my-awesome-plugin

See marketplace/README.md for plugin development guide.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.