bugpilot-cli 1.2.2

AI-powered penetration testing and bug hunting CLI tool

BugPilot CLI

AI-Powered Autonomous Penetration Testing & Security Research Assistant

Developer: LAKSHMIKANTHAN K (letchupkt)
Portfolio: letchupkt.vgrow.tech

---

🚀 Quick Start

# Install
pip install bugpilot-cli

# Run
bugpilot

# Configure
/configure

---

✨ Features

Core Capabilities

• 🤖 AI-Powered Analysis - 5 AI providers (Gemini, OpenAI, Groq, Ollama, Anthropic)
• 🛠️ 50+ Pentesting Tools - Auto-install & management
• 📁 File System Access - Read, analyze, and work with files
• 🎨 5 Modern Themes - Ocean, Sunset, Neon, Forest, Midnight
• 🔄 Auto-Updates - Stay current with PyPI
• ⚡ Intelligent Autocomplete - / commands, @ files, # folders

Advanced Features

• Dual Modes: Normal (guided) & Hacker (autonomous)
• Multi-API Keys: Store all provider keys, switch instantly
• Token Optimization: Agentic methodology reduces AI calls by 90%
• Cross-Platform: Windows, Linux, macOS, Termux

---

📦 Installation

Method 1: PyPI (Recommended)

pip install bugpilot-cli

Method 2: From Source

git clone https://github.com/letchupkt/bugpilot-cli.git
cd bugpilot-cli
pip install -e .

Requirements

• Python 3.8+
• Internet connection (for AI APIs)
• API keys for desired AI providers

---

🎯 Usage

Basic Usage

bugpilot

Commands

/help       - Show all commands
/configure  - Configure AI provider & settings
/tools      - View 50+ pentesting tools
/update     - Check for updates
/portfolio  - Visit developer portfolio
/mode       - Switch normal/hacker mode
/settings   - View current configuration
/clear      - Clear conversation context
/exit       - Exit BugPilot

Autocomplete

• Type / for command suggestions
• Type @ for file suggestions
• Type # for folder suggestions

---

⚙️ Configuration

First-Time Setup

bugpilot
/configure

Configure Multiple API Keys (One-Time)

Select AI provider: gemini
Gemini API Key: AIza...

Select AI provider: openai  
OpenAI API Key: sk-...

Select AI provider: groq
Groq API Key: gsk_...

Environment Variables (Alternative)

export GEMINI_API_KEY="your-key"
export OPENAI_API_KEY="your-key"
export GROQ_API_KEY="your-key"
export ANTHROPIC_API_KEY="your-key"

Configuration File

Located at: ~/.bugpilot/config.json

{
  "model": {
    "provider": "gemini",
    "model_name": "gemini-2.0-flash-exp",
    "api_keys": {
      "gemini": "AIza...",
      "openai": "sk-...",
      "groq": "gsk_...",
      "anthropic": "sk-ant..."
    }
  },
  "mode": "normal",
  "terminal_theme": "ocean",
  "auto_update_check": true
}

---

🛠️ Features Deep Dive

1. AI Provider Support

Supported Providers:

• Gemini (Google) - gemini-2.0-flash-exp, gemini-1.5-pro
• OpenAI - gpt-4o, gpt-4-turbo, gpt-3.5-turbo
• Groq - llama-3.3-70b-versatile, mixtral-8x7b
• Ollama (Local) - llama3.2, qwen2.5, mistral
• Anthropic - claude-3.5-sonnet, claude-3-opus

Easy Switching:

/mode
# Select provider: openai
# Uses saved API key automatically!

---

2. Pentesting Tools (50+)

Categories:

• Network Scanning (nmap, masscan)
• Web Scanning (nikto, wpscan, nuclei)
• Fuzzing (ffuf, gobuster)
• Reconnaissance (subfinder, amass, httpx)
• Exploitation (sqlmap)
• And many more...

Auto-Install in Hacker Mode:

# Switch to hacker mode
/mode hacker

# Use a tool - it auto-installs if missing!
[!] You: scan target.com with nmap
[>>] Tool 'nmap' not found. Installing...
[+] Successfully installed nmap
[>>] Running: nmap -sV target.com

View All Tools:

/tools

---

3. Intelligent Autocomplete

Command Autocomplete (/):

[+] You: /h
         /help      ← Press Tab
         /configure

File Autocomplete (@):

[+] You: analyze @con
              @config.py  ← Press Tab
              @config.json

