https://github.com/operationalfallacy/unleaded
Car listings with a cli
https://github.com/operationalfallacy/unleaded
Last synced: 27 days ago
JSON representation
Car listings with a cli
- Host: GitHub
- URL: https://github.com/operationalfallacy/unleaded
- Owner: OperationalFallacy
- License: apache-2.0
- Created: 2025-12-23T22:07:08.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-12-25T17:01:41.000Z (6 months ago)
- Last Synced: 2025-12-27T04:05:25.284Z (6 months ago)
- Language: TypeScript
- Size: 1.92 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Unleaded cli
This is an interactive cli to search car listings.
```bash
AUTO_DEV_API_KEY=xxx npx tsx main.tsx -z [-b ] [-m ] [-d ] [-e ]
```
Options:
- `-z, --zip` - Zip code for search location (required)
- `-b, --brand` - Brand/make name (e.g., Hyundai, Tesla)
- `-m, --model` - Model name (e.g., Ioniq 5, Model 3)
- `-d, --distance` - Search radius in miles (default: 50)
- `-e, --engine` - Engine type (default: electric)
Use `--wizard` for interactive mode or `--help` for full usage info.
# Requirements
Using `api.auto.dev` API, register an account and get API key to use with this cli.
auto.dev provides enough free searches per month to find a good deal.
To start, run `yarn install`
# How to use
Unleaded cli provides market snapshot.
It loads vehicle listings for a car maker, zip and desired distance. Use fast cli to sort and filter listing to find cars in the desired price range and location.
If something looks good, click on carfax link to check the history. There is also a link to Google search for Vin number. Google usually points to the dealership listing on first result or second result.
Call sales and negotiate :)
# Build
To make it start faster:
`npx projen build`
`AUTO_DEV_API_KEY=hey node lib/src/main.js`
# Features
Caches all content in ./cache dir to re-use data.
Interactive, instant sorting by various parameters (price, cpo flag etc). Basic search to find dealer names.
Filter by model name, and CPO (manufacturer certified pre-owned) state.
Clicable links to the car image, carfax report and vin search through Google
Normalizes model names
# Tech stack
Created with [Effect](http://effect.website) for declarative coding, [ink](https://github.com/vadimdemedes/ink) for terminal UI, [Effect Atom](https://github.com/tim-smart/effect-atom/blob/main/README.md) for the state, [Projen](https://github.com/projen/projen) for the project and deps management, and the usual AI involment.
# Contributions
Hack away on it with your fav agent :)