jlm-coffee

# Jerusalem Coffee Finder

Search specialty coffee shops in Jerusalem - ratings, amenities, opening hours, reviews, and locations from [coffee.amsterdamski.com](https://coffee.amsterdamski.com), created and curated by [Shaul Amsterdamski](https://x.com/amsterdamski2) ([@amsterdamski2](https://x.com/amsterdamski2)).

> Data from the official public JSON export provided by the site maintainer. May not reflect current status. Provided "as is" without warranty of any kind.

## Quick Start

```bash
# List all coffee shops
python3 {baseDir}/scripts/jlm-coffee.py list

# Find a shop by name
python3 {baseDir}/scripts/jlm-coffee.py search "סיבריס"
```

## Commands

| Command | Description |
|---------|-------------|
| `list` | List all approved specialty coffee shops |
| `search <query>` | Search shops by name (Hebrew or English) |
| `get <id_or_name>` | Get full details for a specific shop |
| `filter <amenity>` | Filter shops by amenity (wifi, dogs, kosher, etc.) |
| `open-now` | Show shops currently open |
| `amenities` | List all available amenity filters |
| `surprise` | Pick a random coffee shop (prefers open ones) |

## Search and Filter Examples

```bash
# Search by name (Hebrew or English)
python3 {baseDir}/scripts/jlm-coffee.py search "רוסטרס"
python3 {baseDir}/scripts/jlm-coffee.py search "Cafe Pepa"

# Filter by amenity
python3 {baseDir}/scripts/jlm-coffee.py filter wifi
python3 {baseDir}/scripts/jlm-coffee.py filter dogs
python3 {baseDir}/scripts/jlm-coffee.py filter kosher
python3 {baseDir}/scripts/jlm-coffee.py filter laptop

# Shops open right now
python3 {baseDir}/scripts/jlm-coffee.py open-now

# Full details for a shop
python3 {baseDir}/scripts/jlm-coffee.py get "בארוק"
python3 {baseDir}/scripts/jlm-coffee.py get EljFiggwObssQpypWMf0
```

## Options Reference

| Option | Commands | Description |
|--------|----------|-------------|
| `--json` | all | Output in JSON format (agent-friendly) |
| `--no-color` | all | Disable colored output (auto-detected for no...