How angelplusultra/job-shell works
Main Components
a. Core Components:
• CLI Interface Module
• Discord Integration Module
• Scraper Engine
• Data Management System
• AI Integration (Gemini)
• Job Report Generator
b. External Services:
• Company Job Boards
• Discord Webhook
• Google Chrome (Browser Automation)
• Gemini AI API
┌─ User Interface Layer ─┐
• CLI Mode │
• Discord Bot Mode │
• ┬────────────┘
• ↓
┌─ Core Service Layer ──┐
• Scraper Engine │
• Job Management │
• Report Generator │
• AI Integration │
• ┬────────────┘
• ↓
┌─ External Services ───┐
• Company Job Boards │
• Discord Webhook │
• Chrome Browser │
• Gemini AI API │
• ┘
Key Relationships to Highlight
a. Data Flow:
• User input → CLI/Discord interface
• Scraper Engine → Company job boards
• Job data → Report Generator
• Discord notifications → Discord Webhook
b. Dependencies:
• Scraper Engine ← Chrome Browser
• AI Integration ← Gemini API
• Job Management ← Data Storage
Component Details
a. Scraper Engine:
• Individual company scrapers (src/scrapers/*)
• Modular architecture
• Scheduling mechanism for Discord mode
b. CLI Interface:
• Interactive menu system
• Connection management
• Job bookmarking
• Message drafting
c. Discord Integration:
• Webhook communication
• Scheduled job updates
• Notification formatting
Implementation Notes
• Module boundaries (based on src/ structure)
• Async operations
• Error handling patterns
• Configuration management
Technical Stack Indicators
• Rust
• Chrome WebDriver
• Discord API
• Gemini AI
• Company APIs/websites
This system design should emphasize JobShell's unique architecture as a dual-mode job scraping tool, highlighting both its interactive CLI capabilities and automated Discord integration, while showing how various components work together to provide a seamless job hunting experience.