Posthorn

Find a damn job like a boss!

Get Started View on GitHub

What is it?

Posthorn is an asyncronous background service designed to scan job boards, filter for specific keyword campaigns, and push early-warning alerts to Discord (more options on the way). Stop wasting time scrolling job postings only to be the 300th applicant... get alerted, be first, get that damn job! Built ontop of a lightweight local DuckDB state machine, Posthorn guarantees that a matched job is alerted on exactly once, even across overlapping sweeps or network failures.

Posthorn provides a Terminal User Interface (TUI) to manage the daemon and configure keyword campaigns on the fly.

How to install this glorious app?

Run the setup command inside your system's terminal for your computer's OS (MacOS, Windows, Linux). Copy and paste the command, then press Enter.

macOS / Linux
Open Terminal.app
Windows
Open PowerShell (search in Start menu)

1. Install Posthorn Daemon & TUI Manager

macOS & Linux:

curl -LsSf https://duckjobs.dev/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://duckjobs.dev/install.ps1 | iex"

2. First-Time Setup

Launch the app directly from your terminal:

posthorn

On first launch, Posthorn opens a secure setup wizard in your terminal. Enter your Discord Webhook URL and your initial target job title. Once saved, the daemon immediately starts sweeping job boards and routing matches to your notification channel.

If you receive an error that "Posthorn is not found", or something like, try restarting your Terminal/Powershell app and rerun step 2.


Setting up Discord Alerts

Posthorn uses Webhooks to instantly push job matches directly to your phone or desktop. Here is how to configure a private Discord server in under two minutes.

1. Get Discord

If you don't already have it, download and install Discord, and create a free account.

2. Create a Private Server

Click the green + icon on the far left sidebar to Add a Server. Select Create My Own, then For me and my friends. Name it something like "Job Alerts" and click Create.

3. Create a Dedicated Channel

Click the + next to Text Channels to create a new channel named #posthorn.
Optimal Setting: Right-click the new channel, select Notification Settings, and change it to All Messages so your phone actually rings when a job drops.

4. Generate the Webhook URL

Right-click your #posthorn channel and select Edit Channel. Navigate to Integrations > Webhooks > New Webhook. Name the bot "Posthorn", click Copy Webhook URL, and hit Save.


Operator's Manual

Once the dashboard is running, you can manage the daemon using the following hotkeys:

Manage Campaigns ( c )
Pause the daemon and open the Campaign Manager. Add or remove job targets on the fly. When you exit, the daemon hot-swaps your new configuration without missing a beat.
Force Sweep ( s )
Bypass the 15-minute resting interval and force the daemon to immediately sweep all connected job boards.

Maintenance

If you ever want to wipe your job discovery history and start fresh without losing your configuration, stop the app (q) and run the developer reset command:

posthorn --dev-reset