Skip to main content

What is swelist?

swelist is a command-line tool designed for job seekers to efficiently track and discover technology internship and new-graduate positions. It pulls real-time data from the widely-used Summer2025-Internships and New-Grad-Positions repositories maintained by SimplifyJobs. Instead of manually checking GitHub repositories or multiple job boards, swelist brings the latest opportunities directly to your terminal with powerful filtering capabilities.

Get Started

Installation

Install swelist in seconds with pip

Quick Start

Get your first job listings in under a minute

Commands

Explore all available commands and options

Key Features

Real-Time Data

Access live job postings from curated GitHub repositories maintained by SimplifyJobs

Time-Based Filtering

Filter positions by last day, week, or month to find the newest opportunities

Location Filtering

Search by city, state code, or country to find positions in your preferred locations

Dual Role Support

Track both internship and new-grad positions from a single tool

Simple CLI Interface

Easy-to-use command-line interface with intuitive flags and options

No Authentication

Completely open and free - no API keys or credentials required

Real-World Use Case

Imagine you’re a computer science student in Boston looking for summer 2025 internships. Instead of:
  1. Manually checking GitHub repositories daily
  2. Scrolling through hundreds of postings to find new ones
  3. Filtering by location yourself
  4. Keeping track of what you’ve already seen
You can simply run:
swelist --role internship --timeframe lastday --location Boston
This instantly shows you all internship positions in Boston that were posted in the last 24 hours, complete with company name, job title, and direct application links.
swelist is optimized for automation pipelines, periodic polling agents, and human-in-the-loop job search workflows. It’s perfect for daily checks or integration into job tracking systems.

Why swelist?

  • Stateless & Safe: No side effects, no persistent storage, safe for repeated execution
  • Always Up-to-Date: Fetches live data at runtime directly from source repositories
  • Developer-Friendly: Built with Python, distributed via PyPI, open source under MIT license
  • Automation-Ready: Designed for cron jobs, CI pipelines, and autonomous agents

What’s Next?

1

Install swelist

Head to the installation guide to get swelist set up on your system
2

Try the Quick Start

Follow the quick start guide to get your first job listings
3

Explore Commands

Learn about all available options in the commands reference