timemap

# Timemap - Tel Aviv & Haifa Venue History

Search historical entertainment, nightlife, and culture venues in Tel Aviv-Yafo and Haifa from [timemap.co.il](https://timemap.co.il) - a community-curated database mapping bars, cafes, clubs, cinemas, food venues, and performance spaces throughout the cities' history.

> Data from [timemap.co.il](https://timemap.co.il), a non-profit project by [Reut Miryam Cohen](https://x.com/reutc) and Amir Ozer - "a loving tribute to the places and people that made the cities we grew up in." Venues include opening/closing dates, locations, tags, user memories, and photos. This skill is an unofficial CLI wrapper.

## Quick Start

```bash
# Search for a venue (Hebrew or English)
python3 {baseDir}/scripts/timemap.py search "רוטשילד"
python3 {baseDir}/scripts/timemap.py search "Barby"

# See what was active in a specific year
python3 {baseDir}/scripts/timemap.py timeline 2010

# Get database statistics
python3 {baseDir}/scripts/timemap.py stats
```

## Commands

| Command | Description |
|---------|-------------|
| `search <query>` | Search venues by name or address (Hebrew or English) |
| `filter` | Filter by --city, --tags, --year, --active-in, --opened, --closed |
| `venue <id>` | Get full details for a specific venue (by ID or name) |
| `timeline <year>` | Show all venues that were active in a given year |
| `nearby <lat> <lng>` | Find venues near coordinates (--radius in km, default 0.5) |
| `tags [tag]` | List all tags, or show venues with a specific tag |
| `cities` | List cities with venue counts |
| `stats` | Database statistics (venues by city, tag, decade, status) |
| `memories <id>` | Show user memories for a specific venue |
| `random` | Pick a random venue (prefers ones with memories/photos) |

## Search Examples

```bash
# Search by name (Hebrew or English)
python3 {baseDir}/scripts/timemap.py search "טדי"
python3 {baseDir}/scripts/timemap.py search "Barby"

# Search by address
python3 {baseDir}/scripts/timemap.py search "רו...

# timemap - search Tel Aviv & Haifa's entertainment venue history

![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-purple)

> **[Agent Skills](https://agentskills.io) format** - works with OpenClaw, Claude, Cursor, Codex, and other compatible clients

Search historical bars, cafes, clubs, cinemas, and food venues in Tel Aviv-Yafo and Haifa. Data from [timemap.co.il](https://timemap.co.il), a non-profit community project by [Reut Miryam Cohen](https://x.com/reutc) and Amir Ozer.

## Why this exists

[timemap.co.il](https://timemap.co.il) is a community project preserving the history of entertainment and culture venues in Tel Aviv-Yafo and Haifa - bars, clubs, cafes, cinemas, restaurants, performance spaces. As the creators put it: "much of this information was not easily available on the internet until now, a fact we find incomprehensible." This skill makes that database searchable from the terminal or through an AI assistant, so you can ask what was at a specific address, browse what the nightlife scene looked like in a given year, or explore the cultural history of a neighborhood.

## Installation

```bash
npx skills add alexpolonsky/agent-skill-timemap
```

<details>
<summary>Manual install</summary>

**OpenClaw / Claude / Cursor**

Clone or copy the `timemap` folder into your skills directory:
- OpenClaw: `~/clawd/skills/timemap/`
- Claude: `~/.claude/skills/timemap/`
- Cursor: `.cursor/skills/timemap/`

**Standalone CLI**

```bash
python3 scripts/timemap.py stats
```

**CLI shortcut** (optional)

```bash
ln -sf /path/to/timemap/timemap /usr/local/bin/timemap
timemap stats
```

Requirements: Python 3.9+ (stdlib only, no pip install needed)
</details>

## Try it

Ask your AI assistant:
> "What venues were active on Rothschild in 2008?"

Or use the CLI directly:
```bash
timemap search "רוטשילד"
timemap timeline 2005
timemap stats
```

## What you can ask

- "What bars were o...