Skip to main content

​
Frequently Asked Questions

swelist sources data from two public GitHub repositories maintained by SimplifyJobs:The data is fetched in real-time directly from these repositories when you run the CLI tool.
swelist fetches data in real-time from the SimplifyJobs repositories every time you run the tool. The data is as current as what’s available in those repositories.The SimplifyJobs repositories are community-maintained and typically updated daily as new positions are posted or existing ones are filled.You can see the last update time displayed in the welcome message when you run swelist.
Location filtering is flexible and supports multiple formats:
  • Single location: --location Toronto or --location Canada
  • Multiple locations: --location "Boston, New York, Toronto"
  • State codes: 2-letter codes like --location "CA, NY" (matches locations ending with that state)
  • City names: Matches any location containing the city name
  • All locations: --location all (default)
The filter performs case-insensitive partial matching, so “boston” will match “Boston, MA”.
swelist supports three timeframe filters:
  • --timeframe lastday: Postings from the last 24 hours (default)
  • --timeframe lastweek: Postings from the last 7 days
  • --timeframe lastmonth: Postings from the last 30 days
Example usage:
swelist --role internship --timeframe lastweek
These filters help you focus on the most recent opportunities.
If you see “No postings found” messages, try these solutions:
  1. Expand your timeframe: Try --timeframe lastweek or --timeframe lastmonth instead of the default lastday
  2. Broaden your location filter: Remove or adjust the --location parameter to see more results
  3. Try the other role: Switch between --role internship and --role newgrad
  4. Check data sources: Visit the SimplifyJobs repositories directly to verify if new positions have been posted recently
Example:
# Instead of:
swelist --location "Seattle" --timeframe lastday

# Try:
swelist --location "Seattle" --timeframe lastmonth
The data accuracy depends on the SimplifyJobs community repositories:
  • Freshness: Data is fetched in real-time from GitHub, so you always get the latest available information
  • Accuracy: The SimplifyJobs community actively maintains these repositories, but some positions may be filled or closed
  • Verification: Always click through to the application link to verify the position is still open
The tool displays the total count of available positions when you run it, helping you gauge the current state of the job market.
Yes! You can combine role, timeframe, and location filters:
# New grad positions in Boston or New York from the last month
swelist --role newgrad --timeframe lastmonth --location "Boston, New York"

# Internships in California from the last week
swelist --role internship --timeframe lastweek --location CA
All filters work together to help you find the most relevant positions.
swelist tracks two types of positions:
  • Internship (--role internship): Summer internship positions, typically for students currently enrolled in university programs
  • New Grad (--role newgrad): Full-time positions for recent graduates or those graduating soon
The default role is internship. Specify --role newgrad to see new graduate opportunities instead.
We welcome bug reports and feature requests!
  1. Report an issue: Open an issue on GitHub
  2. Check existing issues: See if your issue has already been reported
  3. Contribute: Consider submitting a pull request if you can fix the issue yourself
Visit our Contributing guide for more information on how to contribute to the project.

​
Still Have Questions?

If your question isn’t answered here: