go-jobs

Live app: jobs.estifanos.cc

go-jobs is a self-hosted job aggregator for people who want a focused startup job search without relying on a SaaS job board.

It pulls postings from ATS platforms like Greenhouse, Lever, and Ashby, stores them locally, and gives you a fast web UI plus a CLI to search, filter, and track applications in one place.

What the app does

• Aggregates jobs from supported startup ATS platforms
• Enriches postings with structured metadata like role type, seniority, remote policy, location, and tech stack
• Lets users search and filter jobs in the browser or from the terminal
• Includes a lightweight application tracker for interested, applied, interviewing, offer, rejected, and withdrawn states
• Runs as a self-hosted Go app backed by PostgreSQL

Who it is for

• Job seekers who want better signal than broad job boards
• People who prefer owning their own tooling and data
• Users who want both a web interface and an agent-friendly CLI

Tech stack

• Go
• PostgreSQL
• Chi
• templ
• HTMX
• Tailwind CSS + DaisyUI
• sqlc
• golang-migrate

Project docs

• docs/MVP.md — product scope and milestones
• docs/ARCHITECTURE.md — system design and data model
• docs/interfaces.md — domain types and ports

CLI

Install the CLI via npm and use it against the live app or your own instance:

npm install -g @justestif/go-jobs
jobs search --query "backend go"
jobs login
jobs pipeline

The CLI targets http://127.0.0.1:3000 by default. To use the hosted app:

jobs --base-url https://jobs.estifanos.cc <command>

Self-hosting

docker pull ghcr.io/justestif/go-jobs:latest

Run with Docker Compose or plain Docker — see docs/self-hosting.md for env vars and setup.

Local development

mise install
docker-compose up -d
mise run setup
mise run dev

Open http://localhost:3000

Common commands

mise run dev
mise run build
go test ./...
go build ./...
mise run db-migrate
mise run db-rollback

Runtime behavior

• go-jobs (no CLI args) starts the web server and a background scheduler.
• Scheduler cadence is controlled by SCRAPE_INTERVAL (Go duration, default 6h).
• Enrichment batch size per scheduled run is controlled by ENRICH_LIMIT (default 1000).
• Jobs are retained in the database; browse views default to jobs posted in the last 90 days.