@bbhunter/cli

BBHunter CLI - Project management & security scanning

🚀 Installation

npm install -g @bbhunter/cli

📚 Features

• Project Management: Initialize and sync project roadmaps
• Security Scanning: Run ESLint and upload results automatically
• Real-time Sync: Watch for changes and auto-sync

🎯 Commands

Project Commands

# Initialize project with template
bbhunter init

# Configure webhook
bbhunter config --url <webhook-url> --secret <secret>

# Sync roadmap to platform
bbhunter sync

# Watch for changes
bbhunter watch

# Complete setup
bbhunter setup

Scanner Commands (NEW in v4.0.0)

# Configure scanner settings
bbhunter scan:config --workspace-id <id> --channel-id <id> --api-key <key>

# Run ESLint scanner
bbhunter scan --scanner eslint

# List available scanners
bbhunter scanners

📝 Configuration

The CLI uses .bbhunter.json for configuration:

{
  "project": {
    "webhookUrl": "https://your-instance.supabase.co/functions/v1/project-webhook",
    "webhookSecret": "your-secret"
  },
  "scanners": {
    "apiUrl": "https://your-instance.supabase.co",
    "apiKey": "your-api-key",
    "workspaceId": "workspace-uuid",
    "channelId": "channel-uuid"
  }
}

🔧 Quick Start

Project Management

# 1. Install CLI
npm install -g @bbhunter/cli

# 2. Initialize project
bbhunter init

# 3. Configure webhook
bbhunter config --url <webhook-url> --secret <secret>

# 4. Sync to platform
bbhunter sync

Security Scanning

# 1. Configure scanner
bbhunter scan:config \
  --workspace-id <workspace-id> \
  --channel-id <channel-id> \
  --api-key <api-key>

# 2. Run scan
bbhunter scan --scanner eslint

# 3. View results in BBHunter Issues Tab

📦 Available Scanners

• ✅ ESLint - JavaScript/TypeScript linter
• ⏳ Trivy - Container & IaC scanner (coming soon)
• ⏳ Gitleaks - Secret scanner (coming soon)
• ⏳ Checkov - IaC security (coming soon)

🔐 Requirements

• Node.js 18+
• ESLint installed globally (for scanning)

📖 Documentation

For detailed documentation, visit BBHunter Documentation

🐛 Issues

Report issues at GitHub Issues

📄 License

MIT

🎉 What's New in v4.0.0

• 🆕 Security scanner integration
• 🆕 ESLint adapter with auto-upload
• 🆕 Separate scanner configuration
• ✅ All project features preserved
• ✅ Backward compatible