https://github.com/chenyuan99/swelist
A CLI tool for job seekers (unofficial cli implementation of swelist.com)
https://github.com/chenyuan99/swelist
offerplus simplify swelist
Last synced: about 1 month ago
JSON representation
A CLI tool for job seekers (unofficial cli implementation of swelist.com)
- Host: GitHub
- URL: https://github.com/chenyuan99/swelist
- Owner: chenyuan99
- License: mit
- Created: 2024-04-13T22:03:19.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-02-01T04:03:12.000Z (about 2 months ago)
- Last Synced: 2026-02-01T15:21:06.488Z (about 2 months ago)
- Topics: offerplus, simplify, swelist
- Language: Python
- Homepage: https://swelist.com/
- Size: 22.5 KB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# swelist
[](https://github.com/chenyuan99/swelist/actions/workflows/ci.yml)
[](https://codecov.io/gh/chenyuan99/swelist)
[](https://opensource.org/licenses/MIT)
[](https://badge.fury.io/py/swelist)
[](https://pypi.org/project/swelist/)
A CLI tool for job seekers to track tech internships and new-grad positions. Data is sourced from the [Summer2025-Internships](https://github.com/SimplifyJobs/Summer2025-Internships) and [New-Grad-Positions](https://github.com/SimplifyJobs/New-Grad-Positions) repositories.
## Features
- Track both internships and new-grad positions
- Filter job postings by time (last day, week, or month)
- Filter job postings by locations
- View company name, job title, location, and application link
- Real-time data from GitHub repositories
- Easy-to-use command-line interface
## Installation
```bash
pip install swelist
```
## Usage
Basic usage:
```bash
# Show internship positions from last 24 hours (default)
swelist
# Show new-grad positions from last 24 hours
swelist --role newgrad
# Show internship positions from last week
swelist --role internship --timeframe lastweek
# Show internship positions for Toronto
swelist --role internship --location Toronto
# Show new-grad positions for last month for Boston and New York
swelist --role newgrad --timeframe lastmonth --location "Boston, New York"
```
### Options
- `--role`: Choose between `internship` (default) or `newgrad` positions
- `--timeframe`: Filter postings by time period: `lastday` (default), `lastweek`, or `lastmonth`
- `--location`: Filter locations by giving single location: `Canada` or multiple locations `"CA, Boston, Toronto, NY"`
## Example Output
```
Welcome to swelist.com
Last updated: Sun Feb 23 13:03:45 2025
Found 1227 tech internships from 2025Summer-Internships
Found 103 new-grad tech jobs from New-Grad-Positions
Sign-up below to receive updates when new internships/jobs are added
Found 15 postings in the last day:
Company: Example Tech
Title: Software Engineering Intern
Location: New York, NY
Link: https://example.com/apply
...
```
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
MIT License