Folder Autocomplete (#):

[+] You: scan #bug
           #bugpilot  ← Press Tab
           #build

---

4. File System Access

Read Files:

[+] You: read setup.py
[>>] Reading setup.py...
[AI] The setup.py file contains...

Analyze Projects:

[+] You: analyze the entire bugpilot folder
[>>] Scanning directory...
[AI] Found 11 Python modules, analyzing structure...

Search Files:

[+] You: find all files with "config" in the name
[>>] Searching...
[+] Found: config.py, config.json

---

5. Auto-Update

Automatic Check (on startup):

[!] Update available: v1.0.0 → v1.1.0
[*] Run /update to install

Manual Update:

/update

[>>] Checking for updates...
[!] Update Available: v1.1.0
Install now? [y/n]: y
[>>] Updating...
[+] Successfully updated!
[!] Please restart: bugpilot

Disable Auto-Check:

/configure
# Check for updates on startup? [y/n]: n

---

🎨 Themes

5 Built-in Themes:

/configure
# Select theme:
1. ocean    - Blue ocean waves
2. sunset   - Warm sunset colors
3. neon     - Vibrant neon lights
4. forest   - Natural forest greens
5. midnight - Dark midnight blue

---

💡 Use Cases

Security Research

[+] You: explain CVE-2024-12345
[AI] BugPilot: CVE-2024-12345 is a critical...

Vulnerability Scanning

[!] You: full reconnaissance on target.com
[>>] Executing autonomous workflow...
[*] Step 1/5: Port scanning with nmap
[*] Step 2/5: Subdomain enumeration
[*] Step 3/5: HTTP probing
[*] Step 4/5: Vulnerability scanning
[*] Step 5/5: Report generation
[+] Complete! 3 critical findings.

Code Analysis

[+] You: analyze this Python code for security issues
[+] You: @vulnerable.py
[AI] Analyzing... Found 2 SQL injection risks...

Exploit Development

[+] You: generate a POC for buffer overflow
[AI] Here's a proof-of-concept...

---

🔧 Advanced Usage

Hacker Mode (Autonomous)

/mode hacker

# Auto-executes commands
# Auto-installs tools
# Advanced capabilities
# Requires authorization!

Custom Workflows

[!] You: create a penetration testing workflow for web apps
[AI] I'll create a comprehensive workflow...

Token Optimization

Uses agentic methodology to reduce AI calls:

• Predefined pentesting workflows
• Built-in tool knowledge
• Automated decision-making
• 90%+ token savings

---

📊 Technical Details

Architecture

bugpilot-cli/
├── bugpilot/
│   ├── __init__.py       - Package initialization
│   ├── cli.py            - Main CLI interface
│   ├── agent.py          - AI agent logic
│   ├── models.py         - AI model integrations
│   ├── config.py         - Configuration management
│   ├── toolmanager.py    - Tool management
│   ├── filesystem.py     - File system access
│   ├── autocomplete.py   - Autocomplete engine
│   ├── terminal_ui.py    - UI & themes
│   ├── prompts.py        - System prompts
│   ├── updater.py        - Auto-update system
│   ├── mcp.py            - MCP protocol
│   └── utils.py          - Utilities
├── test.py               - Test suite (19 tests)
├── setup.py              - Package setup
└── requirements.txt      - Dependencies

Dependencies

google-generativeai  # Gemini
openai               # OpenAI/ChatGPT
anthropic            # Claude
groq                 # Groq
requests             # HTTP
rich                 # Terminal UI
pydantic             # Data validation
prompt_toolkit       # Autocomplete
packaging            # Version comparison

---

🧪 Testing

Run Tests

python test.py

Test Coverage

• ✅ Configuration management
• ✅ Multiple API keys
• ✅ Tool manager
• ✅ Autocomplete system
• ✅ AI model integration
• ✅ File system access
• ✅ Auto-updater
• ✅ UI themes (no emojis)
• ✅ 19 tests, 100% pass rate

---

🔒 Security & Ethics

Ethical Use Only

BugPilot CLI is designed for:

• ✅ Authorized penetration testing
• ✅ Security research
• ✅ Educational purposes
• ✅ Vulnerability assessment (with permission)

NOT for:

• ❌ Unauthorized access
• ❌ Illegal activities
• ❌ Malicious hacking
• ❌ Any unlawful purposes

Disclaimer

Users are responsible for ensuring they have proper authorization before testing any systems. Always follow responsible disclosure practices.

---

🤝 Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

---

📝 Changelog

v1.0.0 (2025-12-17)

• ✅ Initial release
• ✅ 5 AI provider support
• ✅ 50+ pentesting tools
• ✅ Intelligent autocomplete
• ✅ Multiple API key storage
• ✅ Auto-update system
• ✅ 5 modern themes
• ✅ File system access
• ✅ 100% ASCII UI
• ✅ Cross-platform support
• ✅ Comprehensive test suite

---

🐛 Troubleshooting

Issue: "API key required"

# Solution: Configure API key
/configure
# or set environment variable
export GEMINI_API_KEY="your-key"

Issue: "Tool not found"

# Solution: Use hacker mode for auto-install
/mode hacker
# or install manually

Issue: "Import error"

# Solution: Reinstall dependencies
pip install --upgrade bugpilot-cli

---

📚 Resources

• Documentation: This README
• PyPI: https://pypi.org/project/bugpilot-cli/
• Issues: https://github.com/letchupkt/bugpilot-cli/issues
• Developer: https://letchupkt.vgrow.tech

---

📄 License

MIT License - See LICENSE file for details

---

👤 Author

LAKSHMIKANTHAN K (letchupkt)

• Portfolio: letchupkt.vgrow.tech
• Email: [e-mail]

---

🌟 Support

If you find BugPilot CLI useful:

• ⭐ Star the repository
• 🐛 Report bugs
• 💡 Suggest features
• 🤝 Contribute code

---

🎯 Quick Reference

# Install
pip install bugpilot-cli

# Run
bugpilot

# Configure
/configure

# Commands
/help       # Show all commands
/tools      # View tools
/update     # Check updates
/mode       # Switch mode
/exit       # Quit

# Autocomplete
/           # Commands
@           # Files
#           # Folders

---

BugPilot CLI - The Ultimate AI-Powered Pentesting Assistant

🔴 Configure Once. Hack Forever. 🔴