JobShell

JobShell offers software engineers a distraction-free, terminal-centric solution for managing their job search. Move beyond the noise of traditional platforms and gain control over your applications directly from your command line. Streamline your job hunt and focus on opportunities that matter to you.

Table of Contents

• Key Features
• Supported Companies
• Prerequisites
• Installation
• Usage
• Smart Criteria
• Suggested Workflow

Key Features

1. CLI Mode
2. Interactive Navigation: Run jobshell for a terminal-based menu. Scrape jobs from individual companies, view new postings, and manage your professional network from a single interface.
3. Network-Based Discovery: Scan for new roles exclusively at companies where you have existing connections or have "followed".

4. Bookmarks & Draft Messages: Bookmark interesting jobs for later review and draft personalized opening messages to your connections.

5. Discord Integration Mode

6. Automated Updates via Webhook: Use jobshell --discord to run a continuous background scrape for all supported companies. It will periodically post new job updates to a specified Discord channel.
7. Scheduled Execution: Configure the scraper to run at regular intervals (every 1–12 hours) to stay informed with the latest openings.

Supported Companies

See Full List of Companies

Want a company added to JobShell?

Submit a Company Request by opening a GitHub issue.

Prerequisites

Before running JobShell, ensure you have the following:

1. Detectable Chrome Binary:
   JobShell uses browser automation to scrape job postings. You must have a working Chrome installation that can be detected by the underlying scraper.
2. If you're on macOS, ensure you have Google Chrome installed in the standard location.
3. On Linux, install Google Chrome via your package manager (e.g., apt, yum) or download from the official site.

4. On Windows, ensure Chrome is installed in a standard location or is available in your PATH.

5. Desktop Environment (or Virtual Environment):
   Headless scraping may still require a display server. If running on a server, use Xvfb or similar tools to simulate a desktop environment.

Installation

🏠 Install via Homebrew (macOS)

brew tap angelplusultra/jobshell
brew install jobshell

📦 Install via Cargo (All Platforms)

cargo install jobshell

📥 Install from Release (macOS and Windows only for now)

1. Download a Binary from Releases:
   Head to the Releases page and download the latest binary that matches your operating system.

2. Place the Binary in Your $PATH:
   Move t